SuperAPI AI 工具集

cy-review-round

编程与开发

查看项目

更新于 10-15 20:27

技能介绍

用途:对 PRD 实现进行结构化代码审查,产出 review round 目录与问题文件,供 cy-fix-reviews 流程后续修复处理。

主要能力:支持按功能名定位 .compozy/tasks/<name>/ 目录;可指定文件或目录限定审查范围。自动确定轮次目录 reviews-NNN(三位补零),读取此前轮次问题避免重复跟踪。读取 _prd.md、_techspec.md、_tasks.md 及 adrs/ 了解需求与架构决策。围绕安全、正确性、并发、性能与可扩展性、错误处理、代码质量与可维护性、测试、架构、运维九个方面评估。按 critical、high、medium、low 排序,记录文件路径、行号、严重级别、标题和详细评论。执行去重、标记前核实、跳过 linter 已捕获项,并注重少而精的信号。

使用方式:需要提供功能名,可选提供要审查的文件或目录。发现需求或技术规格缺失时会警告但仍继续仅代码质量审查。未显式指定范围时,通过 git diff main...HEAD --name-only 发现变更文件。正式审查前先运行 make lint 过滤 lint 覆盖项。若发现 critical 或 high 问题,提示合并前需修复;仅有 medium 或 low 时提示可合并并跟进;无问题则提示清洁可合并,并建议运行 compozy reviews fix <name> 处理。完成后使用 cy-final-verify 校验,回读问题文件确认 frontmatter 可解析,确认同轮次 provider、pr、round、round_created_at 一致。每条问题文件须使用指定 YAML frontmatter,作者固定为 claude-code,provider 为 manual,provider_ref 为空,round_created_at 使用同一 RFC3339 UTC 时间戳,严重级别只能是 critical、high、medium、low。

限制:本技能只识别和记录问题,不修复,不修改源码,不创建空轮次,不维护 _meta.md,不调用 provider 专用脚本或 gh 变更。PRD 目录不存在或无文件可审查且未提供路径时会停止或询问。lint 无法运行时会在摘要中说明并继续审查。