Code Review
概述
执行严格、对抗式的审查,将故事声明与验收标准同真实代码变更进行交叉核验。优先给出具体、可复现、带文件与行号引用的发现。如果代码是干净的,明确说明。
快速开始
确定范围:故事文件 + 仓库,或 diff/PR。
识别仓库根目录(使用 git),通过 git status --porcelain、git diff --name-only 和 git diff --cached --name-only 收集变更文件。
如果提供了故事/规格输入则加载;否则询问故事/规格或验收标准。
排除非应用文件与文件夹(.cursor/、.windsurf/、.claude/,以及其它工具/配置文件夹,除非明确要求)。
工作流
遵循 references/workflow.md 中的详细工作流。将其适配到独立仓库时使用以下防护规则:
如果 {project-root}/workflow-config.yaml 不存在,则将配置值视为可选,并向用户询问影响输出的缺失项(语言、技能水平、故事路径等)。
如果规划产物(架构/UX/史诗)不可用,则仅依据故事/规格与代码变更继续;明确注明缺失的上下文。
如果没有故事文件,则使用用户提供的标准或 PR 描述,将“故事验证”替换为“需求验证”。
审查预期
验证每一条验收标准以及每一个标记为完成的任务。缺失验收标准为 HIGH 严重级别;标记为完成但未实现的任务为 CRITICAL。
将故事文件清单与实际 git 变更交叉核对;报告差异。
覆盖安全、性能、错误处理、测试质量与可维护性。
如果第二轮检查后没有剩余问题,则报告审查通过。
输出
按严重程度分组呈现发现,附带证据(文件:行),并附简短影响说明。
如有要求,修复问题或创建行动项;否则提供简洁的修复清单。
在适用时,按照工作流更新故事状态与冲刺状态。
参考
references/workflow.md 为完整的独立代码审查流程。
references/discover-inputs.md 为输入发现/加载策略。
references/checklist.md 为审查完成检查清单。