yzr-sys-design-doc
Installation
SKILL.md
yzr-sys-design-doc
把"写系统设计文档"约束成结构一致、评审友好、可落地执行的产物:按改动规模路由 full / lite
两档模板——full 档产出设计文档 + 实施任务书(执行期活文档),lite 档产出单份设计说明。
章节结构、每节"写什么"与节内分工以 assets/ 模板文件为准;跨节原则的"为什么"以本文件
执行原则为 SSOT,模板不重复(唯一例外:assets/template-tasks.md 要脱离本 skill 给执行者
单读,纪律段故意自包含)。SKILL.md 承载执行原则、档位路由、工作流与质量自检。
输入 / 输出
- 输入:用户的自然语言需求(可能含系统现状、技术栈、约束、评审时间);可选:代码仓路径 / 相关已有文档
- 输出:full 档产出两个本地 Markdown 文件——设计文档
<功能slug>-design.md(评审 artifact, 评审后保持稳定)+ 实施任务书<功能slug>-tasks.md(执行期活文档,进度 / 问题 / 设计变更在其中流转); lite 档只产出<功能slug>-design.md。路径用户指定或当前工作目录;正文中文,技术术语保留英文
执行原则 / 边界
第一条是元原则,其余按文档生命周期排序:判档 → 需求层 → 方案层 → 落地层。