用途:speckit-plan 用于在功能规格确定后执行实现规划工作流,按 plan 模板产出设计产物,为后续任务拆解与实现做准备。
主要能力:先运行 .specify/scripts/bash/setup-plan.sh --json 并解析 FEATURE_SPEC、IMPL_PLAN、FEATURE_DIR、BRANCH;读取功能规格与 .specify/memory/constitution.md,填充技术上下文与章程检查,评估门禁。Phase 0 生成 research.md,逐条解决 NEEDS CLARIFICATION;Phase 1 生成 data-model.md、contracts/ 与 quickstart.md,并在设计后重新评估章程检查。
扩展钩子:若项目根存在 .specify/extensions.yml,会读取 hooks.before_plan 与 hooks.after_plan。enabled 为 false 的钩子被过滤;无 condition 的视为可执行,有非空 condition 的跳过并交由 HookExecutor 处理。命令名中的点替换为连字符,如 speckit.git.commit 变为 /speckit-git-commit。强制钩子需实际执行并等待结果,可选钩子仅提示执行方式。YAML 无法解析时需告知用户并继续。
限制:命令在 Phase 1 设计后结束,需报告分支、IMPL_PLAN 路径与生成产物;门禁失败或澄清未解决时报错。quickstart.md 只写可运行的验证场景,不包含完整实现代码、迁移或测试套件。文件系统操作使用绝对路径,文档引用使用项目相对路径。其他细节暂未提供。