blueprint-prp-create

/blueprint:prp-create

创建一份全面的 PRP（产品需求提示词）——一套独立完整的资料包，包含 AI Agent 首次交付生产级代码所需的所有上下文。

什么是 PRP？ PRD + 精选代码库情报 + 实施蓝图 + 验证关卡 = 实现可靠开发所需的一切。

用法：/blueprint:prp-create [feature-name]

前置条件：

• 已初始化 Blueprint Development（存在 docs/blueprint/）
• 清楚了解要实现的功能

何时使用此技能

在以下情况下使用此技能……	在以下情况下使用替代方案……
创建新的功能实施资料包	执行现有 PRP（使用 /blueprint:prp-execute）
需要全面的研究和文档	无正式需求时快速制作原型
计划由 AI Agent 或子 Agent 执行	独立开发者无需研究即可实施
需要记录实施方案	根据现有代码库模式进行实施

上下文

• Blueprint 已初始化： !find . -path '*/docs/blueprint/*' -maxdepth 3 -name 'manifest.json' -type f
• 上一个 PRP ID： !find . -path '*/docs/blueprint/manifest.json' -maxdepth 3 -exec jq -r '.id_registry.last_prp // 0' {} +
• 可用的精选规则： !find . -maxdepth 3 -path '*/.claude/rules/*' -type f -name "*.md"
• 现有 PRD： !find . -path '*/docs/prds/*' -name "*.md" -type f

参数

解析 $ARGUMENTS：

• feature-name（必填）：PRP 的 kebab-case 名称（例如：auth-oauth2、api-rate-limiting）
  • 用于生成文件名和文档 ID

执行

执行完整的 PRP 创建工作流：

步骤 1：验证前置条件并了解需求

1. 如果尚未初始化 Blueprint → 错误：“请先运行 /blueprint:init”
2. 请用户描述功能：“需要实现什么功能？”
   • 记录：目标、重要性、成功标准
3. 询问该功能是否对应现有 PRD：“这是在实现现有 PRD，还是独立功能？”
   • 如果选择 PRD → 保存 PRD ID 以便建立链接
4. 确定功能类型（API 端点、数据库、UI、集成等）

步骤 2：研究代码库模式

使用 Explore Agent 查找现有模式：

1. 已实现的类似功能（确定应遵循的现有模式）
2. 相关文件位置和集成点
3. 类似功能采用的测试模式
4. 影响此功能的架构决策

记录研究结果，并注明具体文件路径和行号。

步骤 3：研究外部文档

对于相关库/框架，收集：

1. 官方文档章节（记录具体章节的 URL）
2. Stack Overflow / GitHub 讨论中的已知问题和注意事项
3. 文档中的最佳实践
4. 常见实施模式

按需使用 WebSearch/WebFetch。如有需要，创建或更新精选规则条目（参见 REFERENCE.md）。

步骤 4：生成 PRP 文档 ID 和结构

根据 manifest 生成下一个 PRP ID：

• 从 manifest.json 中提取 id_registry.last_prp
• 下一个 ID = last_prp + 1（格式：PRP-NNN）

创建 docs/prps/[feature-name].md，并添加 frontmatter 和各章节（参见 REFERENCE.md）。

第 5 步：根据研究结果起草 PRP 内容

填写所有必需章节（参见 REFERENCE.md）：

1. 目标与原因：一句话说明目标、业务理由、目标用户和优先级
2. 成功标准：具体、可测试且包含指标的验收标准
3. 上下文：
   • 文档参考（包含具体章节的 URL）
   • 精选规则参考（指向 .claude/rules/ 库／模式条目的链接）
   • 代码库情报：文件路径、带行号的代码片段、需要遵循的模式
   • 已知注意事项：关键警告及缓解措施
4. 实施蓝图：
   • 架构决策及其理由
   • 任务拆解（必需／延后／锦上添花类别）
   • 实施顺序
5. TDD 要求：测试策略和关键测试用例
6. 验证关卡：可执行命令（lint、类型检查、测试、覆盖率）

关键：所有任务都必须明确分类（参见 REFERENCE.md）。

第 6 步：从多个维度评估置信度

为每个维度打分，范围为 1–10：

维度	标准
上下文完整度	是否明确列出所有文件路径、代码片段和参考资料？
实施清晰度	伪代码是否足够清晰，便于 AI 遵循？
注意事项文档化程度	是否记录了所有已知问题及其缓解措施？
验证覆盖度	是否为所有验证关卡提供了可执行命令？

将各维度分数的平均值作为总体分数。目标：执行需达到 7 分以上，委派给子 Agent 需达到 9 分以上。

如果分数 < 7 → 返回第 2–3 步补充缺失内容。

第 7 步：审查并验证完整性

检查清单（参见 REFERENCE.md）：

• 目标清晰且具体
• 成功标准可测试
• 所有文件路径都明确（而非“某处……”）
• 代码片段展示了带行号引用的实际模式
• 注意事项包含缓解措施
• 验证命令可直接复制粘贴
• 置信度评分诚实可靠

在 docs/blueprint/manifest.json ID 注册表中添加新的 PRP 条目。

第 8 步：报告 PRP 并询问下一步操作

显示摘要，包含：

• PRP ID 和位置
• 功能摘要和实现方法
• 已收集的上下文（精选规则、模式、文档）
• 关联文档（如适用，包含源 PRD）
• 置信度分数及各维度评分
• 如果分数 < 7，列出所有缺口

如果置信度 >= 7，提供以下选项：

• 立即执行 PRP → /blueprint:prp-execute [feature-name]
• 为子 Agent 创建工作单 → /blueprint:work-order
• 审查并完善 → 显示文件位置和缺口
• 暂时完成 → 退出（保存以供稍后执行）

如果置信度 < 7，提供以下选项：

• 进一步研究上下文 → 使用 Explore Agent 查找缺口
• 创建精选规则条目 → /blueprint:curate-docs
• 仍然执行（有风险）→ 在警告后继续
• 暂时完成 → 保存未完成的 PRP

Agent 优化

上下文	命令
检查蓝图是否已初始化	test -f docs/blueprint/manifest.json && echo "YES" || echo "NO"
下一个 PRP ID	jq -r '.id_registry.last_prp // 0' docs/blueprint/manifest.json | awk '{print $1+1}'
列出现有 PRP	ls -1 docs/prps/ 2>/dev/null | wc -l
搜索模式	使用 Explore Agent，而非手动 grep
快速研究	使用现有精选规则，而不是再次获取文档

---

有关 PRP 文档结构、任务分类、审查清单和精选规则创建指南，请参阅 REFERENCE.md。