名称: 文档AI产品需求定义 描述: 撰写优化用于编码助手（如Claude Code、Cursor、Copilot、自定义GPTs）的产品需求文档（PRD）、规格说明和项目上下文。包括CLAUDE.md生成、会话规划和模板，用于创建工具可有效执行的文档。
PRD与项目上下文
创建人类和编码助手可有效执行的产品需求和项目上下文。
两项能力：
- PRD与规格说明 - 需求、规格、用户故事、验收标准
- 项目上下文 - 架构、约定、部落知识（CLAUDE.md）
现代最佳实践（2026年1月）: 上下文工程（正确信息、正确格式、正确时间）、决策优先文档、带有验收标准的可测试需求、具有公式+时间范围+数据源的指标、跨工具可移植性。
工作流程（按此顺序使用）
- 选择交付物（PRD、AI PRD、技术规格、故事映射、CLAUDE.md）。
- 收集输入（问题证据、用户、约束、依赖、风险）。
- 填充模板（先写决策；保持需求可测试）。
- 用检查清单验证（需求、边缘案例、安全/合规性，根据需要）。
- 交接下一步行动（实施计划、负责人、开放问题）。
快速参考
PRD与规格说明
| 任务 | 模板 |
|---|---|
| PRD创建 | assets/prd/prd-template.md |
| 技术规格 | assets/spec/tech-spec-template.md |
| 规划检查清单 | assets/planning/planning-checklist.md |
| 故事映射 | assets/stories/story-mapping-template.md |
| Gherkin/BDD | assets/stories/gherkin-example-template.md |
| AI PRD | assets/prd/ai-prd-template.md |
项目上下文（CLAUDE.md）
| 上下文类型 | 模板 | 优先级 |
|---|---|---|
| 架构 | assets/architecture-context.md | 关键 |
| 约定 | assets/conventions-context.md | 高 |
| 关键文件 | assets/key-files-context.md | 关键 |
| 最小启动 | assets/minimal-claudemd.md | 5分钟 |
| 跨工具 | assets/cross-tool-context.md | 多工具 |
决策树
用户需求:
├─► AI辅助编码？
│ ├─ 非琐碎（>3文件）？ → 规划检查清单 + 智能会话
│ └─ 简单（<3文件）？ → 直接实施
│
├─► 项目入门？
│ ├─ 新到代码库？ → 生成CLAUDE.md
│ └─ 快速上下文？ → 最小CLAUDE.md
│
└─► 传统PRD？
├─ 产品需求？ → PRD模板
├─ AI功能？ → AI PRD模板
└─ 验收标准？ → Gherkin/BDD
跨工具上下文文件
| 工具 | 位置 | 注释 |
|---|---|---|
| Claude Code | CLAUDE.md, .claude/ |
自动加载 |
| Cursor | .cursor/rules/ |
项目规则 |
| Copilot | .github/copilot-instructions.md |
工作空间上下文 |
| 通用 | AGENTS.md |
工具无关 |
CLAUDE.md / AGENTS.md 指南
- 从最小开始: assets/minimal-claudemd.md
- 只添加所需: assets/architecture-context.md, assets/conventions-context.md, assets/key-files-context.md, assets/dependencies-context.md, assets/tribal-knowledge-context.md
- 保持可执行: 命令必须可运行；不包含秘密信息；优先文件路径而非粘贴代码
要做 / 避免
要做
- 从执行摘要开始（决策、用户、范围、成功）
- 用可测试语言定义验收标准
- 保持需求无歧义（必须/应该/可能）
- 链接到支持文档而非粘贴
避免
- 无定义的模糊需求（“快”、“易”）
- 混合草稿笔记和最终需求
- 无测量计划的指标
- 无所有者或审查周期的文档
上下文提取
使用：
- references/architecture-extraction.md 用于组件/数据流
- references/convention-mining.md 用于命名/模式
- references/tribal-knowledge-recovery.md 用于git历史“原因”
- references/docs-audit-commands.md 用于审计命令和工具回退
质量检查清单
PRD质量
- [ ] 清晰问题陈述
- [ ] 可衡量的成功标准
- [ ] 无歧义的验收标准
- [ ] 记录的边缘案例
- [ ] AI可执行无需澄清
CLAUDE.md质量
- [ ] 架构反映实际结构
- [ ] 关键文件存在于列出位置
- [ ] 约定匹配实际模式
- [ ] 命令实际工作
- [ ] 无敏感信息
资源
| 资源 | 目的 |
|---|---|
| references/agentic-coding-best-practices.md | AI编码模式 |
| references/requirements-checklists.md | PRD验证 |
| references/traditional-prd-writing.md | 经典PRD格式 |
| references/architecture-extraction.md | 挖掘架构 |
| references/convention-mining.md | 提取约定 |
| references/tribal-knowledge-recovery.md | Git历史分析 |
| references/docs-audit-commands.md | 审计Shell命令 |
| data/sources.json | 策划的外部资源 |
模板
| 类别 | 模板 |
|---|---|
| PRDs | prd-template, ai-prd-template, tech-spec-template |
| 规划 | planning-checklist, agentic-session-template |
| 故事 | story-mapping-template, gherkin-example-template |
| 上下文 | architecture, conventions, key-files, minimal-claudemd |
| 堆栈特定 | nodejs-context, python-context, react-context, go-context |
相关技能
| 技能 | 目的 |
|---|---|
| docs-codebase | README、API文档、架构决策记录（ADR） |
| qa-docs-coverage | 文档覆盖度 |
| product-management | 产品策略 |
| software-architecture-design | 系统设计 |