SuperAPI AI 工具集

cy-create-techspec

编程与开发

查看项目

更新于 10-15 20:27

技能介绍

用途:将 PRD 中的业务需求转化为可实施的技术规格说明(TechSpec),聚焦“如何实现”,而非业务目标本身。

主要能力:读取 .compozy/tasks/<name>/ 下的 _prd.md 与已有 ADR,探索代码库的架构模式、组件、依赖与技术栈;通过交互式提问澄清架构、数据模型、API、测试与性能;为关键技术决策创建 ADR;按 references/techspec-template.md 模板生成 TechSpec 并保存为 .compozy/tasks/<name>/_techspec.md。

使用方式:需提供功能名称以定位任务目录;可选提供已有 _prd.md 作为主要输入,或已有 _techspec.md 进入更新模式。流程为:收集上下文、逐条提问(每条消息仅一个问题,优先多选并含“其他”选项)、创建 ADR(写入 adrs/adr-NNN.md)、编写并保存 TechSpec。提问必须使用运行时的交互式提问工具;若无该工具,则把问题作为完整消息输出并停止生成。

限制与要求:每个 TechSpec 都必须经过完整设计评审,即使改动看似简单;必须至少创建一个 ADR,并在文末列出所有 ADR。核心接口部分至少包含一个 Go 接口或结构体代码块,示例不超过 20 行。开发排序需给出带依赖关系的编号构建顺序。执行 YAGNI,删除非必要组件。文档语言为英文。若缺少 PRD,则基于用户提供的上下文继续并在执行摘要中注明。完成后提示用户可用 cy-create-tasks 生成任务。