القائمة
将历史PRD内容录入标准三层文档体系：前置阶段完成需求ID确认、层级判断、内容提取；后置阶段完全复用 /new-prd 的文件创建、内容填充、质检门控和数据飞轮流程。不适用于新需求（用 /new-prd）、仅澄清需求（用 /requirement-clarifier）、更新已有PRD（用 /update-prd）
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
Systematically explore what customers are trying to accomplish (functional, social, emotional jobs), the pains they experience, and the gains they seek. Use this framework to uncover unmet needs, vali
Guide product managers through strategic roadmap planning by orchestrating prioritization, epic definition, stakeholder alignment, and release sequencing skills into a structured process. Use this to
Create clear, concise user stories that combine Mike Cohn's user story format with Gherkin-style acceptance criteria. Use this to translate user needs into actionable development work that focuses on
استنادا إلى تصنيف SOC المهني
| name | ingest-prd |
| description | 将历史PRD内容录入标准三层文档体系：前置阶段完成需求ID确认、层级判断、内容提取；后置阶段完全复用 /new-prd 的文件创建、内容填充、质检门控和数据飞轮流程。不适用于新需求（用 /new-prd）、仅澄清需求（用 /requirement-clarifier）、更新已有PRD（用 /update-prd） |
| tags | ["prd","ingestion","history","registry"] |
| version | 3.0 |
用户提供历史PRD内容（任意格式）并请求录入 prds/ 体系时。
触发方式：/ingest-prd，随后提供原始PRD内容（需求ID可选）。
/new-prd/requirement-clarifier/update-prd执行前必须实际读取以下文件（不得使用记忆中的数据）：
prds/_registry.md — 确认当前最高 ID 编号（必读，失败则停止执行）drafts/_draft-registry.md — 确认草稿区已占用 ID（不存在时自动创建含表头的空文件）context/iteration-requirement-list.md — 匹配需求ID（可选，见下方说明）context/product-background.md — 辅助推断产品线（可选，缺失时跳过）关于 iteration-requirement-list.md 缺失的处理：
⚠️ 未找到需求列表（
context/iteration-requirement-list.md）。 建议先按 README Step 1.5 补充历史需求列表，可提升 ID 匹配准确率。 本次将跳过 ID 自动匹配，所有需求 ID 需手动确认。
情况A — 用户已提供需求ID：在清单中查找，确认标题是否与PRD内容匹配，输出：
确认：需求 [ID]「[标题]」与本PRD内容匹配，继续执行。
若不匹配，停下来告知用户，请用户确认正确的ID。
情况B — 用户未提供需求ID：从清单中按关键词搜索，列出最多3个候选：
在需求清单中找到以下候选，请确认哪个与本PRD对应，或告知"均不匹配"：· [ID1]「[标题]」— [所属迭代]· [ID2]「[标题]」— [所属迭代]
情况C — 清单中完全未找到匹配项：标注为「未匹配」，继续执行，req-ids 置空，在录入报告中标记。
情况D — 标题截断或信息不完整：不得提前猜测写入。标注「标题截断，待补全」，待用户补充完整标题后再确认。
情况E — 多版本文档（源文件包含V1/V2/V3等多版本）：
根据以下规则自动判定，可被用户覆盖：
| 情况 | 层级 |
|---|---|
| 1条需求 + 功能简单（单页面/单场景） | story-card（SC-） |
| 2~6条需求 / 多场景 / 有明确页面结构 / 完整功能模块 | feature-prd（F-） |
| 7条��以上需求 / 跨迭代主题 / 含多子功能 / 架构底座类 | epic-prd（E-） |
判断后将理由记录，在录入报告中展示。
从原始PRD中提取内容，映射到标准章节结构：
| 提取内容 | 映射目标 |
|---|---|
| 需求背景、问题描述 | §3 需求概要 |
| 业务术语、概念定义 | §4 需求对象与概念模型 |
| 功能模块、业务流程 | §5 功能结构 |
| 用户故事、使用场景 | §6 用户故事与用例 |
| 功能点列表 | §7 功能清单 |
| 功能详细说明、规则 | §8 功能需求说明书 |
| 性能、安全、兼容性要求 | §9 非功能性需求 |
| 验收条件、测试用例 | §10 验收检查清单 |
| 不做的内容、排除项 | §11 范围外 |
| 遗留问题、待确认项 | §12 开放问题 |
提取原则：
<!-- AI推断，请确认 -->> ⚠️ 待补充：[说明缺少什么]，不杜撰多端差异说明：涉及国内站/国际站行为不同时，必须拆分为独立段落或表格，明确标注差异。
构建完映射表后，将以下信息传递给后置阶段：
评估提取结果是否足以生成有效 PRD，命中以下任意一条则判定为「内容不足」：
| 不足信号 | 说明 |
|---|---|
| §3 需求概要完全缺失 | 无法判断需求目标和用户 |
| §6 用户故事为空且无任何使用场景描述 | 无法确定功能边界 |
| §8 功能说明全部为占位符 | 核心业务规则无从提取 |
| 可填充章节 ≤ 3 个（共10个） | 内容过于碎片化 |
判定为「内容不足」时，停止执行，输出：
⚠️ 导入内容不足以生成完整 PRD
当前可填充章节：[列表] 缺失关键信息：[具体说明缺什么]
建议先通过需求澄清补全信息，再录入 PRD：
/requirement-clarifier [标题]澄清完成后重新运行
/ingest-prd，届时可将原始内容与 RDD 合并使用。
判定为「内容充分」时：继续执行，若存在部分章节不足（但未触发阻断条件），在 Step 2.5 摘要中列出，后续走占位符处理。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 前置分析完成
类型：[层级]（判断依据：[一句话说明]）
标题：[中文标题]
需求ID：[ID列表] | 来源：[用户提供|从清单匹配|未找到]
上线日期：[日期 | 未找到]
负责人：[姓名 | 未找到]
✅ 可填充章节：[列表]
⚠️ 待补全章节：[列表]
即将进入草稿创建流程...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
从此处开始，完整执行 /new-prd 命令的 Step 3 至结束，以下为关键适配说明：
Step 3（文件创建）适配：
author 字段优先使用需求清单中的负责人；若未找到，再走 new-prd Step 0.5 的作者询问逻辑created 字段以需求清单中的上线日期为准；未找到时以源文件最早修订日期为准，并在 notes 中注明drafts/[ID]-[标题]/archive/original-v0.1.md，文件头部追加：
<!-- 原始导入内容 v0.1 — 录入日期：[今天日期]，来源：[用户描述的源文件路径，无则填"用户直接粘贴"] -->
Step 5（内容填充）适配：
## v0.1 — [上线日期或录入日期]（原始导入）
- 原始内容已归档至 `archive/original-v0.1.md`
- 关联需求ID：[ID列表]，录入日期：[今天]
- 来源：[源文件路径 | 用户直接粘贴]
## v1.0 — [今天日期]
- 基于原始内容（v0.1）重构为标准 PRD 格式，由 AI 生成
Step 7（移入正式区）适配：
rules/prd-quality-gates.md）完整执行，❌ 项阻断移入context/iteration-requirement-list.md：找到所有关联需求ID对应的行，将「关联PRD」列填入 [ID](../prds/[文件夹]/prd.md)；req-ids 为空时跳过| 版本 | 日期 | 变更 |
|---|---|---|
| 1.0 | 2026-04-05 | 初始版本，建立基础录入流程 |
| 2.0 | 2026-04-07 | 重大更新，修复8个已知问题 |
| 3.0 | 2026-05-12 | 架构重构：后置阶段完全复用 /new-prd 流程，消除重复维护；新增 Step 2 内容映射表、Step 2.5 前置摘要；质检门控、数据飞轮、草稿区流程全部对齐 new-prd |
| 3.1 | 2026-05-12 | 新增 Step 2.3 内容充分性判断（不足时退回 /requirement-clarifier）；原始导入内容保存为 archive/original-v0.1.md，CHANGELOG 增加 v0.1 原始记录层 |