pm-prd-writer
Skill1 starsChanged 4 months agoMITView on GitHub
Write page-oriented, development-readable Chinese PRD / requirement documents from already discussed product requirements. Use when the user asks to write or rewrite a 需求文档 / PRD, make requirements developer-readable, follow a fixed demand-document format, or organize page structure, interactions, field rules, key logic, and out-of-scope scope without scattering information.
3 other projects use a version of this.
Adopted by
Most recently taken up by
- zephyrwang6/pm-skillstheir own version, first seen Oct 8, 2026
- SpaceZephyr/pm-skillstheir own version, first seen Jul 9, 2026
- ayouaiyouwei-arch/claude_pm_workflowstheir own version, first seen Jun 17, 2026
Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 3
- zephyrwang6/pm-skills★ 1.1ksame name
- SpaceZephyr/pm-skills★ 1.1ksame name
- ayouaiyouwei-arch/claude_pm_workflows★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository17 other files it gives its agents.
- audience-judgment-framingSkill
- embedded-prd-auditSkill
- freeze-readiness-checkSkill
- memory-export-summarySkill
- pm-demo-designSkill
- pm-design-absorptionSkill
- pm-devil-advocateSkill
- pm-embedded-prdSkill
- pm-project-opsSkill
- pm-react-prototype-executionSkill
- pm-requirement-intakeSkill
- pm-requirement-reverse-auditSkill
- pm-value-anchorSkill
- prototype-export-intakeSkill
- request-triageSkill
- rule-change-signalSkill
- state-auditSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
33 rules. About 0 are common, 24 are distinctive, and 9 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈24
Distinctive · estimate
This author's own choices. Worth a look.
9
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 8
Use this skill to turn clarified product requirements into a compact, structured PRD that frontend, backend, and testing can implement from.
- Very specific: line 21
Read project-local memory first (current.md, decisions.md, open-questions.md).
- Distinctive: line 22
Read the current prototype, page baseline, or screenshot-derived page structure when it exists.
- Distinctive: line 23
Write from the actual current page/prototype.
- Very specific: line 26
Read project-local current.md and changelog.md.
- Distinctive: line 28
If the user says "today"/"this round"/"latest", map that to the current local date and include only confirmed changes from that date plus …
- Distinctive: line 29
Keep a short internal checklist of which dated changes are being applied.
- Distinctive: line 32
If the user asks only for PRD text, do not change the prototype.
- Distinctive: line 33
If the PRD introduces UI/behavior missing from the prototype, mention the prototype needs a separate update, but keep that note out of the …
- Very specific: line 51
When the PRD is embedded into a prototype/left-document panel, do not add a standalone title.
- Distinctive: line 58
Write fields under the module or dialog where they appear.
- Distinctive: line 59
Write actions and operation results.
- Distinctive: line 60
Write state, boundary, and exception rules near the affected module.
- Distinctive: line 61
Write cross-module / cross-layer key logic.
- Distinctive: line 63
Run the final self-check (§13) and revise before returning.
- Very specific: line 65
Use conclusion-first wording.
- Very specific: line 70
Use - bullets for parallel items, field descriptions, rule lists, boundary scenarios, key logic.
- Very specific: line 71
Use text only for useful emphasis.
- Distinctive: line 72
Do not over-fragment: keep related statements together.
- Very specific: line 73
Write each complete rule once under its owning module/field, then reference it briefly elsewhere.
- Distinctive: line 76
Do not write database tables, API schemas, code fields, or cost estimates unless explicitly asked.
- Distinctive: line 77
Do not describe existing shared components in detail unless the requirement changes them.
- Distinctive: line 78
Do not use tables by default for small dialogs or short modules.
- Distinctive: line 84
Write by page and module. Put related dialogs under their owning module.
- Distinctive: line 96
Write important operations with full branches: success, failure, timeout/retry when relevant, boundary result, partial success for batch, …
- Distinctive: line 102
Add boundary scenarios only when they affect implementation or review.
- Distinctive: line 120
Not mandatory per module. Add only when a module/operation is complex, high-risk, state-heavy, validation-heavy, or configuration-driven.
- Very specific: line 129
Avoid: 本期不定义数据库字段。 / 本期不写接口。 (writing boundaries, not product scope) unless the user explicitly asks for a technical boundary section.
- Distinctive: line 133
Before returning the PRD, check from these roles:
- Distinctive: line 136
Test: can each field, action, save validation, deletion scope, empty state, and App access rule be verified?
- Distinctive: line 140
If any answer is no, revise before returning.
- Distinctive: line 146
If requirement logic changes during writing, update project memory only after the user approves or asks to remember it.
- Very specific: line 147
If the PRD becomes part of an embedded PRD or review baseline, let pm-project-ops manage storage, versioning, and baseline relationships.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
PM PRD Writer
Use this skill to turn clarified product requirements into a compact, structured PRD that frontend, backend, and testing can implement from.
This skill is for writing the requirement document, not for discovering the requirement. If the requirement is still unclear, return to pm-requirement-intake first.
Do Not Use When
- the requirement is still unclear →
pm-requirement-intake - the task is embedded/linked delivery →
pm-embedded-prd - the task is only project storage/versioning →
pm-project-ops
1. Before Writing
For active PM workflow projects:
- Read project-local memory first (
current.md,decisions.md,open-questions.md). - Read the current prototype, page baseline, or screenshot-derived page structure when it exists.
- Write from the actual current page/prototype. Do not invent page modules, fields, states, or interactions.
Dated change baseline (for active PM workflow PRD updates):
- Read project-local
current.mdandchangelog.md. - Extract PRD-impacting requirement changes by date (
YYYY-MM-DDminimum). - If the user says "today"/"this round"/"latest", map that to the current local date and include only confirmed changes from that date plus the current conversation.
- Keep a short internal checklist of which dated changes are being applied; do not rewrite a PRD from an old pasted document when project-local memory has newer dated changes.
Separate document work from prototype work:
- If the user asks only for PRD text, do not change the prototype.
- If the PRD introduces UI/behavior missing from the prototype, mention the prototype needs a separate update, but keep that note out of the PRD body unless asked.
- Project-specific decisions belong in project-local memory or project docs, not in this skill.
2. Default PRD Structure
# 1. 功能定位
# 2. 业务定义
# 3. 页面结构
## 3.1 页面 / 模块名称
### 3.1.1 展示规则
### 3.1.2 新增 / 编辑 / 删除 / 配置
# 4. 关键逻辑
# 5. 本期不处理Adjust section names to fit the feature, but keep the thinking order: why it exists → what terms mean → how each page/module behaves → cross-module rules → what is out of scope.
When the PRD is embedded into a prototype/left-document panel, do not add a standalone title; start directly from # 1. 功能定位.
3. Writing Flow
- Define the product layer: backend config, App/client behavior, shared capability, or cross-layer summary.
- State feature purpose and business definitions.
- Build the page/module skeleton from the current prototype or confirmed requirement.
- Write fields under the module or dialog where they appear.
- Write actions and operation results.
- Write state, boundary, and exception rules near the affected module.
- Write cross-module / cross-layer key logic.
- Write
本期不处理. - Run the final self-check (§13) and revise before returning.
Use conclusion-first wording. Prefer short condition -> result statements, e.g. 超出上限时按钮置灰,hover 提示“已达到模板数量上限(50个)”。
4. Style Rules
- Output PRDs in Markdown. Use numeric headings (
# 1. 功能定位,## 3.1 教材列表). - Use
-bullets for parallel items, field descriptions, rule lists, boundary scenarios, key logic; two-space nested indent. - Use
**text**only for useful emphasis. - Do not over-fragment: keep related statements together; do not put every sentence on its own line.
- Write each complete rule once under its owning module/field, then reference it briefly elsewhere. Global state rules (e.g.
启用态不可编辑) go once in a global rules section. - State the rule first; add examples only when they reduce ambiguity.
- For multi-step judgment logic, prefer a compact flow tree or decision table over long prose.
- Do not write database tables, API schemas, code fields, or cost estimates unless explicitly asked.
- Do not describe existing shared components in detail unless the requirement changes them.
- Do not use tables by default for small dialogs or short modules; flatten the few fields and rules into bullets.
- Pure explanatory paragraphs may remain normal prose when that reads better.
- For large/repeated PRDs, see
references/large-prd-compression.md(positioning sentences, global-rule extraction, table-vs-bullet rules, multi-layer document boundaries).
5. Page And Module Rules
Write by page and module. Put related dialogs under their owning module; do not create disconnected dialog sections. Page/module structure comes before field detail. Inside field-centric dialogs/settings pages, organize by field, not by lifecycle stage.
A worked page/module example is in references/field-linkage-interaction.md.
6. Field Rules
For each important field cover four elements when applicable: requiredness (必填/选填), type, constraint (length/range/count/values/format/uniqueness/dependency), default. Put field-level behavior near the field, not in a distant section. For list/card fields, also define overflow, abbreviation, and full-view behavior — specify thresholds, never vague 内容过多时截断展示.
Field-detail pattern and full examples: references/field-linkage-interaction.md.
7. Operation Rules
Write important operations with full branches: success, failure, timeout/retry when relevant, boundary result, partial success for batch, state after operation.
Copy-ready templates for add/edit modal, uniqueness validation, single delete, batch delete, realtime switch, copy/clone: references/operation-branch-templates.md.
8. State And Boundary Rules
Add boundary scenarios only when they affect implementation or review; keep them close to the affected module. Categories: empty data, network exception, extreme cases, invalid state. For state-lock and readonly-reference designs, define lock granularity / exceptions / disabled visuals / sync timing.
Examples and the state-lock/readonly checklists: references/operation-branch-templates.md.
9. Linkage And Hierarchy Rules
Write linkage both ways: if A affects B, also state what happens when B changes/clears/invalidates. Name cleared fields on switch; state whether hidden values still validate. For hierarchies, define cascade for delete/hide/move/disable/copy/sort. For priority rules, define judgment order, per-layer fallback, field clear/retain, and no-rule-hit behavior; use a flow tree when branches multiply.
Linkage examples and the flow-tree pattern: references/field-linkage-interaction.md.
10. Interaction Form Rules
Define non-obvious interaction forms explicitly (move, sort, search, multi-select, wizard). Do not hide high-cost interactions behind 支持调整 / 可配置 / 按规则判断. When a numeric 排序权重 field gains drag sorting, treat drag as a persisted-weight update, not pure UI.
Full interaction + weight/drag-sorting spec: references/field-linkage-interaction.md.
11. Acceptance Criteria Rules
Not mandatory per module. Add only when a module/operation is complex, high-risk, state-heavy, validation-heavy, or configuration-driven. Prefer Chinese condition-result wording; keep criteria close to the affected module; do not turn the PRD into a test-case document.
Branch list and templates: references/operation-branch-templates.md.
12. Out Of Scope
本期不处理 should contain product/business scope boundaries, not writing-process disclaimers.
Good: 本期不处理历史数据批量迁移。 / 本期不处理 App 端新样式,只复用现有入口展示组件。 / 本期不处理跨教材复制入口。
Avoid: 本期不定义数据库字段。 / 本期不写接口。 (writing boundaries, not product scope) unless the user explicitly asks for a technical boundary section.
13. Final Self-Check
Before returning the PRD, check from these roles:
- Frontend: can modules, fields, dialogs, states, interactions be drawn without guessing?
- Backend: are validation, matching order, uniqueness, persistence concrete enough to implement?
- Test: can each field, action, save validation, deletion scope, empty state, and App access rule be verified?
Then run the 15-item rule-coverage checklist in references/final-self-check.md.
If any answer is no, revise before returning. Do not knowingly hand back scattered logic, missing modules, invented states, or vague rules.
14. Memory And Workflow
- Stable PRD-writing rules belong in this skill.
- Project-specific decisions belong in project-local memory or project docs.
- If requirement logic changes during writing, update project memory only after the user approves or asks to remember it.
- If the PRD becomes part of an embedded PRD or review baseline, let
pm-project-opsmanage storage, versioning, and baseline relationships.
On-Demand References
Load only the smallest relevant file when the current PRD cannot proceed without it. Do not load by default.
references/operation-branch-templates.md: add/edit/delete/batch/switch/copy branches, state/boundary examples, acceptance criteria detail.references/field-linkage-interaction.md: field-detail pattern, page/module example, linkage cascades, flow tree, interaction forms, weight/drag sorting.references/large-prd-compression.md: global-rule extraction, table-vs-bullet rules, multi-layer document boundaries.references/final-self-check.md: full 15-item rule-coverage checklist for §13.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

