菜单
历史需求资产归档入库：把项目外的原始需求资料（TAPD 单 / 飞书导出 docx / xls 清单 / 截图原型等异构收料）重整为 modules/ 体系下的现状基线 PRD + shared 事实源 + 溯源台账。九段流水线（Phase 0-8）：收料冻结 → 通读建模 → 方案拍板 → 骨架与 shared → PRD 回填 → 反向对账 → 原型校准 → 关联收口 → 审查清源。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/ryanzhao1011/workframe --skill requirement-archiving命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | requirement-archiving |
| description | 历史需求资产归档入库：把项目外的原始需求资料（TAPD 单 / 飞书导出 docx / xls 清单 / 截图原型等异构收料）重整为 modules/ 体系下的现状基线 PRD + shared 事实源 + 溯源台账。九段流水线（Phase 0-8）：收料冻结 → 通读建模 → 方案拍板 → 骨架与 shared → PRD 回填 → 反向对账 → 原型校准 → 关联收口 → 审查清源。 |
| when_to_use | - 用户提供一批历史需求原始资料（本地文件夹 / 网盘导出），要求「归档 / 入库 / 整理成 PRD」时； - 为已上线的生产功能补建 modules/ 需求事实源（现状基线形态）时； - 新建 basic / sub 模块并批量回填历史需求时。 边界：项目内已有 specs/ 下 md 的一次性搬迁 → migrate-to-modules；写全新需求 → prd-writer； 从代码反解实现现状 → code-to-doc。本 skill 只管「外部异构原始资料 → 需求事实源」。 |
| user-invocable | true |
| allowed-tools | ["Read","Write","Edit","Glob","Grep","Bash","AskUserQuestion"] |
document-norms §1（归属矩阵）/ §2（frontmatter 与时间戳）/ §3（overview 三段制）/ §11（写作纪律 + 交付前自查）.claude/skills/prd-style/SKILL.md（章节结构 / 各章写法 / 标注习惯的项目层事实源，装机放入；缺失时 fallback 读 core templates/project-skills/prd-style/SKILL.md——与 prd-writer 同机制）+ prd-writer writing-guide.md（通用写作纪律）module-init（建骨架）与 module-index-refresh（索引刷新）——作为被调用件，不重复其职责html-demo（Phase 6 原型校准的执行引擎，有 UI 的需求才需加载）projects/specs/_meta/taxonomy.md（tags 受控词表，如项目维护；缺失时 check_archive 自动跳过词表检查）pip install python-docx pdfplumber pypdfium2 openpyxl xlrd Pillow
缺库不中断收料——对应格式文件在 inventory 备注标「缺哪个库怎么装」，装完重跑即可外部异构原始资料 → modules/ 需求事实源 的唯一工作流。三个近亲的分工：
| skill | 输入 | 本 skill 的关系 |
|---|---|---|
migrate-to-modules | 项目内已有的 specs/ md | 不重叠——那是搬迁，这是重建 |
prd-writer | 新需求共识 | 复用其写作规范；工作流不同（归档无「澄清需求」阶段，只有「对账原文」） |
code-to-doc | 代码仓 | 互补——本 skill 建意图基线，code-to-doc 建实现现状 |
核心形态约定：已上线需求写成现状基线（frontmatter status: shipped、验收标准章改为「现状口径（回归参照）」checkbox）；未开发需求写成规划稿（draft）。PRD 正文只写当前生效的规格——废弃方案不进正文，过程性中间记录用完即删。
0 收料冻结 → 1 通读建模 → 2 方案拍板 → 3 骨架与shared → 4 PRD回填 → 5 反向对账 → 6 原型校准 → 7 关联收口 → 8 审查清源
每阶段有门禁，过不了不进下一阶段。
scripts/extract_assets.py <源目录> <工作目录> 产出：文件清单、模态矩阵（文字/图片/表格/外链/二进制）、逐文件正文、全部内嵌图片（无损）、外链清单<工作目录> = 项目临时加工区 tmp/req-archive-<slug>/（不进 git）。它只是中转：Phase 4 回填时把选用图片从工作目录归位到资产包 assets/，Phase 8 审查清源后随任务清理工作目录prd-style；项目存量 PRD 风格趋同（≥3 份）而 prd-style 仍是出厂默认版时，提议先走 prd-writer §风格定制与萃取再回填module-init 建 basic / sub / 需求资产包（批量时可自写简单循环调用——框架不提供现成批量脚本；占位符替换与 meta 状态必须逐一落实）description，调 module-index-refreshscripts/check_archive.py <模块路径> 自查assets/，图中规格必须转写进正文（图是证据，不是正文的替代）归档产物是「文档说应该怎样」，线上是「实际怎样」。用截图建仿真 demo 是把两者对上的唯一有效手段——某次 16 份 PRD 的归档实战中，这一步校准出 30 处偏差：既有文档写了但线上没做的（已停用页签的专属列），也有线上做了但文档全无记载的（列表刷新入口、步骤区可折叠、已关闭项仍可启用）。
prototypes/ + 同步 PRD。不要攒到最后一起做，差异会淹没在批量里html-demo skill 口径：自包含单文件、复刻截图视觉、全状态可达、落 tmp/ 就地迭代、拍板后归档 prototypes/index.html 并删 tmp 原件sync_method: dev-paste + 注释说明，避免 stale 巡检误报doc-graph-health 全库巡检，确认本模块零断链零孤儿projects/changelog.md；遗留待确认项建 board task（走 task-management 口径）<sub>/others/ 或留原位）。
选它必须当场定主次：原件标注「原始资料，不再维护，事实源见 <产出路径>」，台账同步记一行。
不标的话就是两份同主题内容并存，半年后漂开了没人知道该信哪份——比删错更难查| 脚本 | 用法（插件根从 plugin-root.txt 取，不依赖 PATH） | 产出 |
|---|---|---|
scripts/extract_assets.py | python "$(cat .claude/workframe-state/plugin-root.txt)/skills/requirement-archiving/scripts/extract_assets.py" <源目录> <工作目录> | inventory.md 模态矩阵 / text/ 逐文件正文 / images/ 无损图片 / links.md 外链清单 |
scripts/check_archive.py | python "$(cat .claude/workframe-state/plugin-root.txt)/skills/requirement-archiving/scripts/check_archive.py" <projects/modules/<basic>> | 终端报告：frontmatter、tags 词表（无 taxonomy 自动跳过）、禁用标签、AI 病灶、wikilink 与图片断链、孤儿图、AUTO-INDEX 配对 |
索引刷新不在本 skill 脚本内——调 core module-index-refresh，避免双实现。