开发与工程 implementation-planningcoding-agentsmarkdown-plansqa-workflowtemplatescodex-cligemini-cli

Blueprint 计划生成器(blueprint-generate)

在问答阶段结束后,把 blueprint 收集到的上下文转化为一份可执行的实施计划,交给编码代理一次性完成。

FollowSkills 评估 · FSRS-2.0
谨慎使用
52/ 100 五分制 2.6 / 5
1 2 3 4 5 6
1信任安全16 / 25 · 3.2/5

证据显示该技能几乎只做读写规划文件:仅在 blueprint/<slug> 下 mkdir 和写 markdown,明确禁止在用户确认前修改其他文件,权限最小化、无外部网络调用、无敏感数据处理。扣分点:无回滚机制说明、无源归属验证(发布者未经注册表验证)、模板未匹配时的行为未定义。

2可靠稳定9 / 20 · 2.3/5

六个步骤自洽,引用文件齐全,进度指示器与 slug 冲突处理(-2/-3)有明确规则,正常路径可复现。扣分点:模板名无法匹配时无失败反馈、Q&A 上下文缺失时的降级路径较薄、无测试或异常输入处理,静态审查下可靠路径未经执行验证。

3适用触发9 / 15 · 3.0/5

README 清楚界定最佳场景(绿地项目、大型新特性)与不适用场景(视觉决策为主的前端、小重构),触发语义清晰(blueprint Q&A 后调用)。扣分点:技能本身假设存在前置 blueprint 会话,单独调用时边界描述不足;无中文支持说明(不影响功能)。

4规范维护9 / 15 · 3.0/5

文档分层良好(SKILL.md 步骤 + references 细节),README 覆盖安装、工作流、模板扩展、限制;MIT 许可证明确,贡献者可追溯。扣分点:无版本号或变更日志、templates. 需在两个技能目录手工同步易产生漂移、维护责任与更新路径未声明。

5有效结果6 / 15 · 2.0/5

核心任务(把 Q&A 综合为结构化 markdown 计划)输出格式明确、可直接交给编码代理,规避常见规划痛点。扣分点:静态审查无法验证输出质量,价值主张依赖 README 用户引言(非可审计证据),缺乏与替代方案(Claude plan mode 等)的实测对比。

6证据核验3 / 10 · 1.5/5

技能文件本身是可审计的一手材料,模板与流程描述具体可查。扣分点:无 CI、无提交的测试覆盖该技能关键路径、用户引言不可独立验证,静态审查下无法复现结论。

证据充分度: 评估于 2026年9月10日 审查版本 fb06284691c2
使用前请注意
  • 本评估仅为静态源码审查,未执行任何代码,置信度低。
  • 模板名无法匹配 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 进入精炼阶段。

  1. 已在运行 blueprint 问答的开发者,收集了足够上下文后想立即产出实施计划
  2. 团队想为大型新功能留下一份可交给编码代理的 markdown 计划文档
  3. 使用多个代理工具(Claude Code、Codex CLI、Gemini CLI 等)的用户,需要一份与平台无关的计划文件
  4. 希望计划文件有唯一命名、不覆盖旧计划的开发者在迭代多个特性
  5. 喜欢在写完计划后继续追问"还有哪些开放问题"再逐轮精炼的用户

这个 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 则把你的输入放在最前面。

常见问题

可以跳过 blueprint 问答直接用 blueprint-generate 吗?
不建议。该技能的设计前提是问答阶段已经收集了模板名和精炼过的提示词;缺失时它会现场生成,但计划质量将失去问答上下文的支持。
生成的计划文件在哪里、会不会覆盖旧计划?
计划写入 blueprint/<slug>/plan-<slug>.md;如果 blueprint/<slug> 已存在,slug 会自动追加 -2、-3 等后缀避免覆盖。
需要什么运行环境或权限?
需要一个兼容的代理框架(Claude Code、Codex CLI、Gemini CLI、Pi agent 等)、代理可读的工作区,以及 shell 和文件系统访问权限(用于 mkdir 和写文件);不需要网络或 MCP 服务器。
如何自定义计划的结构?
可以在被提示时内联描述自定义模板,或持久化地编辑 blueprint-generate/references/templates.(并同步编辑 blueprint/references/templates. 以保持两个技能一致),每个条目包含 name、description 和 prompt 字段。

同仓库的其他 Skills

均来自 imbue-ai/blueprint

相关 Skills