Initial commit

2025-11-30 08:39:15 +08:00
commit b999e5074a
14 changed files with 2460 additions and 0 deletions
--- a/commands/download-issues.md
+++ b/commands/download-issues.md
@@ -0,0 +1,145 @@
+---
+description: Download CodeRabbit AI review comments for a Pull Request
+---
+
+## Download PR Reviews
+
+This command downloads CodeRabbit AI review comments from a GitHub Pull Request and organizes them by severity for systematic resolution.
+
+**This command works from any directory** - it will save reviews to the current working directory's `.reviews/` folder.
+
+## Usage
+
+```bash
+# With PR number
+/reviewer:download-issues --pr 123
+
+# Without PR number (auto-detects latest open PR)
+/reviewer:download-issues
+```
+
+## How Claude Code Executes This
+
+When you run `/reviewer:download-issues --pr 123` or `/reviewer:download-issues`, Claude Code will:
+
+1. Find the installed `pr-reviewer` skill location
+2. Execute the download script from the skill directory
+3. Save output to **your current working directory** (the repo you're working on)
+
+## Command
+
+```bash
+# Execute from skill location, save to current working directory
+CWD=$(pwd) node ~/.claude/plugins/marketplaces/claude-craftkit/plugins/reviewer/skills/pull-request-skill/run.js download <pr>
+
+# Or without PR number (auto-detect latest)
+CWD=$(pwd) node ~/.claude/plugins/marketplaces/claude-craftkit/plugins/reviewer/skills/pull-request-skill/run.js download
+```
+
+**Note:** The exact path may vary depending on where Claude Code installs plugins. Claude will handle finding the correct path automatically.
+
+## Prerequisites
+
+1. **GitHub Personal Access Token**
+
+   The skill needs a `.env` file in its installation directory with your GitHub token:
+
+   ```bash
+   # Location: ~/.claude/plugins/marketplaces/claude-craftkit/plugins/reviewer/skills/pull-request-skill/.env
+   GITHUB_TOKEN=ghp_your_personal_access_token_here
+   OUTPUT_DIR=./.reviews
+   LOG_LEVEL=info
+   PR_REVIEW_TZ=America/Sao_Paulo
+   ```
+
+   Generate token at: https://github.com/settings/tokens
+   Required scopes: `repo` (full repository access)
+
+2. **Dependencies**
+
+   Dependencies will be auto-installed on first run. To install manually:
+
+   ```bash
+   cd ~/.claude/plugins/marketplaces/claude-craftkit/plugins/reviewer/skills/pull-request-skill
+   bun install
+   ```
+
+## Output Structure
+
+The command creates a directory structure in **your repo's** `.reviews/reviews-pr-<pr>/`:
+
+```
+your-repo/
+└── .reviews/                           # Created in YOUR working directory
+    └── reviews-pr-123/
+        ├── summary.md                  # 📊 Overview with statistics
+        ├── pr-review-combined.log      # 📋 Full execution logs
+        ├── pr-review-error.log         # ⚠️ Error logs only
+        ├── issues/                     # 🔧 Resolvable issues (threads)
+        │   ├── issue_001_critical_unresolved.md
+        │   ├── issue_002_major_unresolved.md
+        │   └── issue_003_trivial_resolved.md
+        └── comments/                   # 💬 General comments
+            ├── comment_001.md
+            └── comment_002.md
+```
+
+## Issue Severity Levels
+
+Issues are automatically categorized by severity:
+
+- **🔴 Critical**: Serious problems requiring immediate attention
+- **🟠 Major**: Important issues affecting functionality
+- **🔵 Trivial**: Minor issues and style improvements
+
+## Next Steps
+
+After downloading reviews:
+
+1. **Review the summary**: Check `.reviews/reviews-pr-<pr>/summary.md`
+2. **Start fixing issues**: Use the `/fix` command
+3. **Track progress**: Issues are marked as resolved/unresolved
+
+## Environment Variables
+
+- `GITHUB_TOKEN` (required): GitHub Personal Access Token
+- `OUTPUT_DIR` (optional): Output directory relative to working dir (default: `./.reviews`)
+- `CWD` (optional): Override working directory (default: current directory)
+- `LOG_LEVEL` (optional): Logging level - `error`, `warn`, `info`, `debug` (default: `info`)
+- `PR_REVIEW_TZ` (optional): Timezone for dates (default: system timezone)
+
+## Examples
+
+```bash
+# Download PR #123 - saves to current directory's .reviews/
+/reviewer:download-issues --pr 123
+
+# Download latest open PR (auto-detects)
+/reviewer:download-issues
+
+# With debug logging
+LOG_LEVEL=debug /reviewer:download-issues --pr 123
+
+# Save to custom directory
+OUTPUT_DIR=./my-reviews /reviewer:download-issues --pr 123
+```
+
+## Troubleshooting
+
+**"GITHUB_TOKEN is not set"**
+- Create `.env` file in the skill's installation directory
+- Path: `~/.claude/plugins/marketplaces/claude-craftkit/plugins/reviewer/skills/pull-request-skill/.env`
+
+**"No CodeRabbit AI comments found"**
+- CodeRabbit hasn't reviewed the PR yet
+- Check if PR has comments from `@coderabbitai[bot]`
+
+**"Repository information could not be parsed"**
+- Verify you're in a git repository
+- Check git remote: `git remote -v`
+- Remote must be: `https://github.com/owner/repo.git`
+
+## See Also
+
+- `/reviewer:fix-issues` - Fix issues from a downloaded PR review
+- `/reviewer:pr-status` - Check status of PR reviews