用途:把“写系统设计文档”约束成结构一致、评审友好、可落地执行的产物。主场景是给已有系统增加或修改功能。按改动规模路由两档——full 档产出设计文档 <功能slug>-design.md 与实施任务书 <功能slug>-tasks.md;lite 档只产出单份设计说明。章节结构与每节“写什么”以 assets/ 模板文件为准。
主要能力:判档(新系统、跨服务、改核心链路、状态机重构、正式评审会走 full;单服务内小改动走 lite;拿不准默认 full);需求层先行(背景与现状、目标与非目标、功能点拆解、功能规格与约束、场景拆解);全量拆解(功能点清单与主流程/分支/异常场景表作为完备性基准);设计决策留痕(备选方案带否决理由);工程回退与业务撤销分开;设计文档为 SSOT、任务书为执行期活文档。
使用方式:读模板(full → assets/template-full.md;lite → assets/template-lite.md),补上下文(有代码仓路径先读代码),按模板写并保持章节顺序命名不动,不适用节写“本期无 + 一句话原因”,full 档按 assets/template-tasks.md 生成任务书,交付前逐条自检(元信息、非目标、落点、口径一致、无裸 TBD、DFX、备选方案、回滚、开放问题等)。
适用场景与限制:适合正式评审用设计文档;现状断言需有出处(代码位置、配置项、线上数据、用户口述),无出处进假设清单;数字须标口径;未决项集中开放问题节。正文中文,技术术语保留英文。具体模板文件内容、收费与平台等细节暂未提供。