Code Review

代码审查技能集，包含配置管理和审查执行两个子技能。

子技能

code-review:config-manager - 配置管理器，管理 review skills 配置
code-review:executor - 审查执行器，执行代码审查并生成报告

工作流程

Step 1: 识别用户意图

根据用户的输入，判断是配置管理需求还是执行审查需求。

配置管理关键词（触发 config-manager）:

"配置" (config), "管理配置" (manage config)
"更新 skills" (update skills), "发现 skills" (discover skills)
"同步 skills" (sync skills), "刷新 skills" (refresh skills)
"管理预设" (manage presets), "编辑预设" (edit presets)
"创建预设" (create preset), "删除预设" (delete preset)
"验证配置" (validate config), "检查配置" (check config)
"查看配置" (view config), "显示配置" (show config)
"初始化配置" (init config), "创建配置" (create config)

执行审查关键词（触发 executor）:

"review code", "review my code", "代码审查"
"review branch", "review {branch} vs {branch}"
"review MR", "review PR", "review !1234", "review #567"
"check code quality", "代码质量检查"
"review entire project", "review all code", "审查整个项目"

Step 2: 路由到相应技能

如果是配置管理需求:

使用 Skill tool 调用 code-review:config-manager

如果是执行审查需求:

使用 Skill tool 调用 code-review:executor

Step 3: 执行子技能工作流程

子技能会处理具体的工作流程，此入口只负责路由。

使用示例

配置管理

用户输入: "帮我更新 review skills 配置" 意图识别: 配置管理路由: code-review:config-manager

用户输入: "查看当前的 review 配置" 意图识别: 配置管理路由: code-review:config-manager

用户输入: "创建一个新的安全审查预设" 意图识别: 配置管理路由: code-review:config-manager

执行审查

用户输入: "Review my code" 意图识别: 执行审查路由: code-review:executor

用户输入: "Review feature/auth branch" 意图识别: 执行审查路由: code-review:executor

用户输入: "Review MR !1234" 意图识别: 执行审查路由: code-review:executor

用户输入: "代码审查：feature/auth vs dev" 意图识别: 执行审查路由: code-review:executor

首次使用指南

如果是首次使用 code-review skills：

初始化配置: 运行 code-review:config-manager 初始化配置文件
发现 skills: 让 config-manager 自动发现可用的 review skills
创建预设: 根据需要创建自定义预设
执行审查: 运行 code-review:executor 开始代码审查

配置文件位置

配置文件支持三级优先级：

项目配置: .claude/code-review-skills/config.yaml (最高优先级)
用户配置: ~/.claude/code-review-skills/config.yaml
全局配置: ~/.config/claude/code-review-skills/config.yaml

优先级：项目 > 用户 > 全局

常见问题

Q: 配置文件在哪里？

A: 配置文件位于 .claude/code-review-skills/config.yaml（项目级）、~/.claude/code-review-skills/config.yaml（用户级）或 ~/.config/claude/code-review-skills/config.yaml（全局级）。

Q: 如何添加新的 review preset？

A: 运行 code-review:config-manager，选择 "管理预设"，然后 "创建新预设"。

Q: 如何更新 available skills 列表？

A: 运行 code-review:config-manager，选择 "发现并更新 skills"。

Q: 可以直接使用 executor 而不配置吗？

A: 不行，executor 依赖配置文件中的预设。首次使用需要先运行 config-manager 初始化配置。

Q: 预设中的 skill 不可用怎么办？

A: Executor 会警告您并询问是否跳过该 skill 或取消审查。您可以运行 config-manager 更新 skills 列表。

技能关系

code-review (主入口)
├── code-review:config-manager (配置管理)
│   ├── 初始化配置文件
│   ├── 自动发现 skills
│   ├── 管理预设配置
│   ├── 查看配置状态
│   └── 验证配置文件
│
└── code-review:executor (审查执行)
    ├── 加载配置文件
    ├── 选择审查预设
    ├── 收集代码内容
    ├── 并行执行审查
    └── 汇总审查结果

路由决策流程

# 识别用户意图
user_input = "<用户输入>".lower()

# 配置管理关键词
config_keywords = [
    "配置", "config",
    "更新 skill", "update skill", "发现 skill", "discover skill",
    "管理预设", "manage preset", "编辑预设", "edit preset",
    "验证配置", "validate config", "查看配置", "view config",
    "初始化配置", "init config"
]

# 执行审查关键词
review_keywords = [
    "review", "审查", "代码审查",
    "check code quality", "代码质量",
    "mr", "pr", "!1234", "#567", "branch"
]

# 决策
if any(keyword in user_input for keyword in config_keywords):
    # 配置管理
    use Skill tool to invoke "code-review:config-manager"
elif any(keyword in user_input for keyword in review_keywords):
    # 执行审查
    use Skill tool to invoke "code-review:executor"
else:
    # 无法确定意图，询问用户
    use AskUserQuestion to clarify

注意事项

路由优先级: 如果用户输入同时匹配配置管理和执行审查关键词，优先执行配置管理（因为配置问题需要先解决）
首次使用: 首次使用必须先运行 config-manager 初始化配置
配置依赖: executor 依赖有效的配置文件，如果配置缺失或无效会提示用户
并行执行: executor 会并行执行多个 skills，建议根据项目大小选择合适的预设