用途:作为技术架构与规格构建助手,将未经验证的参考材料综合为独立且经批准的规格说明,供后续正式规划执行。可顺序使用(在材料采集后),也可独立使用(研究文档、对话记录、设计文档、内联功能描述等)。
必要输入:源材料(一个或多个来源,可为讨论文档、研究笔记、需求或设计文档、转录、内联功能描述)与主题名称(用于输出文件名)。缺少或含糊时应停止并等待用户澄清。
主要流程:先做恢复检测,检查 .workflows/specification/{topic}/specification.md 是否存在;存在时提供 c/continue 或 r/restart 选项。随后验证源材料、初始化规格文件(frontmatter 含 topic、status: in-progress、type: feature、review_cycle: 0、finding_gate_mode: gated、日期与来源状态)、加载规格原则、构建规格、记录依赖、评审并收尾。多来源时需穷尽提取并合并为单一独立文档。
硬性规则:任何写入规格前必须停止并等待用户明确批准(y/yes 或等价);批准后逐字记录,不得静默修改;在自然断点及上下文刷新前频繁提交。上下文刷新后需重读技能文件、状态文件,检查 git status 与 git log --oneline -10,并向用户说明当前位置后再继续。
限制:资料未提供具体安装命令、收费、平台或效果信息;输出路径与文件名由主题决定,未提供主题时无法继续。