prd-writer

PRD 需求文档编写 Skill

前置依赖

1. skill: document-norms §1（文档归属矩阵）/ §2（frontmatter 字段标准，特别是 §2.6 req_slug + sub_req_slug 引用契约）。输出路径为 projects/modules/<basic>/<sub>/requirements/<req_slug>/<sub_req_slug>/prd.md， frontmatter type: prd + module + req_slug + sub_req_slug 必填（version 字段 已废除——版本演进进 prd.md 正文「变更与决策记录」）。
2. 项目 PRD 框架：Read .claude/skills/prd-style/SKILL.md——本项目 PRD 的工序形态 （§1）、维度开关（§2）、章节结构（§3）、各章写法（§4）、标注习惯（§5）的唯一事实源。 缺失时 fallback：读框架默认模板 <插件根>/templates/project-skills/prd-style/SKILL.md（插件根 = cat .claude/workframe-state/plugin-root.txt）照用，并提示用户 「本项目未配置 PRD 框架，本次按框架默认执行；正常装机会自动放入，可跑 doctor 检查， 或从上述模板复制到项目 .claude/skills/prd-style/ 后按需修改」。
3. writing-guide.md（S3 填充前读）：core 通用写作纪律。与项目框架冲突时以项目为准 （机器契约除外，见项目框架 §0）。

环境依赖：Node.js 18+（仅 S5 HTML 原型预览/截图需要，可选）

可选委托（按项目配备，不强依赖）：截图归档委托 screenshot skill（详见 html-prototype.md）；外部发布由项目配备的发布 skill 处理，不在本 skill 内；Obsidian CLI 增强按需委托 obsidian-doc-structure / obsidian-link-audit / obsidian-safe-write， CLI 不可用时 fallback 到 Read / rg / Edit。

---

Workflow：六段骨架

「做什么」由本 skill 固定；「用什么形态做」读项目框架 §1 工序形态声明。

S1 理解      读上下文 + 维度推断 → 呈现理解摘要                    [固定]
S2 骨架确认  范围骨架（形态读框架 §1）→（启用图件时）结构图草稿
             → 章节预告（按框架 §3 裁剪）→（框架声明时）页面骨架    [形态可配]
S3 填充      按框架章节分波写，[待确认] 汇总一次问                  [章节/波次可配]
S4 落盘      机器契约段：触发词 → 路径/frontmatter/索引             [固定]
S5 附属产物  按框架 §1 声明执行（图件渲染 / HTML 原型 / 无）        [整段可配]
S6 发布      仅用户显式触发                                        [固定]

核心原则：AI 主动分析填充，用户确认补充。不确定的内容标 [待确认]，汇总后一次性 问用户。所有交付物中不保留需求确认过程标记（如"Q12"、"用户澄清 #2"），确认结论作为正常 需求点融入正文对应位置。

demo 先行变体（项目框架启用原型工序、且用户已有可交互 demo 时的标准路径）：

• S2 范围与结构草稿从 demo 反推（仍需用户确认——demo 可能只覆盖部分需求）；页面骨架 确认跳过（以 demo 为准）
• S3 交互细节直接读 demo 的 HTML / JS 提取（状态文案、禁用逻辑、显隐条件、状态机以 代码为准），对话记录仅作补充
• S5 改为归档——demo 复制到 prototypes/（不重新生成），删除 tmp/ 原件避免双源； 按需截图归档 assets/
• demo 本身的生成规范见 skill: html-demo

---

S1 理解