SuperAPI AI 工具集

spec-driven-planning

通用与其它

查看项目

更新于 10-16 02:30

技能介绍

用途:引导新功能规划,自动选择 Quick 或 Full 模式。Quick 模式输出单文件 docx/features/[NN-name]/plan.md,含小步任务,无 EARS、无 RGR,适合个人、≤3 天、无合规或交接需求;Full 模式输出 requirements.md(EARS)、design.md、tasks.md 三文件,含三道审批门与下游 TDD 强制,适合团队、多周、合规审计或干系人评审。

主要能力:先做模式选择,满足全部 Quick 条件(≤3 天或 ≤8 任务、个人、无合规、无重大架构决策、需求清晰、无跨团队交接)自动选 Quick;任一 Full 条件(>1 周或 >15 任务、非工程干系人审批、合规追溯、长期架构决策、需求模糊、多人协作)自动选 Full;中间地带视为模糊,向用户询问一次,默认 Quick。Quick 流程:创建功能目录、读取模板、填写 plan.md(目标、架构、技术栈、范围外、2-5 分钟粒度的任务,含精确文件路径、完整代码、验证命令与提交步骤),一道审批门。Full 流程三阶段三审批门:阶段一创建目录与占位文件;阶段二用 EARS 五类模板(Ubiquitous、Event-Driven、State-Driven、Conditional、Optional)定义需求,先做范围分解检查,禁止占位符,分配 REQ-### 编号并记录追溯;阶段三技术设计,比较 2-3 种架构方案、给出推荐与理由,覆盖组件、数据流、API 契约、错误处理、安全、性能、测试策略。

使用方式:用户说“创建新功能”“规划功能”“需要构建 X”,或提及需求、规格、架构、技术设计,或使用 /dev-workflow:spec 命令时激活。Quick 完成后运行 /dev-workflow:spec execute;Full 完成后运行 /dev-workflow:spec tasks 再 execute。支持 Quick 升级到 Full(重命名 plan.md 为 plan.archived.md,从阶段二或三继续),不支持 Full 降级。

限制:模式阈值刻意留有空档,4-7 天、9-15 任务或部分信号匹配属模糊区,需询问用户。需求与下游计划不得含 TBD、模糊动词、未定义引用等占位内容。具体模板内容、命令行为与集成细节以官方资料为准,其余暂未提供。