用途:将已定稿的设计整理为无歧义工程规格,让实现者只读规格即可理解预期方案、已锁定内容以及可自行决定的范围。该技能属于设计阶段的产出,而非设计环节本身;若仍有重大设计问题未决,应先用设计讨论类技能解决,再进行规格撰写。
主要能力:按入口区分处理空白模板、已提供设计和长对话总结三种情况;将对话综合为 Context(问题、用户、已定方案、时机与关键约束)。撰写前会查阅 prisma/ignite 中的现有标准、约定与架构文档,并在 References 中标注来源路径。草稿按 Spec Template 组织,先写 Context 作为锚点,再写需求与验收标准;需求只描述能力与约束,不写实现细节;验收标准应是可观察、可验证、可追溯的场景。
使用方式:项目规格输出到 projects/{project}/spec.md,任务/功能规格输出到 projects/{project}/specs/{name}.spec.md,{name} 用 kebab-case。未指定项目时需询问项目 slug 并创建目录。草稿前必须用 Grep / Read / Glob / SemanticSearch 核实代码库现状,不能把“尚未检查”作为开放问题或 TODO。pirma/ignite 优先从本地克隆读取,未提供时询问位置。完成后进入精炼循环,以编号列表呈现开放问题,逐条处理直至无遗留问题或明确留作实现者自由度。
适用场景:需要把已谈定的设计、PRD 或功能方案写成规格并交给实现者时;需要记录迁移步骤、特性开关、弃用时间线等临时细节时。
限制:规格随项目生命周期存在,项目收尾时由 drive-close-project 迁移长期决策后删除;不应创建指向 projects/{project}/ 的长期仓库文档,如必须存在,收尾时要替换为 docs/ 链接。每个明确语句默认视为锁定设计,若不想约束实现者须显式标注为示意性或非绑定。代码示例需说明是指定性还是示意性。设计未定稿时不应撰写规格;规格层面只问代码库无法回答的决策。收费、价格、平台或效果类信息资料未提供。