SuperAPI AI 工具集

cs-feat-design-review

编程与开发

查看项目

更新于 10-15 20:30

技能介绍

用途:在 feature design 交给用户人工确认前做方案审查 gate,确认 design 已具备让用户有效 review、让下游稳定执行的条件,包括需求边界可核对、名词层与编排层有代码事实支撑、steps 可独立验证、checks 能回到 design 证据,以及风险、基线、交付物、清洁度可被后续 implement、code review、QA 和 acceptance 消费。

用法:开始前需执行 CodeStable preflight,读 .codestable/attention.md,缺失则先 cs-onboard。必须读取 .codestable/attention.md、.codestable/features/{feature}/{slug}-design.md、{slug}-checklist.yaml,同目录 intent/brainstorm(如有)、design frontmatter 指向的 requirement/roadmap/architecture 文档,以及 design 引用的关键代码、接口、类型、组件、命令。报告落盘到 .codestable/features/{feature}/{slug}-design-review.md,正文按 attention.md 用中文,frontmatter/yaml 字段不翻译。

主要环节:启动检查 design 与 checklist 存在性、frontmatter、steps/checks 非空且状态为 pending,并核对 roadmap item 对齐;优先启动独立 Task agent reviewer(有 mcp__paseo__create_agent 时用 Paseo subagent,否则原生 Codex/Claude Task/Agent),独立审查未返回前不得定稿 passed;主 agent 逐条核验 reviewer finding 后合并,去重定级。审查覆盖需求边界、术语与现状、名词层、module/interface、编排层、挂载点、结构健康度、验收契约、checklist steps/checks、基线与验证命令、交付物与清洁度。

严重度:blocking、important、nit、suggestion、learning、praise、residual-risk。报告需含 Scope And Inputs、Design Summary、Findings、User Review Focus、Evidence Confidence Ledger(E/C/H 证据分级)、Residual Risk、Verdict;核心检查仅有 H 证据时不得静默 passed。

限制:只读,只写 {slug}-design-review.md,不直接改 design/checklist、不替用户批准 design、不进入实现;缺 checklist、checklist 状态已非 pending 等情形报告 blocked;无独立 reviewer 能力或需降级时须先写 approval-report.md 并由用户选择,不得以批量或赶时间为由降级;reviewer 失败、超时或权限阻塞时报告 blocked,等待用户决定。原文未提供具体价格、收费或其它平台信息。