用途:将已批准的设计(来自 grill 或用户指定的设计)整理成一份可长期保存的产品规格,让新同事或未来的自己无需会议记录也能理解。规格回答“做什么、为什么”,计划回答“怎么做、按什么顺序”,两者不得混淆。上游必需:grill 或已批准的设计,不得在写规格时自行发明产品决策。
主要能力:按固定模板产出规格,包含当前状态(仅重构/遗留场景)、一句话概述、用户场景(正常路径与失败/边界)、范围(In/Out)、决策日志、验收标准、约束、简要构建方式、开放风险。写作要求用平实语言、以用户可见场景驱动,每个“应该”都要变成可演示或可测试的具体案例;不写文件路径、TDD 步骤或提交列表。
使用方式:确认来源设计;默认输出到 docs/creed/specs/YYYY-MM-DD-<topic>-design.md(用户路径可覆盖);按模板撰写并自审;请用户过目;若涉及新模块/端口/IO 边界则交给 solid,否则进入 write-plan 再到 tdd。交接前需向用户确认:继续、先 review、调整或其它。
适用场景:grill 批准后、write-plan 之前;用户索要设计文档/规格/PRD-lite;把工作交给未参与 grill 的人或智能体。
限制:不适用于已知修复方式的纯 bug 修复、无产品歧义的一行改动,或用户已有批准规格只需 write-plan 的情况。产品决策未定应回到 grill,不得直接规划。资料未提供具体收费、平台或效果信息。