用途:cs-feat 是 CodeStable 体系中的 Feature 路由入口。触发场景为新功能、加 X、实现 XX 等需求,它根据当前 feature 所处状态,告诉用户该进入 design、impl、review、QA 还是 accept 等子技能。本技能不写代码、不写文档,只做路由判断。
启动前需先执行 CodeStable preflight:读 .codestable/attention.md;缺失则先 cs-onboard;不读外部 AI 入口替代。进入本技能先 Glob .codestable/features/ 查看已有产物,不只听用户口头描述。
主要能力:按状态路由到子技能。想法模糊走 cs-brainstorm;想法清晰走 cs-feat-design;用户想自己写草稿走 cs-feat-design 初始化模式;说快速模式走 cs-feat-ff;design 为 draft 且无 design-review 走 cs-feat-design-review;design 已 approved 且代码未动走 cs-feat-impl;代码写完无 review 走 cs-code-review;review 有未解决 blocking 走 cs-feat-impl 的 review-fix;review passed 无 qa 走 cs-feat-qa;qa failed 走 cs-feat-impl 的 qa-fix;qa passed 走 cs-feat-accept。
标准阶段:0 brainstorm(可选,独立入口,仅 case 2 产出 brainstorm note);1 方案设计(cs-feat-design,产出 design.md + checklist.yaml);1.5 方案审查(cs-feat-design-review);2 分步实现(cs-feat-impl);2.5 代码审查(cs-code-review);2.6 QA 验证(cs-feat-qa);3 验收闭环(cs-feat-accept)。阶段间有 gate 和人工 checkpoint,用户未明确放行不得进入下一阶段。
Fastforward 模式:需求清楚且范围小时,把 design 压成需求摘要、设计方案、验收标准、推进步骤 4 节,一次确认后直接实现,触发词为快速模式、fastforward、直接开干、别那么多步骤,走 cs-feat-ff。跨多个子系统、有术语冲突风险、推进步骤超过 4 步时不宜走 fastforward。
文件结构:产物放在 .codestable/features/{feature}/ 下,包含 brainstorm、intent、design、design-review、checklist.yaml、review、qa、acceptance 等文件。目录命名 YYYY-MM-DD-{英文 slug},日期取首次创建当天,slug 为小写字母、数字、连字符。
限制与边界:feature 指从来没有的东西要加进来,issue 指本来应该好的东西坏了;feature 实现时发现的 bug 记成新 issue,不在 feature PR 顺手修。brainstorm 与 intent 都是 design 前置,区别在谁主导收敛。用户模糊时默认询问先 brainstorm 还是自己写草稿,不自行选择。判断是否走阶段 0 看用户能否说清真问题、核心行为、一条明确的不做什么,三项有一项模糊就值得 brainstorm,但用户明确说想清楚直接做设计则尊重。