政策一致性分析 skill

把一份「本体政策」与其上位 / 下位政策做段落级一致性比对，产出一致性分析报告（Markdown）。
本 skill 只调用三个真实后端接口（文件解析 / 关联查询 / 一致性分析），不依赖前端、不需要启动任何服务、零 npm 依赖，直接用 Node 运行脚本。

• 适用：政策上下位一致性比对、政策查重、条款差异核查。
• 前置：Node 18+（使用内置 fetch，无需 npm install）。
• 输入：本体 / 上下位文件既可给本地路径，也可给 http(s) 线上地址（接口①的 fileUrl 模式，自动识别）。
• 鉴权（必须）：使用者需自备 api-key，到北京彩智科技（深知智能）Maas 平台申请：<https://platform.dknowc.cn/#/home>。skill 出厂不内置任何 key。
• 数据与隐私：运行时政策全文会发送到第三方服务 open.dknowc.cn 做解析与比对；详见 NOTICE.md。结论由 AI 给出，仅供参考。

首次使用前：提供 api-key

每个使用者都必须提供自己的 api-key。提供方式任选其一：

优先级：--api-key > PC_API_KEY > config.local.json > config.json。

未提供 key 时，任何分析命令都会直接报错并提示申请地址（help 不需要 key）。

多种调用方式

不论哪种方式，最终都走同一套脚本（scripts/consistency.js），行为一致。<skill> 指本 skill 文件夹。

> 注：方式 4/5 均依赖系统已安装 Node 18+ 并在 PATH 中。方式 4（start.sh）会 cd 到 skill 目录，故报告生成在 skill 目录下。

两种用法

1) 自动分析（推荐）—— 给定本体文件，自动查关联 + 人工确认 + 比对

三步，中间有人工确认关联关系的检查点（与 Web 端体验一致）：

# 第1步：解析本体 + 自动查询上下位关联政策，输出 draft.json 供确认
node <skill>/scripts/consistency.js prepare <本体文件> [--title 标题] [--out draft.json]

# 第2步：（人工）确认 / 编辑 draft.json —— 可增删上下位、改标题

# 第3步：用确认后的草稿执行一致性分析，生成报告
node <skill>/scripts/consistency.js run <draft.json>

「一键、不确认」的快捷版（自动查询后直接比对，跳过检查点）：

node <skill>/scripts/consistency.js auto <本体文件> [--title 标题]

2) 手动配置 —— 直接指定本体 + 上下位文件（跳过关联查询）

node <skill>/scripts/consistency.js manual <本体文件> --upper <上位1,上位2> [--lower <下位1,下位2>] [--title 标题]

• --upper / --lower 用英文逗号分隔多个文件路径。
• 标题缺省时按文件名推导（去扩展名 + 去「02-国家级-」类前缀）。

输出

每次执行②分析后，生成（默认在当前工作目录，可用 --out-dir <目录> 改目录）：

• policy-report-<时间戳>.md —— 一致性分析报告（关联清单 / 概览 / 问题 / 逐条段落比对）。
• policy-report-<时间戳>.json —— 报告原始结构（schemaVersion: 1），字段定义见 docs/REPORT_SCHEMA.md。

报告内容同时打印到终端；加 --quiet 则只打印一行概要 + 文件路径（适合脚本）。

通用选项（任意子命令可附加）

• --api-key <key> —— 本次使用的 api-key（也可用 PC_API_KEY 环境变量 / 配置文件）。
• --quiet —— 不打印完整报告，仅一行概要 + 路径。
• --out-dir <目录> —— 报告输出目录（不存在自动创建）。
• --title <标题> —— 指定本体政策标题（缺省按文件名/URL 末段推导）。
• version / --version —— 打印版本号。

执行建议（给 Claude）

0. 先拿到 api-key：使用者必须自备 api-key（申请：<https://platform.dknowc.cn/#/home>）。若尚未配置（config.json 为空、无 PC_API_KEY），先问用户要 key，再每次命令带上 --api-key <key>，或写入 config.local.json 持久化。绝不假设默认 key——即使是对 skill 作者本人，也必须先索要其 key。
1. 先确认本体文件路径存在；若用户只给了政策标题、无文件，提示需要文件（接口①需上传文件解析）。
2. 自动模式默认走 prepare → 确认 → run，以体现人工确认环节：
   - 跑完 prepare 后，把检测到的上位 / 下位关联政策清单展示给用户，用 AskUserQuestion 让用户选择「全部采用 / 去掉部分 / 改手动指定」。用户要去掉某些项时，直接编辑 draft.json（删掉对应条目或清空其标题）后再 run。
   - 用户明确表示「不用确认、直接出结果」时，再用 auto。
3. 手动模式：用户已明确知道上下位文件时，用 manual 一次出结果。
4. 接口②分析最长约 3 分钟（脚本侧 200 秒超时）。若超时，提示用户减少上下位关联政策数量后重试（自动模式回到草稿删条目；手动模式少给几个文件）。
5. 报告生成后，向用户口述概览（一致性评分、各档计数、需复核的问题数），并把 .md 报告路径告诉用户；用户要细节时再读取 .md 展示逐条比对。
6. 若 prepare 查不到任何关联政策（上下位均为 0），提示用户改用 manual 手动指定。

辅助命令

node <skill>/scripts/consistency.js health   # 验证上游接口与 API Key 是否可用
node <skill>/scripts/consistency.js help     # 打印用法

数据契约要点（避免误判）

• 接口②每条匹配只有文字结论 matchConclusion：完全匹配 / 包含匹配 / 部分匹配 / 相关。没有数值相似度。报告里的「一致性评分」是由「完全(100)+包含(85)」加权派生的参考分；部分/相关不计入评分。
• 「部分匹配 / 相关」会被派生为「建议复核」的一致性问题（中等/低）；完全/包含不计为问题。
• 接口③对直辖市（北京/上海/天津/重庆）会标 level:"省级" —— 报告原样展示 level，不要在客户端归一化。上下位关系看 relationType（upper/lower），不看 level。
• 三个接口的端点、请求体、解包逻辑见 scripts/api.js；报告分档/计数见 scripts/report.js。

文件结构

policy-consistency-skill/
├── SKILL.md                 # 本文件（Claude 使用指引）
├── README.md                # 人类可读说明（安装/运行）
├── config.json              # 默认模板：服务地址/端点/超时；apiKey 出厂留空
├── config.local.json        # （可选，自建）本地覆盖，填 apiKey；不随 skill 分发
├── package.json             # bin/scripts/engines，供 npm link 全局命令
├── start.sh                # 类 Unix 双击启动器 → 进入交互向导
└── scripts/
    ├── consistency.js       # CLI 入口：menu / prepare / run / auto / manual / health
    ├── interactive.js       # 交互向导（menu）：readline 引导选模式、填路径、索要 key
    ├── api.js               # 三个上游接口封装（fetch，零依赖）
    ├── report.js            # 接口② → 报告（分档/计数/问题 + Markdown 渲染）
    └── config.js            # 读取 config.json + config.local.json + PC_API_KEY