SuperAPI AI 工具集

cs-code-review

测试与质量

查看项目

更新于 10-16 05:05

技能介绍

用途:cs-code-review 是 CodeStable 流程中的横切代码审查 gate。任何流程实现完成后、commit / QA / 验收前,对当前改动做独立只读 review,确认本次改动没有降低系统代码健康,并朝对应 spec(design / fix-note / refactor-design / 用户确认范围)目标前进。它只读代码和产物,只写 {slug}-review.md,不直接修代码、不更新 checklist、不改 spec、不替代 QA 或 acceptance。

主要能力:双环节审查。环节 A 为独立 Task agent review(gate 必需),优先 Paseo subagent,否则当前宿主原生 Codex/Claude Task/Agent,都不可用时按 local-only fallback 处理;环节 B 为 OCR 行级扫描(装了就跑,缺了降级)。审查覆盖整体(design fit、架构 fit、复杂度、测试策略、风险面、文档/归并影响)与行级(逻辑正确性、错误处理、数据与安全、性能与资源、并发/异步、可维护性、清洁度)。发现按 blocking / important / nit / suggestion / learning / praise / residual-risk 分级,verdict 为 passed / changes-requested / blocked。

使用方式:先执行 CodeStable preflight,读 .codestable/attention.md,缺失先 cs-onboard。按进入来源表确认来源并校验 spec 产物已定稿,读取 git status --short、git diff(含 staged)、diff 涉及的人写代码与相邻调用点。OCR 可用时执行 which ocr && ocr llm test,再调用 ocr review --audience agent --background "{feature slug / 目标 / 本次改动范围}";已提交 diff 用 ocr review --audience agent --from {feature-base} --to HEAD。报告落在来源 spec 目录,文件名 {slug}-review.md,正文默认中文,frontmatter/yaml 字段不翻译。

适用场景:cs-feat-impl、cs-feat-ff、cs-issue-fix、cs-refactor、cs-refactor-ff 以及 ad-hoc / pre-merge。

限制:不是 cs-audit,只审当前变更范围;OCR 不能替代环节 A;外部 reviewer 结论须经本地事实核验才能升级为 blocking;有 blocking 时须走来源实现技能的 review-fix 并重跑审查,不能跳过复审直接验收。报告模板、frontmatter 与共享路径约定见同包 references/report-template.md 与 .codestable/reference/shared-conventions.md。