cs-feat-design

SKILL.md

cs-feat-design

启动必读

开始任何判断或动作前，先读取 .codestable/attention.md；缺失则视为骨架不完整，提示先补齐或运行 cs-onboard，不要回退到外部 AI 入口文件。

这一阶段的产出是一份方案文件 {slug}-design.md，加上从中抽出的行动清单 {slug}-checklist.yaml。这两份东西后面会被两个阶段消费——implement 照着推进、acceptance 照着核对，所以这里写错或写漏，下游就跟着错。

共享路径和命名约定看 .codestable/reference/shared-conventions.md。本阶段一般 feature 目录已经由 brainstorm 创建好了；没有的话在这一步建。

本阶段有三个入口：

正式起草：用户已经能讲清楚需求（或已经填好 {slug}-intent.md），直接进"流程"一节走完整起草。

初始化模式：用户说"开一个新需求 / 起个草稿 / 新建一个 feature"，但想自己先写半成品方案而不是口述。走下一节"初始化模式"，建好目录和空 {slug}-intent.md 就结束本轮，等用户填完再回来。

从 roadmap 条目起头：用户说"开始做 roadmap 里的 {子 feature slug}"或"推进 {roadmap} 的下一条"。slug 从 roadmap items.yaml 取，不另起；动笔前要读 roadmap 主文档和 items.yaml 了解上下文和依赖状态；落盘时 frontmatter 要带 roadmap / roadmap_item 两个字段，同时回写 items.yaml 把对应条目 status 改为 in-progress、feature 填为 feature 目录名。详见下文"从 roadmap 条目起头"。

初始化模式：帮用户建目录和 intent 草稿