Scan to join WeChat group代码审查 Skill 使用指南
本 Skill 提供自动化代码审查能力。本文档为入口导航页，具体执行规范拆分到 workflows/ 与 references/ 下的对应文件中。
路径规则与仓库获取规范详见 references/repository_access.md。
🔧 工作流
workflows/ 目录包含本 Skill 的核心执行流程，按触发场景分为以下工作流：
| 工作流 | 说明 | 文档 | |--------|------|------| | 工作流一：手动触发 | 用户主动要求审查单个仓库时使用，无条件执行完整审查流程。 | workflows/manual_workflow.md | | 工作流二：定时触发 | 定时任务或自动化调度触发单个仓库审查时使用，先检查版本是否变化，仅在有变化时执行审查。 | workflows/scheduled_workflow.md | | 工作流三：前后端跨仓库联调审查 | 用户显式指明前后端仓库对照关系时使用，分别审查前后端单仓质量，并检查联调一致性。支持手动与定时两种触发模式。 | workflows/cross_repo_integration_workflow.md |
工作流执行时可按需启用并行加速策略：
- 环境支持子代理时，跨仓库联调审查、多仓库批量审查等场景可按 workflows/strategies/subagent_strategy.md 拆分任务并行执行，以缩短整体耗时。
- 子代理策略为可选策略，环境不支持时自动降级为串行执行，不影响审查流程完整性。
执行前必须先确定当前场景并选择对应工作流，禁止混用。跨仓库联调审查必须确认用户已显式指明前后端对照关系，不得仅凭两个仓库地址自动推断。
💡 技能安装 / 更新 / 升级：若用户要求的是安装、更新或升级本技能本身（而非执行代码审查），请直接阅读 references/installation.md，根据当前环境选择对应的安装或更新方式（Prompt 安装、OpenClaw CLI、IDE / 其他 CLI、国内镜像）执行，无需进入上述审查工作流。
🎯 场景路由表
| 场景 | 文档 | |------|------| | 手动触发代码审查（用户主动要求 / 本地审查 / 远程对话） | workflows/manual_workflow.md | | 定时触发代码审查（自动化调度 / 定时任务） | workflows/scheduled_workflow.md | | 前后端跨仓库联调审查（用户显式指明前后端对照关系） | workflows/cross_repo_integration_workflow.md | | 仓库获取、SSH 配置、版本信息获取 | references/repository_access.md | | 审查规则、检查维度、问题分级 | references/review_process.md | | 报告格式、保存、分发与通知 | references/report_delivery.md | | 单仓审查报告模板 | references/templates/report.md | | 跨仓库联调审查报告模板 | references/templates/cross_repo_report.md | | 已忽略与误报问题清单模板 | references/templates/ignored_issues_template.md | | 安装与更新 | references/installation.md |
📁 文件目录结构
code-review/
├── SKILL.md # 入口文件（本文件），场景路由
├── workflows/ # 工作流编排
│ ├── manual_workflow.md # 工作流一：手动触发
│ ├── scheduled_workflow.md # 工作流二：定时触发
│ ├── cross_repo_integration_workflow.md # 工作流三：前后端跨仓库联调审查
│ └── strategies/ # 工作流执行策略
│ └── subagent_strategy.md # 子代理并行审查策略
└── references/ # 参考文档
├── review_process.md # 代码审查流程与规则
├── cross_repo_integration_checks.md # 跨仓库联调一致性检查维度
├── report_delivery.md # 报告保存、分发与通知
├── templates/ # 报告与清单模板
│ ├── report.md # 单仓审查报告模板
│ ├── cross_repo_report.md # 跨仓库联调审查报告模板
│ └── ignored_issues_template.md # 已忽略与误报问题清单模板
├── repository_access.md # 仓库获取规范
├── installation.md # 安装与更新
├── python_dependency_installation/ # Python 依赖安装
│ ├── review_tools.md # 审查工具依赖安装
│ └── project_dependencies.md # 项目业务依赖安装
├── frontend_dependency_installation/ # 前端依赖安装
│ ├── node_environment.md # Node 环境管理（Volta）
│ └── project_dependencies.md # 前端项目业务依赖安装
└── language_checks/ # 语言专项检查
├── python_type_check.md # Python 类型检查
├── python_pypi_packaging.md # Python PyPI 包依赖与打包
└── typescript_javascript_check.md # TypeScript/JavaScript 检查
📂 报告输出目录结构
审查报告默认输出到被审查项目的 docs/code_reviews/ 目录。
单仓审查（工作流一、工作流二）：
docs/code_reviews/
├── <日期>-<模型>-代码审查报告.md # 新生成的审查报告（待用户处理）
├── fixed/ # 待工具扫描的收件箱（用户手动放入已审阅报告）
│ └── <日期>-<模型>-代码审查报告.md
├── archived/ # 已被工具扫描归档的报告（不再重复扫描）
│ ├── <日期>-<模型>-代码审查报告.md
│ └── ...
└── ignored_issues.md # 已忽略与误报问题清单（自动维护，跨次审查持久化）
跨仓库联调审查（工作流三）：
- 前端单仓报告：
前端仓库/docs/code_reviews/<日期>-<模型>-前端代码审查报告.md - 后端单仓报告：
后端仓库/docs/code_reviews/<日期>-<模型>-后端代码审查报告.md - 联调报告：
主仓库/docs/code_reviews/<日期>-<模型>-前后端联调审查报告.md - 忽略与误报清单：
主仓库/docs/code_reviews/ignored_issues.md
fixed/与archived/目录说明：
fixed/（收件箱）：用户查看报告后，将已确认处理（标记了忽略、误报或修复了问题）的报告移至fixed/目录。archived/（归档）：工具在审查前扫描fixed/目录中的报告提取忽略与误报标记后，自动把fixed/下全部报告移动到archived/目录，使fixed/保持为空。下次审查只扫描用户新放入fixed/的报告，避免重复扫描。- 报告扫描范围：仅扫描
fixed/，不扫描archived/（已归档），也不扫描根目录下的新生成报告。- 原报告引用：
ignored_issues.md中「原报告」字段只记录文件名，对应文件已归档于docs/code_reviews/archived/子目录。
❓ 常见问题
详见 FAQ.md。
📦 安装与更新
技能安装
Skill 的安装说明与更新步骤，详见 references/installation.md。
审查环境准备
执行审查前需准备所需的审查工具与项目业务依赖：
- Python 审查工具依赖（Pyright、Pyrefly、pyupgrade、Ruff 等）的环境检测、安装与升级，详见 references/python_dependency_installation/review_tools.md。
- 被审查 Python 项目业务依赖的安装策略，详见 references/python_dependency_installation/project_dependencies.md。
- 被审查前端项目的 Node 环境准备（Volta）与业务依赖安装策略，分别详见 references/frontend_dependency_installation/node_environment.md 和 references/frontend_dependency_installation/project_dependencies.md。