SuperAPI AI 工具集

cs-roadmap-review

通用与其它

查看项目

更新于 10-15 20:30

技能介绍

用途:这是 CodeStable 工作流中 roadmap 交给用户人工确认前的规划审查 gate。它只读 roadmap、items.yaml、相关文档与必要代码事实,只写报告,不修改 roadmap、不代替用户批准、不推进 feature design,目标是确认 roadmap 已具备让用户有效 review 的条件。

主要能力:审查目标完成信号是否可观察可验收、范围与明确不做是否具体、模块拆分是否职责清楚、接口契约是否写到函数签名/数据结构/协议字段/错误码级别、子 feature 能否独立 design/implement/review/QA/accept、依赖 DAG 是否无环且最弱依赖先验证、最小闭环能否端到端演示、验证基线与风险恢复是否提前暴露、知识回写点是否具备。每轮产出 Evidence Confidence Ledger(E/C/H 分级),核心检查仅有 H 证据时不得静默 passed。

使用方式:开始前先执行 CodeStable preflight,读 .codestable/attention.md,缺失先 cs-onboard。必须读取 roadmap/{slug}/{slug}-roadmap.md、{slug}-items.yaml、相关 drafts、frontmatter 指向的 requirement/architecture、items 中已有 feature 的 design/acceptance,以及 roadmap 声称复用的代码事实。本阶段须优先启动独立 Task agent reviewer:有 mcp__paseo__create_agent 时优先用 Paseo subagent 做只读异构审查,否则用宿主原生 Codex/Claude Task/Agent;两者都无且用户授权后方可 local-only。reviewer 返回前不得定稿 passed。报告写入 .codestable/roadmap/{slug}/{slug}-roadmap-review.md,正文必须中文,frontmatter/yaml 字段不翻译。

适用场景:roadmap/items 在人审前的规划审查,或用户要求规划审查,以及 roadmap 变更后的复审。

限制:只读、不写 roadmap、不代用户批准;无代码引用时不强扫全仓,但声称复用现有模块/接口/命令/配置/数据结构时必须核验;reviewer 失败、超时或权限阻塞时报 blocked,不得降级伪装;严重度只用 blocking/important/nit/suggestion/learning/praise/residual-risk,个人拆法偏好不得升级为 blocking。