Code Review Executor

执行代码审查，读取配置文件中的 skill/command 预设，协调多个 subagents 并行执行审查，生成综合报告。

文件写入规范

重要: 在此技能执行过程中，所有文件写入操作必须使用 Write 工具，而不是通过 Bash 工具执行 cat > 等 shell 命令。

Write 工具的使用场景:

• 保存 JSON 配置文件（code-context.json, commits.json, branch-info.json）
• 保存 Markdown 报告（DEBUG-SESSION.md, 综合报告, skill 报告）
• 任何需要创建或修改文件的场景

Bash 工具的使用场景:

• 查询信息（git log, git diff, ls）
• 移动/复制文件
• 创建目录
• 执行 shell 脚本

Purpose

管理完整的代码审查执行流程：

• 加载并验证配置文件
• 让用户选择审查预设
• 收集代码内容（diffs, commits, branches）
• 协调多个 subagents 并行执行（支持 skills 和 commands）
• 汇总审查结果生成综合报告

能力类型

Executor 支持调用两种类型的 review 能力：

• skill: SKILL.md 格式的技能，通过 Task 工具的 subagent_type 调用
• command: 插件中的命令，通过 Skill 工具调用

配置文件中的 type 字段标识能力类型，Executor 需要根据类型选择正确的调用方式。

When to Use

当用户请求代码审查时触发：

• "Review my code"
• "Review feature/auth branch"
• "Review MR !1234" / "Review PR #567"
• "Review feature/auth vs dev branch"
• "Do a code review"

Workflow

Step 0: Debug Mode Detection (Optional)

配置: Debug mode 可通过用户输入或交互式确认控制。

启用 Debug Mode 的方式:

1. 自动检测: 用户输入中包含关键词（debug, verbose, 调试, 详细, --debug, -v）
2. 交互式: 提示时选择 "启用调试" 启用详细日志

Debug Mode 记录内容:

• 所有检查点和决策点
• 用户选择和确认
• Subagent 启动和完成状态
• 时间戳和进度跟踪
• 完整的交互历史

输出: 使用 Write 工具保存到工作目录的 DEBUG-SESSION.md

---

Step 1: 加载并验证配置

从配置文件加载 review skills 配置。

1.1 查找配置文件

按优先级查找配置文件（项目 > 用户 > 全局）：

# 项目配置
.claude/code-review-skills/config.yaml

# 用户配置
~/.claude/code-review-skills/config.yaml

# 全局配置
~/.config/claude/code-review-skills/config.yaml

1.2 检查配置是否存在

如果配置文件不存在:

• 提示用户配置文件缺失
• 建议运行 code-review:config-manager 初始化配置
• 提供快速初始化选项

示例提示:

未找到 Code Review 配置文件。

需要先配置 review skills。请：
1. 运行 "code-review:config-manager" 初始化配置
2. 或选择下方快速初始化

[快速初始化] [手动配置] [取消]

1.3 合并多层级配置

如果存在多层级配置，运行 scripts/merge-configs.sh 合并：

../config-manager/scripts/merge-configs.sh

合并规则：

• available_skills: 取并集，去重
• presets: 按名称覆盖（项目 > 用户 > 全局）
• metadata: 取最高优先级

1.4...