SuperAPI AI 工具集

cs-feat-design

设计与创作

查看项目

更新于 10-15 20:30

技能介绍

cs-feat-design 是 CodeStable 流程中的一个技能,用途是在新功能需求已清楚之后,起草该功能的方案文件 {slug}-design.md,并从中抽出行动清单 {slug}-checklist.yaml,以及人审前的 {slug}-design-review.md。这些产物会被后续的实现、代码审查、QA 与验收环节继续使用。

使用前必须先执行 CodeStable preflight:读 .codestable/attention.md,缺失则先走 cs-onboard。设计阶段产物为方案文件 {slug}-design.md、行动清单 {slug}-checklist.yaml 和评审前置文件 {slug}-design-review.md。设计正文按约定必须使用中文,frontmatter 与 yaml 字段不翻译。

它有三个入口:用户能讲清需求时直接起草;用户想自己写半成品方案时进入初始化模式,只建目录和空的 {slug}-intent.md;从 roadmap 条目起头时,slug 取自 roadmap,落盘前需读 roadmap 主文档与 items.yaml,并在候选落盘时回写 items.yaml。

design 只负责编排层:名词层、编排层、流程级约束,都按“现状 → 变化”两段式书写,并包含挂载点清单和固定的结构健康度评估。它不写改动文件清单、函数级落点、测试代码或库选型细节,这些归实现阶段。流程包含启动检查、模块归属判断、分节撰写、design review gate、用户整体 review、确认 checklist 与退出条件核对。落盘后用 python .codestable/tools/validate-yaml.py --file {path} --yaml-only 校验。

限制:必须通过 cs-feat-design-review 后才能交用户整体 review;设计阶段的微重构仅限“只搬不改行为”,超出部分需另行处理。其它未提供的信息暂未提供。