用途:将PRD中的业务需求转化为详细技术规格(TechSpec),明确“如何实现”,而非重复业务目标。适用于已有PRD、需要技术方案设计与决策记录的场景。
主要能力:读取或询问PRD内容,探索代码库架构与依赖;逐个提出3-6个技术澄清问题(架构、数据模型、API、测试策略等);为关键决策生成ADR;按规范模板撰写TechSpec,包含核心接口、开发排序,并在结尾列出全部ADR;与用户评审并迭代后保存。
使用方式:需提供功能名称以确定 .compozy/tasks/<name>/ 目录。可选输入为已有 _prd.md 或 _techspec.md(更新模式)。流程为:收集上下文、提问、创建ADR、起草、评审、保存到 .compozy/tasks/<name>/_techspec.md。提问须使用运行时的交互式提问工具,一次只问一个;若没有该工具,则把问题作为完整消息输出并停止等待。完成后提示用户使用 cy-create-tasks 创建任务。
限制与原则:每次只问一个问题,优先多选并提供其他选项;只做技术问题,不问业务问题;严格执行YAGNI;核心接口代码示例每段不超过20行,且至少包含一个Go接口或结构体;TechSpec须以英文撰写并遵循规范模板。即使需求简单,也必须经历完整设计评审并至少产出一条ADR。用户批准技术方案后,不再强制二次审批各文档章节。若缺少PRD,可基于用户提供的上下文继续,并在执行摘要中说明。