speckit-plan 用于执行实现规划工作流(implementation planning workflow),依据 plan 模板生成设计产物。执行前会检查项目根目录下的 .specify/extensions.yml,读取 hooks.before_plan 中的扩展钩子;可在 hooks 中标记 enabled: false 以禁用,未设置 enabled 视为启用。带有非空 condition 的钩子会被跳过,交由 HookExecutor 处理。钩子命令名中的点号会替换为连字符,例如 speckit.git.commit 变为 /speckit-git-commit。
主要流程:
- 在仓库根目录运行 .specify/scripts/bash/setup-plan.sh --json,解析 FEATURE_SPEC、IMPL_PLAN、SPECS_DIR、BRANCH。参数含单引号时用转义写法,如 'I'''m Groot'。
- 读取 FEATURE_SPEC 与 .specify/memory/constitution.md,加载已复制的 IMPL_PLAN 模板。
- 按模板填写 Technical Context(未知项标记为 NEEDS CLARIFICATION),填写 Constitution Check 并评估门禁,存在未说明的违规时报 ERROR。
- Phase 0:从 Technical Context 提取未知项,生成研究任务并整合到 research.md,格式为 Decision、Rationale、Alternatives considered。
- Phase 1:从特性规格提取实体,生成 data-model.md;如有外部接口,生成 contracts/;创建 quickstart.md,写明前置条件、setup 与运行命令及预期结果,不包含完整实现代码、迁移或完整测试套件。
- 在 CLAUDE.md 中 <!-- SPECKIT START --> 与 <!-- SPECKIT END --> 标记之间更新 plan 引用,指向生成的 IMPL_PLAN 路径。
执行后检查 hooks.after_plan,必需钩子需输出 EXECUTE_COMMAND 并实际调用,等待完成后继续。完成后报告分支、IMPL_PLAN 路径与生成的产物。命令在 Phase 2 规划后结束。文件系统操作使用绝对路径,文档与代理上下文引用使用项目相对路径。门禁失败或存在未解决的澄清项时报 ERROR。