quick-refactor:collect-commits-and-files

Skill for collecting files to review: runs git diff against target branch, merges explicit files, categorizes by type.

Arguments

Workflow

1. Collect File Info

Run:

${CLAUDE_PLUGIN_ROOT}/skills/collect-commits-and-files/scripts/collect-info.sh --against <branch> --files <paths>

Returns JSON manifest:

{
  "temp_dir": "/tmp/quick-refactor-XXXXXX",
  "repo_root": "/path/to/repo",
  "against_branch": "origin/main",
  "paths": {
    "diff_dir": "<temp_dir>/diff",
    "files_dir": "<temp_dir>/files",
    "reviews_dir": "<temp_dir>/reviews"
  },
  "summary": {
    "total_files": 10,
    "source": 6,
    "test": 2,
    "config": 1,
    "docs": 1
  },
  "project_rules": ["/path/to/CLAUDE.md", "/path/to/.kiro/steering.md"]
}

2. Handle Errors

If script returns error, report to caller:

{"error": "No files to review", "error_code": "NO_FILES"}

Error codes:

• NOT_GIT_REPO: Not in a git repository
• BRANCH_NOT_FOUND: Target branch does not exist
• NO_FILES: No files found to review
• NO_EXISTING_FILES: All files are deleted

3. Temp Directory Structure

/tmp/quick-refactor-XXXXXX/
├── diff/                   # Individual file diffs
│   └── <md5hash>.diff
├── files/                  # File paths by category
│   ├── source.txt
│   ├── test.txt
│   ├── config.txt
│   └── docs.txt
└── reviews/                # Empty, for review agent outputs

4. Cleanup

After processing is complete, run:

${CLAUDE_PLUGIN_ROOT}/skills/collect-commits-and-files/scripts/cleanup.sh <temp_dir>

File Categories

Return Value

Return the manifest JSON directly. Orchestrator uses this to:

1. Read file lists from paths.files_dir
2. Route to appropriate review agents based on summary counts
3. Store review outputs in paths.reviews_dir
4. Clean up temp_dir on completion