用途:当功能规格(spec.md)已就绪、需要技术实现计划时使用本技能。输入为 specs/<feature>/spec.md、仓库上下文与 .specify/ 模板,以及用户提供的约束或技术偏好(如有)。若缺少规格,应先让用户运行 speckit-specify。
主要能力与工作流:
- 在仓库根目录运行 .specify/scripts/bash/setup-plan.sh --json,解析出 FEATURE_SPEC、IMPL_PLAN、SPECS_DIR、BRANCH。参数含单引号时用转义写法。
- 读取 FEATURE_SPEC 与 .specify/memory/constitution.md,加载已复制的 IMPL_PLAN 模板。
- 按模板结构执行:填写 Technical Context(未知项标记为 NEEDS CLARIFICATION)、填写 Constitution Check、评估门禁(无正当理由的违规记为 ERROR)。
- Phase 0 研究:把每个 NEEDS CLARIFICATION 转为研究任务,每个依赖转为最佳实践任务,每个集成为模式任务,并在 research.md 中按“Decision / Rationale / Alternatives considered”汇总,解决全部待澄清项。
- Phase 1 设计:从规格提取实体写入 data-model.md(字段、关系、校验规则、状态转换);依据功能需求生成 API 契约(REST/GraphQL,输出到 /contracts/,如 OpenAPI/GraphQL schema);运行 .specify/scripts/bash/update-agent-context.sh <agent_type> 更新对应智能体上下文文件,仅添加新引入的技术,保留标记之间的手动内容。最后重新评估 Constitution Check,停止并报告分支、IMPL_PLAN 路径与产物。
输出:plan.md、research.md、data-model.md、contracts/、quickstart.md 及更新后的智能体上下文文件。后续可用 speckit-tasks 生成任务,需要质量门禁时用 speckit-checklist 创建检查清单。
限制:使用绝对路径;门禁失败或存在未解决的澄清项时报 ERROR;须先具备 spec.md;具体支持的技术栈与智能体类型取决于仓库模板,资料未提供更多细节。