steelan9199 技能文档冗余体检
功能概述
对目标技能的 SKILL.md 主文档进行语义级冗余分析，识别跨章节重复、表格信息重叠、概念反复阐述、流程步骤重叠等问题，输出结构化诊断报告（含重复点定位、严重度、精简建议、优先级排序、预计缩减比例）。
核心特性与边界
| 特性 | 说明 |
|---|---|
| 检查范围 | 默认仅扫描目标技能的 SKILL.md 主文档；references/ 目录按需扫描（用户主动提及才扫） |
| 成果形态 | 仅诊断报告（重复点定位 + 精简建议），禁止调用 Edit/Write 修改目标文档 |
| 分析方式 | 纯 AI 专家语义分析，无脚本；能识别"5 个小节反复讲同一件事"等深层语义重复，而非机械文本比对 |
| 扫描对象限制 | 仅扫描 .md 文档，不读取 .js 脚本、.json 配置及二进制文件 |
| 短文档处理 | 若目标 SKILL.md 过短（< 50 行），冗余空间有限，报告中如实说明 |
标准工作流程
| 步骤 | 执行动作 |
|---|---|
| 1 | 确认目标技能路径（若用户未提供，主动询问"请提供目标技能的 SKILL.md 绝对路径"） |
| 2 | 使用 Read 工具读取目标 SKILL.md 全文 |
| 3 | 按「冗余检测维度清单」逐项扫描，识别所有重复/冗余点 |
| 4 | 按「诊断报告输出规范」生成结构化报告 |
| 5 | 输出报告并附固定尾部提示（见「诊断报告输出规范」第四部分） |
冗余检测维度清单（分析 rubric）
每发现一处冗余，记录其【定位 / 重复内容摘要 / 严重度 / 精简建议】。
维度 1：跨章节内容重复
同一段能力描述、同一规则、同一说明在多个章节反复出现。
- 典型：「功能概述」罗列所有能力，「脚本索引清单」又列一遍，「触发映射」第三次列举
- 检测信号：同义句群在不同 H2/H3 标题下重复
维度 2：表格信息重叠
两张或多张表的内容高度重叠，仅表述角度略异。
- 典型：身份对比表 A（身份/Token/操作范围/默认）与凭证类型表 B（凭证类型/归属身份/作用/有效期）实质重复
- 检测信号：多张表出现相同列或同义列，行数据可互相推导
维度 3：概念反复阐述
同一概念在多个小节反复解释，未做增量信息。
- 典型：「应用 vs 用户隔离」「两种 token 对比」「默认用 tenant」在 5 个小节里反复出现
- 检测信号：同一核心信息点在 3+ 个小节出现，且后文未补充新约束
维度 4：流程步骤重叠
「标准执行流程」「公共规则」「前置条件」三类章节相互覆盖。
- 典型：标准流程的"读参考文档/写参数文件/清理 temp"步骤与公共规则完全重叠
- 检测信号：步骤型章节的条目能在规则型章节找到一一对应
维度 5：触发词与索引重复
「触发映射表」与「文档索引表」逐行对应，信息高度冗余。
- 典型：左列触发词+脚本，右列又把同样的 references 文档列一遍
- 检测信号：两张表的行数、文档链接高度一致，可合并为一张表
维度 6：命令/代码块重复
同一条流程性命令、同一段代码在多处出现（区别于维度 8 的数据型示例）。
- 典型：
npm install命令在「环境说明」「全局前置条件」两处出现 - 检测信号：相同命令字符串重复 ≥ 2 次
维度 7：定义性内容重复
同一术语/缩写在多处重复定义。
- 典型："$SKILL_DIR 是占位符不是环境变量"在多个章节反复提醒
- 检测信号：同一术语定义出现 ≥ 2 次
维度 8：示例重复
同一 JSON 数据示例、同一配置片段多次出现。
- 典型：config 修改示例在「切换身份」和「token 获取」中重复
- 检测信号：相同代码块内容重复
维度 9：前置条件与环境说明重复
「环境说明表」与「全局前置条件表」的条目交叉重叠。
- 典型：依赖安装、目录说明在两张表都出现
- 检测信号：两表存在同义行
维度 10：章节内冗余表述
单个小节内同一信息用不同措辞重复表达，无新增信息。
- 典型：先表格说明，再用段落把表格内容复述一遍
- 检测信号：段落内容可由同节表格完全推导
诊断报告输出规范
报告必须严格遵循以下结构与格式。
报告标题
# 技能文档冗余诊断报告：<目标技能名>
第一部分：总览
## 总览
| 项目 | 值 |
| ---------------- | ------------------------------- |
| 扫描文件 | <SKILL.md 绝对路径> |
| 文档总行数 | <N> 行 |
| 发现冗余点 | <M> 处 |
| 预计可缩减 | 约 <X>%（<Y> 行） |
| references 扫描 | 未扫描 / 已扫描 <Z> 个文件 |
第二部分：冗余点详情（按维度分组）
按维度 1~10 分组，每个维度下列出具体冗余点。每条格式：
### 维度 X：<维度名>
#### 冗余点 X.1：<简短标题>
- **定位**：<章节名>（L起-L止） + <对比章节名>（L起-L止）
- **重复内容摘要**：<哪些内容在重复>
- **严重度**：🔴 高 / 🟡 中 / 🟢 低
- **精简建议**：<具体怎么合并/删除/改写>
严重度判定标准：
- 🔴 高：整段/整表重复，删除后信息零损失
- 🟡 中：部分重复，合并后需少量改写保完整
- 🟢 低：表述重复但各有少量增量，需谨慎合并
第三部分：精简优先级排序
## 精简优先级排序
按"收益/风险比"从高到低排序，建议按此顺序处理：
| 优先级 | 冗余点 | 预计缩减 | 风险 |
| ------ | ------------ | -------- | ---- |
| P0 | <冗余点标题> | <N 行> | 低 |
| P1 | ... | ... | ... |
第四部分：尾部提示（固定输出）
## 后续选项
- 本报告**仅诊断，未修改原文档**。
- 如需扫描 `references/` 目录下的参考文档（检测文档间交叉重复），请回复"扫描 references"。
- 如需我**直接动手精简**目标文档（按本报告的建议执行），请在主对话中确认，将由主对话执行。
分析原则
| 原则 | 说明 |
|---|---|
| 语义优先 | 以"语义是否重复"为判断依据；同一信息换措辞重述也算冗余 |
| 信息零损失 | 精简建议必须保证删除/合并后信息无损失。若合并会丢失增量信息，标注为"需谨慎合并"并说明哪些增量需保留 |
| 客观定量 | 定位必须给行号范围，缩减比例必须给数字，避免"有不少重复"这类模糊表述 |
| 区分增量 | 当某处在重复之外还补充了新约束/新细节，报告中需明确指出"该处除重复外还含增量信息：<具体增量>"，不可一刀切删除 |
与主对话的协作边界
| 场景 | 本技能动作 | 主对话动作 |
|---|---|---|
| 用户要求"检查冗余" | 输出诊断报告 | — |
| 用户看完报告后要求"直接精简" | —（技能已结束） | 由主对话调用 Edit 执行精简 |
| 用户要求"扫描 references" | 追加扫描并补充报告 | — |
| 用户要求"精简后重新检查" | 重新扫描并出报告 | — |