Blueprint 计划生成器(blueprint-generate)
在问答阶段结束后,把 blueprint 收集到的上下文转化为一份可执行的实施计划,交给编码代理一次性完成。
证据显示该技能几乎只做读写规划文件:仅在 blueprint/<slug> 下 mkdir 和写 markdown,明确禁止在用户确认前修改其他文件,权限最小化、无外部网络调用、无敏感数据处理。扣分点:无回滚机制说明、无源归属验证(发布者未经注册表验证)、模板未匹配时的行为未定义。
六个步骤自洽,引用文件齐全,进度指示器与 slug 冲突处理(-2/-3)有明确规则,正常路径可复现。扣分点:模板名无法匹配时无失败反馈、Q&A 上下文缺失时的降级路径较薄、无测试或异常输入处理,静态审查下可靠路径未经执行验证。
README 清楚界定最佳场景(绿地项目、大型新特性)与不适用场景(视觉决策为主的前端、小重构),触发语义清晰(blueprint Q&A 后调用)。扣分点:技能本身假设存在前置 blueprint 会话,单独调用时边界描述不足;无中文支持说明(不影响功能)。
文档分层良好(SKILL.md 步骤 + references 细节),README 覆盖安装、工作流、模板扩展、限制;MIT 许可证明确,贡献者可追溯。扣分点:无版本号或变更日志、templates. 需在两个技能目录手工同步易产生漂移、维护责任与更新路径未声明。
核心任务(把 Q&A 综合为结构化 markdown 计划)输出格式明确、可直接交给编码代理,规避常见规划痛点。扣分点:静态审查无法验证输出质量,价值主张依赖 README 用户引言(非可审计证据),缺乏与替代方案(Claude plan mode 等)的实测对比。
技能文件本身是可审计的一手材料,模板与流程描述具体可查。扣分点:无 CI、无提交的测试覆盖该技能关键路径、用户引言不可独立验证,静态审查下无法复现结论。
- 本评估仅为静态源码审查,未执行任何代码,置信度低。
- 模板名无法匹配 templates. 时缺少失败反馈,可能静默产出错误结构。
- templates. 需在 blueprint 与 blueprint-generate 两个目录手工同步,存在漂移风险。
- 技能假设存在前置 blueprint Q&A 会话,单独调用时行为依赖代理对上下文的推断。
- README 中的用户引言为营销性陈述,不构成可验证的效果证据。
这个 Skill 能做什么,适合哪些场景?
blueprint-generate 是 imbue-ai/blueprint 仓库中的两个技能之一,属于规划副驾 Blueprint 的收尾环节。它在 blueprint 问答阶段完成后被调用,根据问答中确定的模板、精炼提示词和特性名称,生成一个带唯一 slug 的计划目录,并写出 markdown 计划文件(blueprint/<slug>/plan-<slug>.md)。计划写好后还支持在对话中继续多轮精炼。它是纯指令型技能,只依赖 shell 和文件系统,没有 Claude Code 专有扩展。
技能执行六个步骤:从问答对话中回忆模板名并读取 references/templates. 解析模板;生成 2-5 个词的 kebab-case slug(最长 50 字符,冲突时追加 -2、-3);用 mkdir -p 创建 blueprint/<slug> 目录;采用问答中最后精炼过的提示词(缺失时按 references/refine-prompt.md 现场生成);按 references/write-plan.md 写出计划文件,并在 Write 阶段每条消息末尾追加 ✓ Explore ✓ Plan ● Write ○ Refine 进度行;最后按 references/refinement.md 进入精炼阶段。
- 已在运行 blueprint 问答的开发者,收集了足够上下文后想立即产出实施计划
- 团队想为大型新功能留下一份可交给编码代理的 markdown 计划文档
- 使用多个代理工具(Claude Code、Codex CLI、Gemini CLI 等)的用户,需要一份与平台无关的计划文件
- 希望计划文件有唯一命名、不覆盖旧计划的开发者在迭代多个特性
- 喜欢在写完计划后继续追问"还有哪些开放问题"再逐轮精炼的用户
这个 Skill 有哪些优点和局限?
- 输出是通用 markdown 计划文件,任何编码代理都能直接消费
- 与 blueprint 问答技能协同,计划基于你亲自回答的设计决策而非代理的猜测
- 自动生成唯一 slug,避免覆盖已有计划目录
- 纯指令型技能,仅需 shell 和文件系统访问,无额外依赖
- 内置精炼阶段和进度指示,便于追踪 Explore/Plan/Write/Refine 状态
- 不能独立使用,必须先完成 blueprint 问答阶段
- 模板精炼需要同步编辑两个技能目录下的 templates.,手动维护容易失步
- 仓库未提供针对该技能本身的测试套件
- README 未说明在 Claude Code、Codex CLI、Gemini CLI 之外平台上的具体验证情况
如何安装这个 Skill?
整个技能集合通过 npx skills add imbue-ai/blueprint 安装;Claude Code 用户也可以 curl -fsSL https://raw.githubusercontent.com/imbue-ai/blueprint/main/install-skills.sh | bash,技能会被复制到 ~/.claude/skills/(或 $CLAUDE_CONFIG_DIR/skills)。该技能位于仓库的 skills/blueprint-generate/SKILL.md。
如何使用这个 Skill?
先运行 /blueprint <任务描述> 完成问答,收集足够上下文后运行 /blueprint-generate 结束问答并生成计划。计划写入 blueprint/<slug>/plan-<slug>.md。之后可在对话中让代理精炼计划,或问"what are the open questions?"来暴露遗漏,最后把计划文件交给你的编码代理执行。
这个 Skill 与同类方案有什么区别?
README 将 Blueprint 与 Claude Code 的 plan mode 和 Spec-kit、open-spec 等规格生成器对比:Claude Code plan mode 的问题是为解除代理阻塞而优化的简短提问,而 Blueprint 的问题是为了理解你;Spec-kit 等工具让代理先做决定再请你审阅长文档,Blueprint 则把你的输入放在最前面。