cheatsheet-compare

name	cheatsheet-compare
description	比较本仓库任意两个 cheatsheet 的内容差异、定位差异、优劣对比，并给出综合评价和适用场景推荐。**当用户提到"对比两个工具"、"比较 xxx 和 xxx"、"哪个更好"、"二选一推荐"、"差异在哪"、"选哪个"时，必须使用此技能。**无论用户是否明确说要生成对比报告，只要是涉及两个工具的选择、对比、二选一的情况，都应该调用此技能来提供结构化的对比分析。

cheatsheet-compare

对 cheatsheets/<topic-a>/ 和 cheatsheets/<topic-b>/ 进行多维度结构化对比，输出可辅助决策的对比报告。

核心产物

结构化对比报告，包含：

• 基本信息对比
• 定位差异分析
• 功能矩阵对比
• 优劣势对比
• 适用场景推荐
• 综合评价与二选一建议

兼容性

• 依赖文件读取能力
• 依赖 assets/report-template.md 模板（如需参考格式）
• 必要时可调用 web-search 核对版本信息

触发条件

满足任一场景时触发：

• 用户明确要求"对比"、"比较"两个 cheatsheet topic
• 用户询问"xxx 和 xxx 哪个更好"、"二选一推荐"
• 用户要求分析两个工具的"差异"、"区别"
• 用户要求做"优劣对比"、"全方位对比"

不触发本技能的场景：

• 用户只要求评审单个 cheatsheet 的质量（转交 cheatsheet-review-skill）
• 用户要求更新单个 cheatsheet（转交 cheatsheet-update）
• 用户要求创建新 cheatsheet（转交 cheatsheet-maker）
• 用户要求补标签、补图标等单项维护任务（转交对应技能）

输入参数

必须明确两个目标 topic：

• topic-a：第一个要比较的主题目录名（不含路径）
• topic-b：第二个要比较的主题目录名（不含路径）

用户可以用以下方式表达：

• "对比 bash 和 zsh"
• "比较 x-cmd 和 oh-my-zsh 的优劣"
• "npm vs yarn 选哪个好"

执行流程

1. 解析 topic 名称

从用户输入中提取两个 topic 名称，然后在 cheatsheets/ 目录下匹配。

2. 读取目标 cheatsheet

对每个 topic 分别读取：

• cheatsheets/<topic>/<topic>.md（主内容）
• cheatsheets/<topic>/meta.yml（元数据）
• cheatsheets/<topic>/refmap.md（参考来源）

若任一 topic 不存在：

• 若另一个 topic 存在，询问用户是否要对比已存在的 topic 与另一个不存在的 topic
• 若两个都不存在，返回错误并列出可用 topic 供用户选择

3. 提取对比维度（7-8 个通用维度）

维度	说明
定位	这是什么工具，解决什么问题，目标用户是谁
核心能力	主要功能模块、命令集、API 能力
安装方式	支持的平台，安装难度
配置复杂度	初始配置难度，定制化程度
性能特征	资源占用、启动速度、执行效率
扩展生态	插件系统、主题、模块市场
学习曲线	上手难度，文档质量
维护状态	版本活跃度，更新频率

4. 定位差异分析

• 读取两个 topic 的 meta.yml 的 desc 字段
• 读取两个 topic 正文的"定位"相关段落
• 判断两个工具是否解决同一类问题
• 判断两个工具是否可以直接替代，还是解决不同层面的问题

5. 功能矩阵对比

按以下分类逐项对比：

• 通用能力：安装平台、依赖要求、配置文件格式
• 日常高频：日常使用的核心命令、交互方式
• 扩展生态：插件数量、主题数量、社区活跃度
• 自动化支持：脚本化能力、API 接口、CI/CD 集成
• 运维能力：调试功能、日志输出、错误处理

6. 优劣势提炼

基于两个 cheatsheet 的内容，分别提炼：

优势项（每个 topic 不超过 5 条）：

• 该工具明显优于对方的地方
• 必须是正文或官方资料中有依据的

劣势项（每个 topic 不超过 5 条）：

• 该工具明显弱于对方的地方
• 必须是正文或官方资料中有依据的

7. 适用场景推荐

给出 3-6 个典型场景，判断每个场景下哪个工具更合适：

场景	推荐	理由
场景描述	topic-a / topic-b / 两者皆可	简要说明

8. 综合评价

给出 2-3 句总结性评价，说明：

• 两个工具的核心差异是什么
• 各自最适合什么样的用户群体
• 不存在绝对优劣，只有场景适配

9. 输出报告文件

将对比报告写入文件：cheatsheet-compare/<任务名称>.md

• 任务名称 由两个 topic 名称拼接而成，格式为 <topic-a>-vs-<topic-b>
• 例如：对比 agent-browser 和 playwright-cli 时，文件名为 agent-browser-vs-playwright-cli.md
• 目录 cheatsheet-compare/ 位于项目根目录下，与 cheatsheets/ 同级
• 报告内容采用上述固定结构

输出格式（固定结构）

# <topic-a> vs <topic-b> 对比报告

## 基本信息

| 属性 | <topic-a> | <topic-b> |
|------|-----------|-----------|
| 定位 | xxx | xxx |
| 版本 | xxx | xxx |
| GitHub | xxx | xxx |
| 维护状态 | 活跃/维护中/已停更 | 活跃/维护中/已停更 |

## 定位差异

<2-4 段说明两个工具在定位上的差异>

## 功能矩阵

| 维度 | <topic-a> | <topic-b> |
|------|-----------|-----------|
| 安装平台 | | |
| 核心能力 | | |
| 配置方式 | | |
| 扩展生态 | | |
| 学习曲线 | | |

## 优势对比

### <topic-a> 的优势

- 优势 1
- 优势 2
- ...

### <topic-b> 的优势

- 优势 1
- 优势 2
- ...

## 劣势对比

### <topic-a> 的劣势

- 劣势 1
- 劣势 2
- ...

### <topic-b> 的劣势

- 劣势 1
- 劣势 2
- ...

## 适用场景

| 场景 | 推荐 | 理由 |
|------|------|------|
| 场景 1 | | |
| 场景 2 | | |
| ... | | |

## 综合评价

<2-3 句总结性评价>

## 参考来源

- <topic-a>：`cheatsheets/<topic-a>/<topic-a>.md` 和 `refmap.md`
- <topic-b>：`cheatsheets/<topic-b>/<topic-b>.md` 和 `refmap.md`

自检清单

• 两个 topic 都存在于 cheatsheets/ 目录下
• 对比维度覆盖定位、功能、使用体验、生态（7-8 个维度）
• 优势和劣势各有依据，来源于正文或 refmap
• 适用场景不少于 3 个
• 输出格式完整，不缺少任何固定栏目
• 使用简体中文输出
• 报告文件已保存至 cheatsheet-compare/<topic-a>-vs-<topic-b>.md

协作边界

• 本技能只做对比分析，不修改任何 cheatsheet 内容
• 本技能不做单个 topic 的质量评审
• 如用户要求对比的 topic 不存在，优先使用现有 cheatsheet，无则转交 cheatsheet-maker 创建