pdlc-prd

name	pdlc-prd
description	创建 PRD 文档（自动化生成 + 自检 + handoff）
argument-hint	<功能描述 | 已有需求文档路径>
allowed-tools	Read, Write, Edit, Glob, Grep, Bash
layer	2
stage	requirements
produces	["docs/01_requirements/prd/<feature-id>-<feature-name>-prd.md"]
requires	[]
next_step	pdlc-design
terminal_state	prd_done

创建 PRD 文档

根据用户提供的需求描述或已有需求文档，在 docs/01_requirements/prd/ 目录下创建一份完整的 PRD（产品需求文档）。

段一：生成 PRD

1.1 输入解析（必须执行）

从 $ARGUMENTS 中判断输入类型：

1. 检测是否为文件路径：匹配以下模式之一即视为文件输入：

   • 以 /、./、../、~ 开头
   • 以 .md、.txt、.docx、.pdf、.doc 结尾
   • 包含 docs/ 或 requirements/ 路径片段
   • 是一个实际存在的文件路径

2. 文件输入处理：

   • 读取文件内容（支持 Markdown、纯文本、PDF）
   • 若为飞书文档链接，通过飞书 API 获取
   • 从内容提取：功能名称、范围、用户故事、验收标准
   • 保留原文档核心内容，仅补充和结构化，不重写
   • 在 PRD 中添加：<!-- 来源文档: <原始路径> -->

3. 文本输入处理：按描述推断功能需求

核心原则：文件输入是「基于已有内容结构化」，文本输入是「从零生成」。

1.2 功能ID分配

1.3 生成 PRD 文档

1. 阅读 templates/prd-template.md 获取模板格式
2. 阅读 docs/00_standards/coding/ 获取编码规范（若存在；查找未命中 → 在报告里提示 consider /pdlc-standard add coding/<topic>）
3. 文件名格式：<功能ID>-<功能名>-prd.md
4. 文档顶部加 PDLC 追溯头：

5. 文档必须包含：背景与目标、目标用户、功能需求（含优先级）、非功能需求、验收标准

7. 用户故事使用标准格式："作为[角色]，我希望[功能]，以便[收益]"

1.4 关系检测（RFC#6）

从输入检测 feature 关系信号：

1. 关键词扫描：输入含「基于 / 扩展 / 增强 / based on / extends / 依赖 / 替代 / 修复缺陷」等 → 存在关系
2. 扫描现有 feature：读 docs/.pdlc-state/*.json 列已有 feature 名，判断本 PRD 是否 extends/depends_on 其一
3. 填 §6.1 关系表：识别到的关系填入模板「6.1 关系」表（类型/目标ID/目标名/原因）。无则留空
4. 类型语义见 relations.md

Phase 2：本步从"被动检测"升级为"主动提示用户确认关系"。

1.5 核心流程挂钩（若项目已启用质量闸门）

若存在 docs/00_standards/quality-targets.yml：本 PRD 里标为 P0 / P1 的流程， 逐条比对该文件的 core_flows，在 handoff 里提示补齐尚未收录的流程及其 E2E 映射。

为什么在这里提示：core_flows 清单若靠"事后有人记得改"来维护必然腐烂， 而腐烂的清单会让质量报告产出 false-green（新增核心流没进清单 → 覆盖矩阵照样全绿）。 PRD 是这些流程的上游真源，在产出时就挂钩，比事后补救可靠。 /pdlc-quality 每次运行还会再做一次强制对账兜底。

段二：自检（强制）

PRD 自检清单（必须全部检查）

完整性：

• 背景与目标：清晰说明为什么做、业务价值是什么
• 目标用户：至少一类用户角色定义明确
• 用户故事：≥ 3 条且符合标准格式
• 功能清单：每条有 P0/P1/P2 优先级标注
• 验收标准：可度量、可验证（有具体数值或明确通过/不通过条件）
• 非功能需求：至少覆盖性能、安全、可用性中的两项

一致性：

• PDLC 追溯头所有字段齐全且日期是今天实际日期
• 功能ID 格式正确（F-，兼容旧 F<日期>-）
• 文件路径符合规范

段三：修复（单次，不递归）

针对自检清单中未通过项：

• 可自动修复 → 直接补齐/修正
• 修复后再读一遍确认修复项现在通过
• 无法自动修复 → 记录到自审报告，继续段四

段四：更新状态机 + 交接

本阶段状态机更新：

• current_stage: requirements —— 仅当本阶段成功时才这样写。ok=false（含 blocked）时按 state-update.md 规则 5：current_stage 保持原值不变、advanced_to=null、写 blocked_reason。
• 追加 history：

  { "stage": "requirements", "done_at": "<ISO8601>", "produced": ["docs/01_requirements/prd/<...>-prd.md"], "self_audit": { "passed": <N>, "failed": <N>, "manual": <N> } }
  

• next_step: pdlc-design

本命令的 handoff 输出：

✅ PRD 已创建：docs/01_requirements/prd/<feature-id>-<feature-name>-prd.md
📊 自检：<pass>/<total> 通过
📦 状态快照：docs/.pdlc-state/<feature-id>.json
👉 下一步：/pdlc-design <feature-id>

---

目标需求: $ARGUMENTS