requirement-doc-writer

Requirement Doc Writer

在 lifecycle 判定 PRD Ready 之后，把已关闭的需求组装成一份人能读懂、能评审的 PRD。已有澄清、现状盘点与范围关闭材料、所有需求点已有确定口径时进入本技能。

硬约束（先读，全程适用）

1. Ready 是门，不是措辞。 只消费带 product、version、scope、closure_table_revision、behavior_inventory_revision、issued_at 绑定的 lifecycle-issued PRD Ready；绑定不匹配或输入变化时回 lifecycle 重判。任一 P0 行不是 closed、或 Ready 条件任一不满足，不得生成 PRD。用语本身不决定状态，关闭表语义才是门。
2. PRD Not Ready 时不得输出 PRD 标题、目录、骨架、模板或正文；WIP、讨论稿、会议材料也不得命名为 PRD。此时只输出产品决策视图并保留机器账本引用，不删底层审计字段。
3. writer 不改事实。 不得修改推导、决策权、决策证据或行状态；不得把 human-decision 字段改成自动确定；不得设置整行 closed。
4. writer 不做技术设计。 不得设计 Agent 技术 schema、prompt/model policy、tool contract 或 eval 实现——分别转 llm-inference-integration、架构/技术栈 owner 与 testing-strategy；writer 只检查命名引用、适用版本、owner 和逐条可追踪性在机器侧是否完整。
5. 不冒充设计 owner。 UI/用户可见产品的 IA、交互、页面状态和原型由 product-ui-ux-design 产出或审核，writer 只转写已确认内容。

安全 4 问（命中即阻断）

PRD 涉及身份、计费、配额、租户/用户隔离、权限、删除、覆盖时，文档必须有"安全与滥用"小节，逐条写安全 4 问的答案；无命中则显式记"无安全敏感输入"，命中后仍记"无命中"为违规。作答前必须先读取 references/security-four-questions.md（问题本体与落点细则 canonical），并在产物中写明所依据的 canonical 文件名 security-four-questions.md（实测：要求一段固定字样的旧写法命中率仅 20.5%，而逐项作答与写明来源文件分别可达 82% / 59%——本仓无法机械校验运行时产物，故只要求可核的实质，不要求不可核的字面戳）；凭记忆或转述作答、未写明来源、或命中后仍记"无命中"，均为违规。读取不可得时（本会话无文件读取工具 / 文件缺失 / 读取失败）走这条路径，不得声称已读：改写 依据: 不可得(<原因>)；按常驻反射尽力作答、本节标 interim 并写出解除方式，缺口连同风险标签交 feature-risk-router，由风险 owner 决定是否接受推迟——接受的是推迟、不是关闭：本节转正式关闭仍须真实读取 canonical 后逐项重答；agent 与需求提出方均不得自行判为已关闭。always-on 常驻反射见 agent-context/session-start.md「设计期安全 4 问」；本节只定义产物落点与交接。

命中后 PRD 只完成需求表达；风险标签/gate 交给 feature-risk-router，研发生命周期交给 product-rd-workflow。

产出

生成前读取 references/requirement-closure-contract.md。通过门后组装人读 PRD：先帮读者建立产品认知，再表达已关闭的产品决定、业务规则、边界和验收。 正文先回答三问：

1. 这是什么产品：区分目标/非目标用户、触发问题/一般愿望、可观察结果/宣传口号，并写出价值、P0 结果和至少一个明确非目标。只替换产品名仍适用于大量无关产品的句子不合格。
2. 有哪些产品模块或等价结构：模块按稳定产品能力、业务责任或价值流定义，参与端到端状态或结果变化，并说明作用、输入、输出、上游和下游。不得按路由、菜单、页面或弹窗定义模块；页面必须映射到模块，删掉页面名后说不清产品责任或结果的不是模块。非页面型产品可用能力地图、价值流、角色责任或状态流，但必须说明责任边界、关系和端到端运行，不得虚构模块或页面。
3. 产品如何端到端运行：主链路，以及关键异常、纠错和回退。