Elite prd writer
Skill xyjk0511/elite-prd-skill-pack/.agents/skills/elite-prd-writer
Codex skill pack for PRD discussion, requirements clarity, PRD writing, audit, engineering handoff, and QA generation
npx -y skills add xyjk0511/elite-prd-skill-pack --skill elite-prd-writerAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
当用户要求创建、重写、补全、结构化或落盘产品需求文档(PRD、产品规格、功能需求、MVP 范围、验收标准、埋点规则)时使用本技能;适用于把模糊想法、会议纪要、issue、竞品笔记或已有草稿转成设计、前端、后端、测试、数据都可执行的 PRD。不要用于直接编码、纯技术架构设计、只生成测试用例、只生成开发任务;这些分别交给 requirements-clarity、qa-generator、implementation-handoff 或专门技术设计流程。
SKILL.md
5.9 KB, as published. Nobody here has run it
Elite PRD Writer
目标
把用户的想法、草稿或现有需求转成工程可开工的产品需求文档,而不是写成长篇空话。
完成标准:
- 设计可以据此出原型。
- 前端可以识别页面、组件、交互状态、字段校验。
- 后端可以识别对象、接口、权限、状态流转。
- QA 可以据此生成测试用例。
- 数据可以据此完成埋点与指标口径。
- 团队可以明确知道本期做什么、明确不做什么。
默认语言
默认使用中文输出。文件名、事件名、指标键名、API 路径、字段名、代码、命令和目录名可以保留英文。
工作边界
使用本技能处理:
- 从 0 创建 PRD / 产品需求书 / 产品规格。
- 把模糊想法、issue、会议纪要、聊天记录补全为需求文档。
- 重写不够专业或不够完整的 PRD。
- 生成 MVP 范围、业务规则、验收标准、埋点方案。
- 为设计、研发、测试和数据建立统一需求基线。
不要使用本技能处理:
- 用户明确要求直接写代码。
- 用户只要技术设计、测试用例、开发任务、tickets 或 API stub。
- 用户只是问一个小 bug 或微调项,且不需要文档。
遇到边界外任务,改用 requirements-clarity、prd-auditor、implementation-handoff、qa-generator 或专门技术设计流程。
工作流程
- 先检查仓库已有上下文:
AGENTS.md、README.md、docs/、tasks/、历史 PRD、issue、roadmap、设计或架构文档。 - 如果仓库已有命名和目录规范,优先遵循仓库规范。
- 判断需求清晰度。只有缺失信息会实质影响 PRD 内容时才提问。
- 用户要求“直接写”时不要阻塞;用显式假设继续。
- 默认输出完整 PRD;用户要求轻量版时输出简版 PRD。
- 输出
PRD Packet,供prd-auditor、implementation-handoff、qa-generator使用。 - 如果用户要求创建文件,或仓库已有文档目录规范,保存到文件。
澄清策略
最多提 7 个问题,按影响优先级排序:
- 目标用户是谁。
- 解决什么核心问题。
- 业务 / 产品目标是什么。
- 核心用户流程是什么。
- 本期必须做什么。
- 本期明确不做什么。
- 成功指标是什么。
- 有哪些技术、合规、时间、数据、运营约束。
如果需要先做系统澄清,改用 requirements-clarity。
信息不足但可以推进时,先写:
以下 PRD 基于这些假设:
1. 假设目标用户为……
2. 假设本期目标为……
3. 假设暂不包含……
4. 假设成功指标以……为准
不要把假设写成已确认事实。
与其他技能的衔接
- 输入来自
requirements-clarity时,优先使用其中的Requirements Packet,并把未确认项写入 PRD 的“待确认问题”。 - PRD 生成后,默认建议进入
prd-auditor做开工审计。 - 只有
prd-auditor给出“可以开工”或“补充后开工且无 P0 阻塞”时,才进入implementation-handoff。 qa-generator应消费已通过审计的 PRD;如果 PRD 缺少验收标准、状态机或权限规则,先回到本技能补 PRD。
输出结构
默认使用 references/prd-template.md。至少包含:
- 文档信息
- 一句话概述
- 背景与问题
- 目标用户与使用场景
- 产品目标
- 成功指标
- 本期范围
- 非本期范围
- 用户流程
- 页面 / 模块结构
- 功能需求详述
- 业务规则
- 状态流转
- 权限设计
- 字段与数据要求
- 埋点与指标口径
- 非功能需求
- 异常与边界情况
- 验收标准
- 风险与依赖
- 待确认问题
行为改变型功能必须包含埋点和指标。需要事件命名、漏斗或字段模板时读取 references/metrics-and-events.md。
功能需求写法
每个重要功能使用:
### FR-xxx 功能名称
- 目标用户:
- 优先级:P0 / P1 / P2 / P3
- 需求描述:
- 前置条件:
- 触发条件:
- 主流程:
- 分支流程:
- 异常流程:
- 业务规则:
- 字段规则:
- 权限规则:
- 验收标准:
- 埋点需求:
所有 P0 功能必须有可测试验收标准。优先使用 Given-When-Then。
结果落盘
默认推荐路径:docs/prd/prd-[feature-name].md。
文件名使用 kebab-case。如果仓库已有自己的目录或命名方式,遵循仓库规则,不强行覆盖。
需要确定性写文件时,使用 scripts/save_doc.py:
python .agents/skills/elite-prd-writer/scripts/save_doc.py --path docs/prd/prd-[feature-name].md < draft.md
PRD Packet
输出或落盘 PRD 后,附上交接块:
## PRD Packet
- PRD 文件路径:
- 功能名称:
- 版本 / 状态:
- 本期范围:
- 非本期范围:
- P0 功能列表:
- 核心状态机:
- 权限边界:
- 关键字段:
- 埋点事件:
- 待确认问题:
严格禁止
- 不要在 PRD 生成过程中直接开始实现代码。
- 不要跳过范围边界、异常流程、权限设计、埋点与指标。
- 不要把假设伪装成事实。
- 不要输出只有 happy path 的 PRD。
- 不要把技术方案写成唯一实现方案,除非用户明确要求。
结束前自检
输出前读取 references/quality-checklist.md 或按其中标准静默自检。若设计、前端、后端、QA、数据任一角色无法开工,先补全文档再输出。