SuperAPI AI 工具集

quick-spec

编程与开发

查看项目

更新于 10-16 07:59

技能介绍

用途:将模糊需求转化为可直接开发的技术规格(tech-spec),产出满足“Ready for Development”标准:任务可执行、按依赖排序、验收标准可测试、内容完整无占位符、可自包含供新智能体直接实施。

主要能力:四步对话式工作流。步骤1分析需求增量,通过代码扫描提出针对性问题,捕获标题、问题、方案与范围,初始化 tech-spec-wip.md;步骤2映射技术约束,阅读相关代码文件,记录技术栈、模式与文件,查找 project-context.md;步骤3生成实施计划,拆解有序任务(含文件、动作、备注),以 Given/When/Then 编写验收标准,补充依赖、测试策略与风险;步骤4评审并定稿,将状态改为 ready-for-dev,重命名为 tech-spec-SLUG.md。

使用方式:由智能体按步骤文件顺序执行,采用微文件架构,仅加载当前步骤文件,禁止同时加载多个步骤文件,禁止跳步。每步完成后更新输出文件 frontmatter 的 stepsCompleted 数组,并在菜单处暂停等待用户选择。步骤1-2菜单含 [a] 深入引导、[c] 继续、[p] 专家模式;步骤4最终菜单含 [a] 深入引导、[r] 对抗性评审(推荐)、[b] 开始开发、[d] 完成、[p] 专家模式。输出默认保存至 project-root/.ai/tech-spec-SLUG.md。

适用场景:新增功能(如用户认证)、新增 API 端点(如导出 CSV)等需要先形成实施规格的开发任务。

限制:资料未提供具体安装命令、收费、价格、平台支持或效果数据;工作流依赖智能体严格按步骤文件执行,需用户在各检查点主动选择继续。