req-doclisted
Install: claude install-skill iDWong/pm-skills
> **⚠️ `.agents/` 是外部资源包路径,本机已不存在**(`Documents/Claude/Product/.agents/` 已删除)。
> 下文凡引用 `.agents/knowledge/`、`.agents/agents/`、`.agents/agent-memory/` 的地方**读不到文件**,
> 按以下降级处理,**不要因此中止**:
> - `.agents/knowledge/**`(内容规范、质量清单)→ 用本技能 `references/` 下的模板与检查表;两者都缺时按通用工程规范执行并在产出里标注「无内容规范可依」
> - `.agents/agents/*.md`(子 Agent 派发)→ 不派发,由当前会话直接执行该角色的工作
> - `.agents/agent-memory/**`(跨会话记忆)→ 跳过读写,改为在产出里写清本次的决定
> - `.agents/rules/prd-to-srs-gate.md` → **已迁到 `../common/prd-to-srs-gate.md`**(库内权威副本)
# SRS需求规格说明书生成器
## Agent 协作架构
```
req-doc skill(主流程:调度 + 文件写入)
├── req-analyzer agent(分析师)
│ 职责:读取设计文档/代码/已有需求,输出结构化功能摘要
│ 输出:字段表、业务规则、枚举值、依赖关系
│
├── req-writer agent(撰写者)
│ 职责:摘要 + 规范 → 符合 PRD 语言的 Markdown 章节
│ 约束:只写"做什么",不写技术实现,不写 UI 布局
│
├── req-reviewer agent(审查者)
│ 职责:四维度独立审查(语言规范/章节结构/三要素/提示文案)
│ 时机:**按 AGENTS.md「交付模式」** — 标准模式下 A6 **抽检**(非全量);严格模式全量审查
│ → 汇总审查结果 → **P0 自动修复**;P1/P2 按模式决定是否询问用户
│
└── template-analyzer agent(模板提炼器)
职责:分析已有需求说明书,提炼可复用模板
输入:docling 转换后的 Markdown 全文
输出:分析摘要 + 完整模板文件内容
仅由 Step E(模板生成模式)调用
```
**审查策略(见 `AGENTS.md`「交付模式」;**本技能未声明时默认「标准」**):
| 模式 | A6 / B6 / C / D 审查 | 修复 |
| --- | --- | --- |
| **标准**(默认) | 结构性章节主流程对照模板;3.5.x **抽检** req-reviewer(见 A6) | **P0 自动修**;P1/P2 汇总后 **问一次**「是否一并修复 P1?」 |
| **严格** | 全部 3.5.x 并行 req-reviewer | P0/P1/P2 均展示报告后等用户确认再修 |
| **快速** | 仅结构性检查 + 禁用词 grep(不调用 req-reviewer) | P0 自动修;P1/P2 仅列表,不主动修 |
**生成模式写入阶段(A5)仍不穿插 reviewer**;审查集中在 A6 一次完成。