iDWong 功能清单生成器
Step 1：扫描项目文档
并行扫描以下路径，找到 SRS 和可研报告：
Glob("dev/SRS/*.md")
Glob("docs/SRS/*.md") # 兼容旧根
Glob("docs/01-需求与规划/*SRS*.md") # 兼容更旧的归档路径
Glob("**/*需求说明书*.md")
Glob("prd/planning/*可行性研究报告*.md")
Glob("prd/planning/*可研*.md")
Glob("docs/规划/*可研*.md") # 兼容旧根
Glob("docs/01-需求与规划/*可研*.md") # 兼容旧归档路径
找到文档后告知用户，说明将从哪些文档提取数据。若两类文档都找到，以 SRS 为主数据源（字段更完整），可研报告补充建设类型字段。
门禁：若未找到 SRS 但存在 prd/PRD/*.md（或旧路径 docs/**/*-PRD.md） → Read ../common/prd-to-srs-gate.md，输出 §3 话术，中止，路由 req-doc Step F。
Step 2：提取功能清单数据
从文档中提取以下字段：
| 字段 | 来源 | 说明 |
|---|---|---|
| 所属系统 | SRS / 可研 | PC管理后台、移动端应用等；仅当系统数量 ≥ 2 时才包含此列 |
| 模块 | SRS / 可研 | 一级模块 |
| 子模块 | SRS | 二级模块（如有） |
| 功能名称 | SRS 页面功能清单（3.3节） | 具体功能点 |
| 功能描述 | SRS 页面功能清单（3.3节） | 功能说明 |
| 优先级 | SRS 需求功能清单（3.2节） | P0 / P1 / P2 |
| 备注 | - | 留空 |
提取规则：
- 功能粒度与 SRS 页面功能清单保持一致，不合并、不拆分
- 优先级从 SRS 需求功能清单按模块匹配，找不到则留空
- 所属系统列：扫描 SRS 页面功能清单，若只有一个系统（如只有 PC 管理后台），则不生成该列；若有 PC 管理后台 + 移动端等多个系统，则保留该列
提取完成后展示数据摘要（共 N 条，按系统分布），确认后进入下一步。
Step 3：询问导出格式
功能清单数据已提取完成，共 N 条功能。请选择导出格式：
1. xlsx（Excel 表格，适合筛选和编辑）
2. Word（.docx，适合正式文档交付）
Step 4A：生成 xlsx
xlsx 走服务端专用接口 /api/document/export/excel-from-data，不经过 export-word.sh，也不涉及图片嵌入（该脚本只支持 Word，图片规则只对 Word 生效）。
payload 必须用
data（二维数组，第一行是表头），不是headers+rows——2026-09-10 实测： 用headers/rows时接口仍返回 200 和合法 xlsx，但里面没有 worksheet，是个空壳文件。 用data格式验证通过：dimension A1:C4（标题 + 表头 + 2 行数据），共享字符串齐全。
从
../config.json读取apiBaseUrl将提取的数据组装为 JSON，调用服务端接口：
curl -s {apiBaseUrl}/api/document/export/excel-from-data \ -X POST \ -H "Content-Type: application/json" \ -d '{ "filename": "{项目名称}-功能清单-V1.0", "title": "{项目名称}功能清单", "freezeFirstRow": true, "autoFilter": true, "sheets": [{ "name": "功能清单", "data": [[表头行], [数据行...]] }] }' \ -o "dev/design/{YYYY-MM-DD}-{项目名称}-功能清单-V1.0.xlsx"导出成功后告知用户文件路径。
Step 4B：生成 Word
⚠️ 导出前后各一件事：① 图片必须放在文档同级的
images/子目录且文件名纯 ASCII——这是唯一可用形式，img/、images/sub/、../images/、与文档同目录、中文名全都静默丢图（脚本仍打印Export succeeded，但word/media/是空的）；② 导出后立刻验unzip -l <docx> | grep -c "word/media/"，数字必须等于图片张数。实测边界表见../common/README.md。
Word 走通用导出脚本，与 req-doc、feasibility-report 技能一致。
将数据写入 Markdown 中间文件：
dev/design/{YYYY-MM-DD}-{项目名称}-功能清单-V1.0.md格式参考references/md-template.md调用通用导出脚本：
bash ../common/export-word.sh <md文件路径> feature-list导出成功后告知用户文件路径。
文档命名规范
dev/design/{YYYY-MM-DD}-{项目名称}-功能清单-V1.0.{md|xlsx|docx}
修订：就地改也要改文件名。 不论体量大小一律就地 Edit 改（大文档尤其别整份重写，小文档也不要另存新文件）——目录里永远只留最高版本那一份；改完必须三样一起动——文首「文档版本」、版本记录表、mv 把文件名的版本号也改掉（局部修订 +0.1，结构性重写进大版本；日期取改动当天）。**绝不允许内容已是 V1.1、文件名还写 V1.0。**改名后 grep 一遍旧名，把 README 清单、下游「来源」行、tools/ 脚本里的引用一并改掉。完整规则见 ../common/README.md。
外部依赖与降级：Word/xlsx 导出
导出链走技能库根的 config.json 里的 apiBaseUrl（端点不随仓库分发，取值见该文件）。
| 情况 | 表现 | 怎么办 |
|---|---|---|
没配 config.json |
脚本报「无法从 config.json 读取 apiBaseUrl」 | 从同级 config.example.json 复制后填地址 |
| 服务没起 | curl 连不上 / 超时 |
先自检（在技能自己的目录下跑）：curl -s -o /dev/null -w '%{http_code}' "$(python3 -c 'import json;print(json.load(open("../config.json"))["apiBaseUrl"])')/"，连得上就行（/ 不是路由，返回 404 也算通；连不上才是服务没起），起服务后重试 |
| 两者都缺 | —— | 降级交 md，并在交付清单里写明「Word 未导出（端点未配）」 |
三条不许：不许把「导出失败」写成完成；不许跳过导出直接说交付完成；
不许在导出后不验图——unzip -l x.docx | grep -c 'word/media/' 要等于文档里的图片张数（文件名含中文会静默丢图）。