PRP（产品需求提示词）

一套用于 Claude Code 辅助开发的提示词集合。

视频教程

https://www.youtube.com/watch?v=KVOZ9s1S9Gk&lc=UgzfwxvFjo6pKEyPo1R4AaABAg

支持本项目

觉得这些资源很有价值吗？

请我喝杯咖啡： https://coff.ee/wirasm

我花费了大量时间来创建这些资源和提示词。如果您认为这个项目有价值，请考虑请我喝杯咖啡，以支持我的工作。

---

用 AI 工程工作坊提升您的团队

您准备好从玩具级演示迈向生产就绪的 AI 系统了吗？

预订工作坊： https://www.rasmuswiding.com/

您将获得：

• 帮助您的团队成为 AI 高效使用者
• 学习顶尖工程团队使用的精确 PRP 方法论
• 使用 Claude Code、PRP 和真实代码库进行实战培训
• 面向团队和个人的从入门到高级的 AI 工程工作坊

适合人群： 希望在生产环境中真正落地 AI 的工程团队、产品团队及开发者

请直接联系我：hello@rasmuswiding.com

---

什么是 PRP？

产品需求提示词 (PRP) = PRD + 精选代码库情报 + 代理/运行手册

这是 AI 在首次尝试时即可交付生产就绪代码所需的最小可行包。

PRP 为 AI 编码代理提供其完成一个功能模块所需的一切——不多也不少。

PRP 与传统 PRD 的区别

传统 PRD 明确说明产品必须实现的功能以及客户的需求理由，但刻意避免描述具体的实现方式。

而 PRP 则保留了 PRD 中的目标和理由部分，同时增加了对 AI 至关重要的内容：

• 上下文：精确的文件路径、库版本、代码片段示例
• 模式：现有代码库中应遵循的规范
• 验证：AI 可执行的验证命令，以确认其工作成果

---

快速开始

选项 1：将命令复制到您的项目中

# 从您的项目根目录
cp -r /path/to/PRPs-agentic-eng/.claude/commands/prp-core .claude/commands/

选项 2：克隆仓库

git clone https://github.com/Wirasm/PRPs-agentic-eng.git
cd PRPs-agentic-eng

---

命令

.claude/commands/prp-core/ 目录包含核心 PRP 工作流命令：

核心工作流

命令	描述
/prp-prd	带实施阶段的交互式 PRD 生成器
/prp-plan	创建实施计划（基于 PRD 或自由文本输入）
/prp-implement	执行带有验证循环的计划

问题与调试工作流

命令	描述
/prp-issue-investigate	分析 GitHub 问题，创建实施计划
/prp-issue-fix	根据调查结果执行修复
/prp-debug	使用“5 个为什么”方法进行深度根因分析

Git 与代码评审

命令	描述
/prp-commit	基于自然语言的智能提交，可指定文件范围
/prp-pr	创建带有模板支持的拉取请求
/prp-review	全面的拉取请求代码评审

自主循环

命令	描述
/prp-ralph	启动自主循环，直至所有验证通过
/prp-ralph-cancel	取消当前的 Ralph 循环

---

Ralph 循环（自主执行）

基于 Geoffrey Huntley 的 Ralph Wiggum 技术——一种自我参照的循环机制，会不断迭代直到任务真正完成。

工作原理

/prp-ralph .claude/PRPs/plans/my-feature.plan.md --max-iterations 20

1. Claude 按照计划执行任务
2. 运行所有验证命令（类型检查、代码风格检查、测试、构建）
3. 若有任何验证失败 → 修复并重新验证
4. 循环持续进行，直到所有验证全部通过
5. 输出 <promise>COMPLETE</promise> 并退出

每次迭代，Claude 都能查看之前的工作成果，包括文件和 Git 历史记录。它并不是从头开始，而是不断调试自身。

设置

停止钩子必须在 .claude/settings.local.json 中配置：

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/prp-ralph-stop.sh"
          }
        ]
      }
    ]
  }
}

使用

# 创建计划
/prp-plan "添加 JWT 用户认证"

# 启动 Ralph 循环
/prp-ralph .claude/PRPs/plans/add-user-auth.plan.md --max-iterations 20

# 如需取消
/prp-ralph-cancel

小贴士

