SuperAPI AI 工具集

cmd-speckit-plan

编程与开发

查看项目

更新于 10-16 05:50

技能介绍

用途:在代码智能体会话中执行实现规划工作流,把功能规格转化为设计产物。命令会先考虑用户输入($ARGUMENTS),再按模板推进规划。

主要能力:执行前检查项目根目录的 .specify/extensions.yml,读取 hooks.before_plan 下的钩子;过滤 enabled 为 false 的条目,无 condition 的视为可执行,有非空 condition 的跳过并交由 HookExecutor 处理。可选钩子仅输出提示,强制钩子需实际调用并等待结果。随后从仓库根运行 {SCRIPT},解析 JSON 得到 FEATURE_SPEC、IMPL_PLAN、SPECS_DIR、BRANCH;读取 FEATURE_SPEC 与 /memory/constitution.md,加载 IMPL_PLAN 模板。

规划流程:填写 Technical Context(未知项标记 NEEDS CLARIFICATION);填写 Constitution Check 并评估门禁(违规未说明则报错);Phase 0 生成 research.md 解决所有待澄清项;Phase 1 生成 data-model.md、contracts/、quickstart.md,并运行 agent 脚本更新智能体上下文;设计后重新评估 Constitution Check。

使用方式:以命令形式在智能体会话中调用,参数含单引号时使用转义语法(如 'I'''m Groot')或改用双引号。命令在 Phase 2 规划后结束,报告分支、IMPL_PLAN 路径与生成的产物。

适用场景:需要把功能规格系统化拆解为研究、数据模型、接口契约和验证指南的软件项目规划阶段。

限制:纯内部项目(构建脚本、一次性工具等)可跳过 contracts;quickstart.md 只写可运行的验证场景,不包含完整实现代码、迁移或测试套件;门禁失败或存在未解决澄清项时报错。扩展钩子的具体命令与执行方式取决于所在智能体/会话环境,资料未提供具体脚本名称与安装命令。