hld-designlisted
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`**（库内权威副本）
# 概要设计说明书（HLD）生成器
## Agent 协作架构
```
hld-design skill（主流程：调度 + 文件写入）
├── design-analyzer agent（分析师，DOC_TYPE=hld）
│ 职责：读 SRS/代码/已有HLD，输出架构级摘要（模块/实体/接口分组/技术栈/部署/非功能映射）
│
├── design-writer agent（撰写者，DOC_TYPE=hld）
│ 职责：摘要 + 模板 → 架构级设计章节（允许技术词汇，禁止下沉到字段/单接口）
│
└── design-reviewer agent（审查者，DOC_TYPE=hld）
职责：五维度审查（结构完整性/分层边界/技术规范/可追溯性/设计质量）
时机：内容写入文件后统一运行 → 汇总 → 询问用户是否修复
```
**先写后审原则：** 生成内容写入文件 → 对变更章节运行 design-reviewer → 汇总报告 → 询问"是否修复？" → 用户确认后修复。
**核心约束：** HLD 写到模块/实体/接口分组级即止，字段级表结构、单接口明细、代码实现属于详细设计（LLD），不在此处展开。
## 工作模式
| 模式 | 触发场景 | 入口 |
|------|---------|------|
| **生成模式** | 从 SRS 生成 HLD | → Step A |
| **局部完善模式** | 补充/修改某章节 | → Step B |
| **审查修复模式** | 审查已有 HLD 并修复 | → Step C |
| **反向同步模式** | 根据已有代码更新 HLD | → Step D |
| **导出模式** | 导出为 Word 文档 | → 导出 Word 章节 |
---
## Step A: 生成模式
### A1: 扫描项目上下文
按优先级扫描，找到上游文档再开始：
| 优先级 | 文件类型 | 查找方式 |
|--------|---------|---------|
| 最高 | SRS需求规格说明书 | `Glob("**/*需求*说明书*.md")` |
| 高 | 设计方案 | `Glob("**/*设计*方案*.md")` |
| 中