• 始终使用 --max-iterations 参数（默认值为 20），以防止无限循环
• 最适用于具有清晰且可测试验证命令的计划
• 当前状态记录在 .claude/prp-ralph.state.md 文件中
• 实施过程中的进展和经验总结会保存在实施报告中

---

工作流概览

大型功能：PRD → 计划 → 实施

/prp-prd "用户认证系统"
    ↓
生成包含实施阶段表的 PRD
    ↓
/prp-plan .claude/PRPs/prds/user-auth.prd.md
    ↓
自动选择下一个待处理阶段，创建计划
    ↓
/prp-implement .claude/PRPs/plans/user-auth-phase-1.plan.md
    ↓
执行计划，更新 PRD 进度，并归档该计划
    ↓
重复 /prp-plan 以处理下一阶段

中型功能：直接进入计划

/prp-plan "为 API 添加分页功能"
    ↓
根据描述创建实施计划
    ↓
/prp-implement .claude/PRPs/plans/add-pagination.plan.md

Bug 修复：问题工作流

/prp-issue-investigate 123
    ↓
分析问题，创建调查文档
    ↓
/prp-issue-fix 123
    ↓
实施修复，并创建拉取请求

---

文档结构

所有文档都存储在 .claude/PRPs/ 目录下：

.claude/PRPs/
├── prds/              # 产品需求文档
├── plans/             # 实施计划
│   └── completed/     # 已归档的已完成计划
├── reports/           # 实施报告
├── issues/            # 问题调查文档
│   └── completed/     # 已归档的已完成调查
└── reviews/           # 拉取请求评审报告

---

PRD 阶段

PRD 包含一个实施阶段表，用于跟踪进度：

| #   | 阶段 | 描述 | 状态      | 并行 | 依赖 | PRP 计划 |
| --- | ----- | ----------- | ----------- | -------- | ------- | -------- |
| 1   | 认证  | 用户登录  | 已完成    | -        | -       | [链接]   |
| 2   | API   | API 端点   | 进行中     | -        | 1       | [链接]   |
| 3   | UI    | 前端界面   | 待处理     | 与 4 并行 | 2       | -        |
| 4   | 测试  | 测试套件   | 待处理     | 与 3 并行 | 2       | -        |

• 状态：待处理 → 进行中 → 已完成
• 并行：可以同时进行的阶段（在不同的工作树中）
• 依赖：必须先完成的阶段

---

PRP 最佳实践

1. 上下文为王：包含所有必要的文档、示例和注意事项。
2. 验证循环：提供 AI 可以运行并修复的可执行测试或代码检查。
3. 信息密集：使用代码库中的关键字和模式。
4. 范围限定：每个计划应能在一次循环内由 AI 完成。

---

项目结构

your-project/
├── .claude/
│   ├── commands/prp-core/   # PRP 命令
│   ├── PRPs/                # 生成的产物
│   └── agents/              # 自定义子代理
├── PRPs/
│   ├── templates/           # PRP 模板
│   └── ai_docs/             # 库文档
├── CLAUDE.md                # 项目特定指南
└── src/                     # 您的源代码

---

使用工作树的并行开发

当 PRD 阶段可以并行执行时：

# 阶段 3 和 4 可以同时进行
git worktree add -b phase-3-ui ../project-phase-3
git worktree add -b phase-4-tests ../project-phase-4

# 在每个工作树中运行 Claude
cd ../project-phase-3 && claude
cd ../project-phase-4 && claude

---

资源

模板（PRPs/templates/）

• prp_base.md - 全面的 PRP 模板
• prp_story_task.md - 故事/任务模板
• prp_planning.md - 计划模板

AI 文档（PRPs/ai_docs/）

为 Claude Code 上下文注入整理的文档。

旧版命令

旧版本的命令保留在 old-prp-commands/ 中，供参考。

---

许可证

MIT 许可证

---

支持

我花费了大量时间创建这些资源和提示。如果您觉得这个项目有价值，请考虑请我喝杯咖啡，以支持我的工作。

请我喝杯咖啡： https://coff.ee/wirasm

---

目标是通过全面的上下文实现一次通过的顺利实施。

PRPs-agentic-eng 快速上手指南

