SuperAPI AI 工具集

create-spec

通用与其它

查看项目

更新于 10-16 04:32

技能介绍

用途:create-spec 引导用户与 AI 进行协作式讨论,探索项目想法,然后把对话综合成一份完整规格文档,写入 .turbo/spec.md。

主要能力与流程: 第一步,捕捉愿景。先吸收用户提供的任意内容(一句话、一段话或一脑倾倒),不打断不提问,用两三句话复述确认理解;随后针对最大未知点提出 3-5 个重点问题,已答内容跳过。问题优先覆盖:解决什么问题、为谁解决;是全新项目还是已有代码/基础设施;有无强烈技术偏好或约束;MVP 与完整愿景的区别;有无硬性截止日期、预算或团队规模限制。 第二步,深入讨论。通过多轮对话探索项目,内部跟踪以下类别覆盖情况但不作刚性清单,顺应用户节奏自然展开:用户与角色、核心功能、架构(客户端/服务端划分、单体与微服务、实时需求、离线支持)、技术栈、数据模型、集成、非功能需求(性能、安全、无障碍、国际化、合规)、MVP 范围、待决问题。讨论准则:每次只问一两个问题;用户回答简短时继续追问;主动提供具体建议与权衡分析,做协作者而非采访者;用户说“你决定”时给出明确推荐并说明理由;所有类别有足够深度或用户表示准备好后,确认再进入起草。 第三步,起草规格。把整个讨论综合进 .turbo/spec.md,结构依项目自然生成:只写有实质内容的部分,不写占位填充;使用讨论中的具体细节;用户推迟的决定记入 Open Questions;被采纳的建议作为决策记录并附简要理由;结构随项目类型调整(CLI 工具与 SaaS 平台不同)。若 .turbo/ 目录不存在则创建,用户可指定其他输出路径。 第四步,评审与定稿。向用户展示草稿,提供三条路径:批准(规格定稿)、修订(用户指定要改的章节,修改后再展示)、继续讨论(回到第二步再探索后重新起草)。批准后规格位于 .turbo/spec.md,可运行 /create-prompt-plan 拆分为实现提示词。

规则:不得跳过第二步;规格是唯一输出,不创建代码、脚手架或其他项目文件;若项目极其简单(单文件脚本、简单配置),应说明并建议跳过规格流程。

限制:资料未提供安装方式、收费与平台等信息。