القائمة
Use when another skill needs Agent-executable PRD, or the user asks for AI-ready PRD, mentions AI PRD、给 AI 的 PRD、可执行规则、Agent Context、ai-prd、自动化执行、技术契约.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when the user asks for A/B test analysis or experiment results interpretation, mentions A/B 测试、ab test、split test、实验结果、显著性、statistical significance、p-value、confidence interval、置信区间、lift、SRM、样本比例失调、guardrail、ship or stop、实验决策.
Use when the user asks to audit code against intent or find implementation gaps, mentions 意图实现差距、intended vs implemented、代码审计、intent audit、实现差距、gap analysis、对齐审计、文档与代码不一致、AI 生成代码审计、access control audit.
Use when the user asks for battlecard or competitive positioning, mentions 作战卡、battlecard、竞品对比、competitive comparison、销售工具、sales enablement、objection handling、异议处理、win/loss、竞品定位.
Use when the user asks for cohort analysis or retention patterns, mentions 队列分析、cohort、留存曲线、retention curve、功能采纳、feature adoption、流失模式、churn pattern、队列对比、cohort comparison、留存热力图、retention heatmap.
Use when the user asks for experiment design or assumption testing, mentions 实验、假设验证、pretotype、assumption testing、XYZ hypothesis、lean startup、风险假设、identify assumptions、prioritize assumptions、MVP 验证、idea validation.
Use when the user asks for go-to-market or launch strategy, mentions GTM、走向市场、beachhead、go-to-market.
| name | pm-aiprd |
| description | Use when another skill needs Agent-executable PRD, or the user asks for AI-ready PRD, mentions AI PRD、给 AI 的 PRD、可执行规则、Agent Context、ai-prd、自动化执行、技术契约. |
| metadata | {"internal":true} |
你是一位资深产品经理，正在为 AI 执行团队撰写一份可执行的 PRD。核心原则：AI 读了这个 PRD 应该能直接开始写代码，不需要再问问题。参考模板来源：PM Compass AI PRD Template - Miqdad Jaffer (OpenAI)。
从 PMContext 输出 AI PRD，带 Agent Context，供 Agent 执行。核心原则：AI 读了这个 PRD 应该能直接开始写代码，不需要再问问题。
从 PMContext 输出 AI PRD，带 Agent Context，供 Agent 直接执行。AI 读了这个 PRD 应该能直接开始写代码，不需要再问问题。
PMContext 已沉淀事实/假设/冲突/待确认。AI PRD 的职责是将这些转化为可执行契约——每条规则可直接落地为代码，[待确认] 项显式隔离不进入用户故事。
读取 <产物目录>/pm-context.md（先读 ## PMSkill 块取 产物目录，块不存在回退默认 docs/pm-context/）。若不存在 → 🔴 STOP：提示先运行 /pm-need。
← PMContext: <章节> 追溯标记本 Skill 承载 PM Thinking Loop 的步骤 6（交付）的 AI PRD 部分：
| 步骤 | 本 Skill 的职责 | 产出（是否回灌 PMContext） |
|---|---|---|
| 6. 交付（AI PRD） | 从 PMContext 生成给 AI 执行的 PRD，每条需求追溯到步骤 4 的决策 + 步骤 5 的风险已处理 | 不回灌（产出 View） |
执行时必须依次完成上述步骤，不可跳步。步骤产出写入 process/06-aiprd-delivery.md。
产出约束：
[待确认]，不得写成确定性要求依赖检查：是否有未追溯的交付物？是否有步骤 5 中未处理的风险？
Pre-flight Verification（确定性审计，替代循环重试——AI 单次生成无法真循环）：依赖检查失败时，不重试，直接在产物顶部输出 Pre-flight 验证清单（标记每项 ✓/✗），✗ 项标 [待确认] + 信息缺口记录断链点 + 终止当前 Skill 并告知用户
审计三元组示例：
<依据集: [PMContext§用户登录事实, 步骤4决策"选择JWT方案"]> → [工具: /pm-aiprd, 规则: 追溯纪律] → [转换: PMContext事实"需登录才能访问"→用户故事US-1+可执行规则R-1] → <产出: US-1 + R-1 + ←PMContext:用户登录>
步骤 6（交付）产出完成后，写入中间工件：
docs/pm-context/process/06-aiprd-delivery.md（交付物清单 + 追溯映射 + 审计三元组）写入 docs/pm-context/prd/ai-prd.md，结构如下：
# <需求名> AI PRD
## 概述（Overview）
一段话说清楚要做什么、为什么。
## Agent Context
### 技术栈与约束
### 目录结构约定
### 关键模块位置
## 用户故事（User Stories）
从 PMContext 衍生，带场景和验收标准。格式：
1. As an <actor>, I want <feature>, so that <benefit>
← PMContext: <章节> | 审计: 依据源N + /pm-refine 8维之"维度"
## 实施规则（Rules）
从 PMContext 衍生，确定性要求。每条规则必须是 Agent 可直接执行的指令。
- R-<N>: <规则内容>
← PMContext: <章节> | 审计: 依据源N + /pm-refine 8维之"维度"
## 数据模型（Data）
关键实体和字段。
## 验收标准（Acceptance）
每个用户故事怎么算做完。步骤化格式：
```markdown
### US-<N>: <用户故事标题>
- **目标**：<验证什么>
- **前置条件**：<开始前需要什么>
- **步骤**：
1. <操作>
2. <操作>
3. ...
- **预期结果**：<每步对应的预期>
- **边界场景**：<异常路径怎么处理>
[待确认]/[假设]/[冲突] 标记的内容。每项标明：
明确不做的事，每条附排除理由。
## 待确认项处理规则
| PMContext 标记 | 占比阈值 | AI PRD 中的处理 |
|--------------|---------|---------------|
| `[事实]` | - | 直接写入，标注来源 `← PMContext: <章节>` |
| `[假设]` 置信度 ≥ 8 | - | 写入并在括号标注`（假设：PMContext 中 <内容>，置信度 N/10）`，可进入用户故事 |
| `[假设]` 置信度 5-7 | - | 写入实施规则但加 `⚠️ 假设项` 前缀，不进入验收标准 |
| `[假设]` 置信度 < 5 | - | 写入风险项章节，不进入用户故事或规则 |
| `[待确认]` | 占比 ≤ 30% | 写入风险项章节，标注"待 PM 确认"。**不写入用户故事或规则**——未确认项不能作为执行依据 |
| `[待确认]` | 占比 30%-50% | 同上 + PRD 顶部加 🟡 警示横幅"PRD 草案：含 N 项待确认" |
| `[待确认]` | 占比 > 50% | 同上 + 横幅升级为 🔴"PRD 不可执行：待确认占比过高" |
| `[冲突]` | - | 写入风险项章节，列出双方观点 + Agent 选定方向及理由，不进入用户故事 |
## 失败模式
| 触发条件 | 一线修复 | 仍失败兜底 |
|---------|---------|-----------|
| `docs/pm-context/pm-context.md` 不存在 | **🔴 STOP**：输出"未找到 PMContext，先运行 `/pm-need <需求>`" | 不阻塞，提示后退出 |
| PMContext `[待确认]` 占比 > 50% | 输出 PRD 草案但不视为正式 PRD，顶部加 🔴 警示 | 标记为 `draft` 后缀 `ai-prd.draft.md`，不覆盖已有正式 PRD |
| Agent Context 需技术栈信息而 PMContext 中缺失 | 从 `package.json`/`pyproject.toml`/`Cargo.toml` 等配置文件读取，标注"来自项目扫描" | 全部缺失则技术栈标 `[待确认]`，不臆造 |
| PMContext 中 `[冲突]` 项涉及核心规则 | 不强行选定方向，规则章节标 `⚠️ 冲突项：见风险项章节` | 验收标准跳过该规则，提示 PM 先解决冲突 |
| ai-prd 与 human-prd 同源项出现分歧 | 以 PMContext 为准修正 ai-prd，标注修正项 | 仍不一致则 git diff 记录分歧供 PM 审计 |
| 用户故事无法追溯到 PMContext 事实 | 标 `[待确认]` 移入风险项章节，不进入用户故事列表 | 不阻塞，但必须在产物顶部汇总追溯失败项 |
| **PMContext §8 有前端框架声明但 ai-prd 未承接为「技术栈契约」段** | 补写技术栈契约段，标注"补充：来自 §8 声明" | 不阻塞；下游 pm-sketch Step -0.5 此场景可命中，不影响原型生成 |
## 关联增强
生成时确保每条需求都追溯到 PMContext 中的具体项，无来源的需求标 `[待确认]`。
在 ai-prd.md 中每条用户故事和规则后追加 `← PMContext: <章节>` 标记。
**🔴 CHECKPOINT** — 输出生成摘要：用户故事数/规则数 + [待确认]占比+警示 + 追溯失败项。
## 不要做什么（反例黑名单）
| 反模式 | 为什么不要做 |
|--------|------------|
| 把 `[待确认]` 项写成确定性要求 | 执行 Agent 会当真，导致交付偏差 |
| 不追溯来源（每个需求要有 ← PMContext 标记） | AI 无法判断哪些来自事实、哪些是推断 |
| 在用户故事中混入技术实现细节 | 用户故事是做什么（what），不是怎么做（how） |
| 忽略边界场景（d3 缺失） | 执行 Agent 遇到异常路径会不知所措 |
| 把 Agent Context 塞给人类读者（human-prd 与 ai-prd 内容互换） | AI 要的东西和人要看的不同 |
| 审计三元组反模式 | 见 CONTEXT.md『审计三元组反模式（共享定义）』——同义反复/空话/未阐明具体推导逻辑均判定为 Failure |
| PMContext §8 含前端框架声明但 AI PRD 未承接为「技术栈契约」段 | 下游 pm-sketch 失去硬触发依据，Agent 会自降级到简单模式 HTML 壳子——AiGateway 事故就是此失守 |
## 产出示例 · 实战提示
`/pm-prd --skip-human 会员体系重构` → `prd/ai-prd.md` 概要：
As a 月付用户, I want to upgrade to 年付, so that 节省费用
[7 条可执行规则...]
完整 AI PRD 片段示例与可执行规则书写技巧见 [references/agent-prd-example.md](references/agent-prd-example.md)。
**实战铁律**（落盘前对照）：
- **[待确认] 大于 30% 标 🟡，大于 50% 标 🔴**：前者是草案，后者是不可执行
- **每条规则必须是可执行的**："确保用户体验良好"不叫规则，"按钮不小于 44px"才叫规则
- **Agent Context 不可省略**：技术栈/目录结构/关键模块位置是 AI 执行的前提
### Further Reading
- [A Proven AI PRD Template - Miqdad Jaffer (OpenAI)](https://www.productcompass.pm/p/ai-prd-template)
- [How to Write a Product Requirements Document? The Best PRD Template.](https://www.productcompass.pm/p/prd-template) — 8 节模板参考