用途:对某个 PRD 实现做结构化代码审查,产出 reviews-NNN 审查轮次目录及 issue_NNN.md 文件,供 cy-fix-reviews 工作流后续处理。
主要能力:根据功能名定位 .compozy/tasks/<name>/ 目录,读取 _prd.md、_techspec.md、_tasks.md 与 adrs/ 获取需求与架构上下文;自动确定下一轮次编号,并读取历史轮次 issue 以避免重复标记;按安全、正确性、并发、性能与可扩展性、错误处理、代码质量与可维护性、测试、架构、运维九个领域评估;按 critical、high、medium、low 分级;对同一根因去重,只记录新问题;先运行 make lint 过滤 linter 已覆盖的问题;同时记录实现良好的方面。
使用方式:需提供功能名,可选指定文件或目录范围。未指定范围时运行 git diff main...HEAD --name-only 发现变更文件。若范围超过 15 个文件,先分诊核心实现文件再审查其余文件。每个 issue 文件使用固定 YAML frontmatter,provider 为 manual、author 为 claude-code、provider_ref 为空、round 与目录编号一致、round_created_at 为同一 UTC RFC3339 时间戳、severity 为 critical/high/medium/low 之一。完成后输出合并建议、问题统计、轮次目录路径与文件列表,并建议运行 compozy reviews fix <name>。
适用场景:需要按 PRD 与技术规格核对实现、生成可追踪审查问题清单的代码审查流程。
限制:不修复问题、不修改源码、不调用 provider 专用脚本或 gh 变更、不创建空审查轮次、不维护 _meta.md。PRD 目录不存在时停止并报告;_prd.md 与 _techspec.md 均缺失时仅做代码质量审查;无法识别文件且未提供路径时需用户指定;make lint 无法运行时在摘要中说明并继续审查。完成前需用 cy-final-verify 验证。