用途:将 PRD 中的业务需求翻译为详细技术规格说明(TechSpec),聚焦“如何实现”,并作为后续 cy-create-tasks 的输入。\n\n主要能力:读取 .compozy/tasks/<name>/_prd.md 与既有 ADR;探索代码库的架构模式、组件、依赖与技术栈;一次一个地提出 3-6 个技术澄清问题(偏好多选题并带兜底选项),覆盖架构与组件边界、数据模型与存储、API 与集成点、测试策略与性能;为重大技术决策创建 ADR(写入 adrs/adr-NNN.md,零填充 3 位序号,状态 Accepted,日期为当天);按 references/techspec-template.md 生成草稿并迭代评审;保存到 .compozy/tasks/<name>/_techspec.md。\n\n必要用法:需提供功能名称以定位目录;可选 _prd.md 作为主要输入,可选 _techspec.md 进入更新模式。必须按清单顺序执行各阶段,每个阶段建任务并依序完成。提问必须使用运行时的交互式提问工具,若没有则把问题作为完整消息输出并停止生成,不得自行作答或继续。写文件前必须获得用户对技术方案的批准;草稿可整体呈现后迭代,但批准后不得再对架构、数据模型、API 等再强制二次审批。\n\n限制与约束:最终 TechSpec 必须以 Architecture Decision Records 章节结尾,列出本次创建的全部 ADR(编号、标题、一行摘要),至少一条 ADR;Core Interfaces 至少包含一个 Go 接口或结构体代码块,示例限 20 行;Development Sequencing 需含带依赖关系的编号 Build Order;贯彻 YAGNI;每个 PRD 目标与用户故事应映射到技术组件;Executive Summary 必须说明所选方案的主要技术权衡;内容用英文撰写。缺失 PRD 时可基于用户上下文继续并在 Executive Summary 注明。未提供的具体模板内容、运行时工具名称等细节暂未提供。
cy-create-techspec
编程与开发
更新于 10-15 20:27