PRPs-agentic-eng 是一套专为 Claude Code 设计的提示词集合与工作流工具，旨在通过“产品需求提示词（PRP）”方法论，帮助 AI 一次性生成可投入生产环境的代码。它将传统的产品需求文档（PRD）与代码库上下文、验证指令相结合，为 AI 代理提供执行任务所需的最小完备信息包。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux, macOS 或 Windows (WSL2 推荐)。
• 核心依赖：已安装并配置好 Claude Code (claude) 命令行工具。
• 版本控制：已安装 Git。
• 项目环境：拥有一个初始化的 Git 项目目录。

注意：本工具深度集成于 Claude Code 的 .claude 配置体系中，请确保您熟悉 Claude Code 的基本操作。目前暂无官方国内镜像源，若克隆仓库速度较慢，可使用国内 Git 加速服务或手动下载源码包解压。

安装步骤

您可以选择以下两种方式之一将工具集成到您的项目中。

方式一：直接复制命令（推荐用于现有项目）

如果您已经在进行项目开发，只需将核心命令文件夹复制到项目的 .claude/commands/ 目录下：

# 在项目根目录执行
# 请将 /path/to/PRPs-agentic-eng 替换为实际下载或克隆的路径
cp -r /path/to/PRPs-agentic-eng/.claude/commands/prp-core .claude/commands/

方式二：克隆完整仓库

如果您想浏览所有模板、文档示例或从头开始：

git clone https://github.com/Wirasm/PRPs-agentic-eng.git
cd PRPs-agentic-eng

# 随后将 .claude 目录内容合并到您自己的项目中
# 或者直接在该仓库内进行实验

配置 Ralph 自动循环钩子（可选但推荐）

若需使用全自动修复循环功能（Ralph Loop），需在项目根目录创建或编辑 .claude/settings.local.json，添加停止钩子配置：

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/prp-ralph-stop.sh"
          }
        ]
      }
    ]
  }
}

注：确保 .claude/hooks/prp-ralph-stop.sh 文件存在且具有执行权限。

基本使用

PRP 工作流的核心在于将大任务拆解为 PRD (需求) -> Plan (计划) -> Implement (执行) 的过程。

1. 大型功能开发流程

适用于需要明确阶段和依赖关系的复杂功能。

第一步：生成交互式 PRD 输入功能描述，AI 将生成包含实施阶段表的需求文档。

/prp-prd "用户认证系统，包含 JWT 登录和注册"

输出位置：.claude/PRPs/prds/

第二步：创建实施计划 基于生成的 PRD，AI 会自动选择下一个待处理的阶段并创建详细计划。

/prp-plan .claude/PRPs/prds/user-auth.prd.md

输出位置：.claude/PRPs/plans/

第三步：执行计划 AI 将根据计划编写代码，并运行验证命令（如测试、Lint）确保通过。

/prp-implement .claude/PRPs/plans/user-auth-phase-1.plan.md

2. 中小型功能或快速迭代

对于范围明确的功能，可直接跳过 PRD 阶段。

# 直接创建计划
/prp-plan "为 API 端点添加分页功能"

# 执行计划
/prp-implement .claude/PRPs/plans/add-pagination.plan.md

3. 自主循环模式 (Ralph Loop)

这是最强大的功能之一。AI 会不断尝试实现任务、运行验证、修复错误，直到所有检查通过或达到最大迭代次数。

# 启动自主循环，最大尝试 20 次
/prp-ralph .claude/PRPs/plans/my-feature.plan.md --max-iterations 20

# 如需紧急停止
/prp-ralph-cancel

4. Bug 修复工作流

针对现有的 GitHub Issue 进行分析和修复。

# 分析 Issue #123 并生成调查报告
/prp-issue-investigate 123

# 根据调查结果执行修复并创建 PR
/prp-issue-fix 123

关键提示

• 上下文为王：在使用 /prp-plan 或 /prp-implement 时，确保您的代码库中有清晰的 CLAUDE.md 或相关文档，以便 AI 理解现有架构。
• 验证指令：在计划中提供可执行的验证命令（如 npm test, go build）是保证 AI 产出高质量代码的关键。
• 产物管理：所有生成的文档、计划和报告均保存在 .claude/PRPs/ 目录下，便于追溯和审计。