name: design description: 在 discover 已完成路径判定后,生成全局设计文档(Design Baseline)
Design — 全局设计基线生成
本 Skill 负责:
- 承接
discover已确认的 DESIGN 类需求 - 生成新的全局设计文档(Design Baseline)
- 作为后续 Feature / Tasks 的项目级单一事实来源(Source of Truth)
执行过程中:
- 禁止重新进行需求分流
- 禁止重复执行 discover 职责
- 禁止生成实现代码
- 禁止生成 patch / diff / PR / git 命令
- 禁止描述函数级或行级修改步骤
- 禁止生成除
docs/*-design.md外的任何文件 - 禁止运行会改变工作区的命令
- 禁止调用其他技能
允许写入:
docs/*-design.md# 项目设计文档
输入前提(Preconditions)
触发本 Skill 前,必须满足:
- 已完成
discover discover输出结果为:
NEXT_STATE: DESIGN
流程(Process)
1) 汇总当前设计输入
- discover 已确认的需求意图
- 可读取的模板字段要求
2) 按模板生成文档
- 必须且只能使用
templates/design.md生成文档 - 严格按模板章节输出
- 不新增章节
- 不改名章节
- 不跳过关键字段
- 语言以中文为主,关键术语可括注英文
3) 写入新文档
- 生成新文件:
docs/YYYY-MM-DD-HH-MM-design.md - 在 References 中追加:
Previous Design: docs/<last-design-filename>(如存在)
输出(Output)
- 生成:
docs/YYYY-MM-DD-HH-MM-design.md
要求:
- 内容必须由模板
templates/design.md渲染得到 - 仅允许字段填充,不允许脱离模板自由发挥
- 文档必须可作为后续 feat / task / execute 的上游依据
失败处理(Failure Modes)
- 找不到
templates/design.md:停止并报告错误(不得生成文档) - 找不到可引用的设计文档:仍可生成,但需说明"首次设计,无历史引用"
文档内容要求(Design Requirements)
生成的 Design Baseline 至少应覆盖:
- 本次设计的目标与背景
- 项目级范围边界
- 非目标(明确不做什么)
- 核心架构或核心设计思路
- 关键决策与权衡
- 风险与约束
- 项目级验收标准
- 未决问题
- 与上一版 design 的关系
终态(End State)
终态不是实现,不是任务拆分,也不是继续追问。
终态是:
OUTPUT: docs/YYYY-MM-DD-HH-MM-design.md
STATE: DESIGN_BASELINE_READY