核心用法
PRD-2 是一款专注于产品需求文档规范化管理的 Skill，旨在解决 AI Agent 或人类开发者在功能开发中的任务拆解与进度追踪问题。用户需在项目 agents/prd.json 路径下创建或编辑配置文件，按照既定 JSON Schema 定义用户故事（User Stories）。每个故事必须包含唯一 ID、标题、描述、可验证的验收标准（Acceptance Criteria）、优先级及完成状态字段。
关键操作遵循 "优先级驱动执行" 原则：开发者按 priority 字段顺序完成故事，前置故事不应依赖后置故事。典型执行顺序为数据库 Schema 变更 → 后端逻辑实现 → UI 组件开发 → 综合视图集成。每完成一个故事，需手动将 passes 字段从 false 更新为 true，并在 notes 字段记录执行细节。此外，验收标准必须具体可验证，强制要求包含 "Typecheck passes" 以确保代码质量。
显著优点
1. 上下文窗口优化：强制要求每个用户故事可在单个 AI 上下文窗口内完成，避免大任务导致的记忆丢失或执行中断，显著提升 Agent 执行成功率。
2. 零安全攻击面：纯 Markdown + JSON 文档结构，无任何可执行代码、第三方依赖或网络请求能力，从根本上杜绝代码注入、权限滥用等传统安全风险。
3. 标准化协作流程：统一的 JSON Schema 使 AI Agent 与人类开发者共享同一套任务描述语言，降低沟通成本，支持 Claude Code、OpenCode 等多平台 Agent 无缝接入。
4. 轻量可溯源：MIT-0 开源协议允许商业自由使用，文件级配置便于版本控制（Git），进度状态透明可查。
潜在局限
1. 执行非自动化：该 Skill 仅提供规范框架，不具备自动执行或状态同步能力，依赖开发者手动更新 passes 状态，存在进度滞后或遗忘更新的风险。
2. 复杂度天花板：适合中等规模功能开发，对于跨服务、跨团队的史诗级（Epic）需求，需额外拆分多个 PRD 文件或引入更复杂的项目管理工具。
3. 验收标准主观性：虽然规范要求可验证，但 "Typecheck passes" 等标准仍依赖项目具体配置，不同技术栈间可能存在理解偏差。
4. T3 来源可信度：维护者为个人开发者，非企业级背书，长期维护稳定性弱于 T1/T2 来源工具。
适合人群
- AI Agent 开发者：使用 Claude Code、OpenCode、Cline 等工具进行自动化功能开发的工程师，需要结构化任务清单指导 Agent 执行。
- 独立开发者 / 小团队：缺乏专职产品经理，需快速规范需求文档的技术负责人。
- 敏捷实践者：追求用户故事驱动开发（User Story Driven Development），重视可交付小步快跑的团队。
- 教学场景：用于教授 PRD 编写规范、敏捷开发流程的教育用途。
使用风险
1. 权限误用风险：Skill 文档中提及的 Agent 工作流（如 "Unattended Agentic Loop"）可能诱导用户使用 --dangerously-skip-permissions 等危险参数，实际执行时应在隔离环境（git worktree）中运行，并保持权限提示开启。
2. 敏感信息泄露：notes 字段可能记录运行时的环境路径、数据库连接细节等敏感信息，建议定期审查 progress.txt 或 prd.json 内容，避免提交至公共仓库。
3. 版本漂移：手动维护 JSON 文件易与代码实际状态脱节，建议结合 CI 脚本自动化校验 passes 状态与 Git 提交、测试结果的关联性。
4. 无回滚机制：Skill 本身不保存历史版本，误操作覆盖 prd.json 可能导致进度丢失，需依赖 Git 等版本工具保障数据安全。