Policy Explain — 文件五维解读

概述

本技能解决一件事：说清一份文件对某个具体行业、某个具体岗位到底意味着什么。

把任意领域的政策、法规、规划、标准、办法、白皮书，按解读者的行业与岗位，用五维度框架转成可操作的结论。生成 Wiki 型知识网页只是可选的呈现方式，不是目的。不要为了把网页做得漂亮而稀释解读质量，也不需要等用户开口要网页才去做解读。

本技能不预设任何行业。解读视角由使用者本人在首次使用时声明并长期保存。

核心原则

解读的价值来自视角。同一份文件，医院科主任、企业合规经理、工程技术人员读出来的结论完全不同。因此每份解读都必须锚定一个明确的身份：

行业 + 单位类型 + 岗位 + 主要关切

通用化不等于中性化。把视角抹平成"人人都适用"的表述，输出的就是文件摘要，而不是解读。身份必须具体。

工作流

第 0 步：确认解读身份

1. 定位身份档案

档案是用户级个人配置，不绑定任何特定宿主的主目录。按下列优先级解析，取第一个可写位置：

解析纪律：

• 不得硬编码宿主主目录。同一份技能可能在 WorkBuddy、Codex、Claude Code 等不同宿主里运行，档案位置应由运行时环境决定。
• 路径中的用户名取当前登录用户，不要写死。Windows 上无法展开 %APPDATA% 时，用 <用户主目录>\AppData\Roaming\policy-explain\profile.json。
• 目录不存在则创建；不可写则回落下一优先级。
• 若落在技能目录内（第 3 处），必须确认该文件已被版本库忽略，绝不能把身份信息提交到仓库。本技能仓库已在 .gitignore 中忽略 .profile.json。
• 三档全部不可写（罕见，通常出现在只读挂载或权限受限环境）：不再尝试落盘，改为会话内记忆。在对话中记下身份并在后续步骤沿用，同时告知用户"本次身份仅在本会话有效，下次需重新声明"。

2. 档案不存在 → 引导用户填写

四项信息都要落到，可一次性提问：

引导语可直接使用：

> 先确认一下解读视角，这样结论才能落到你身上。四项即可：①所在或关注的行业 ②单位类型 ③岗位或角色 ④最关心什么（申报／考核／合规／技能／资源／工具）。一句话回答也行。

追问规则：若回答过于笼统（例如只答"教育""医疗"），追问一次，给出 2-3 个更具体的候选让用户选，不要替他假设。行业与岗位是后续全部结论的锚点，此处省一步，后面全是空话。

用户明确拒绝声明身份时：不要卡死在第一步。按"通用读者"降级推进，并在输出首行标注：

> 本解读未锚定具体岗位。第五维仅列文件明示的申报与激励口径，不含个性化建议。

降级只在用户明确拒绝时启用。用户只是答得不全（例如给了行业没给岗位），仍按上面的追问规则补问，不走降级。

3. 写入档案并回显确认

下面只是格式示范，实际写入用户本人声明的身份，不得沿用示例内容：

{
  "default": "智能制造·合规经理",
  "profiles": [
    {
      "name": "智能制造·合规经理",
      "industry": "智能制造与装备制造",
      "org": "民营制造企业",
      "role": "合规与质量经理",
      "concerns": ["体系认证与企业资质", "安全生产合规风险", "技改项目申报"],
      "created": "2026-01-01"
    }
  ]
}

4. 档案已存在 → 不重复询问

读出默认身份，一句话确认后直接进入解读。若默认身份与本次文件明显不符（例如身份是医疗，文件是旅游规划），问一句"本次按哪个身份解读？"，按次覆盖，不修改档案。

5. 支持多身份

同一人可保存多个身份（如"部门负责人""技术骨干""行业协会成员"），解读结论本就不同。用户可随时要求新增或切换。

> ✅ 检查点：把最终选定的档案路径与身份一句话一起回显给用户，得到确认后再进入第 1 步。身份是后续全部结论的锚点，这一步不能默认通过。

第 1 步：输入文件

用户提供：文件原文或链接、目标受众（默认取档案身份）、是否需要网页或 Word。

原文获取与降级

超长文件（正文超过约 3 万字或 50 页）：不要通读硬解。先按目录或一级标题切块，用与本次身份相关的关键词定位命中段落，只精读命中块及其上下文。输出时给出章节或条款坐标，便于用户回溯核对。

第 2 步：五维度解读

下表是骨架。「核心追问」「关键词」「受众之问」三列都要依据第 0 步声明的身份现场改写，示例列只示范改写方向，不是预设库，不可直接套用。

每个维度输出五项：

• 核心追问：引导思考的关键问题
• 关键词：3-5 个，从文件原文提取，不做领域臆测
• 受众之问：标签写成本次身份的口吻（如"科室主任的思考""合规经理的思考"），内容落到该身份的切身关切
• 解读：结合原文的详细分析，给出具体行动指向
• 结论框：一句总结性判断（💡格式）

表格化：凡存在"原文要点 → 行动指向"对照关系的，一律用表格呈现，不要写成连续段落。

维度 5 需区分个人视角与机构视角，两者可申报的东西不同。

> ✅ 检查点：五维解读完成后，先交付文本解读并确认结论可用，再询问是否需要网页或 Word。不要跳过确认直接生成网页。

第 3 步：可选输出 —— 生成 Wiki 网页

必读：先完整读取 references/README.md，它列出全部占位符的含义与可复用组件写法。占位符共 52 个，其中维度类占位符以 D1_… 至 D5_ 的区间形式给出，一行覆盖五个维度，表中字面写出的只有 28 个，实际需替换 52 处。

取骨架：读取 references/wiki-template.html，逐个替换其全部 52 个 {{占位符}}。五个维度区块（#d1 至 #d5）在骨架里已经写好，结构相同、只是占位符编号不同，不需要另行复制区块，替换完即为成品。

参照成品：不确定版式时读 references/example-education.html，它是唯一的完整样例。

不要加载 example-education.html 来抄内容。它是某个特定行业的样例，只用于确认版式；其中的行业用语必须全部替换。

生成要求：

1. 成品中不得残留骨架示例内容，也不得残留上一份解读的行业用语。
2. 页面包含：顶部导航、侧边目录（滚动高亮）、五个维度区块、原文与行动对照表、结论框、受众行动清单、响应式布局。
3. 版式遵循骨架（结构、层级、交互不变）。配色允许按受众气质微调，但不得使用青＋深色、紫蓝渐变这一类 AI 感配色。

成品保存到用户指定目录，文件名建议 <文件简称>_政策解读Wiki.html。

自由度说明：骨架只约束版式，不约束判断。解读内容按本次身份自由组织；占位符清单是必读的，但每个占位符填什么，由第 2 步的解读结论决定。

输出格式

默认交付文本解读。网页与 Word 是按需附加的呈现方式，第 2 步的解读质量才是本技能的核心产出。

反模式清单