# Agent Skills

这是我日常使用的一组 agent skills。

我把反复遇到、又适合交给 agent 稳定处理的任务整理成了独立 skills。每个 skill 只处理一类问题：需要哪个就安装哪个，也可以按任务组合使用。

## 安装

运行：

```bash
npx skills add https://git.im0o.top/agent-skills/skills.git
```

安装程序会让你选择需要的 skills，以及要安装到哪些 agent。获取仓库前，可以先运行下面的命令检查本机是否有访问权限：

```bash
git ls-remote https://git.im0o.top/agent-skills/skills.git HEAD
```

命令返回 commit hash 就表示可以继续安装。

以后需要拉取新版本时运行：

```bash
npx skills update
```

> [!TIP]
> 安装后直接描述任务即可。agent 会在任务匹配时使用对应的 skill；你也可以明确说“用 `think-twice` 重写这份文档”。

## Skills

### 写作与上下文

#### [`think-twice`](./skills/think-twice/SKILL.md)

重写准备交付的文字，让没有参与过当前对话的人也能读懂并采取行动。它会先补齐和核实事实，再从结论开始重写，而不是只润色原稿。

适合文档、交接说明、PR 或 issue 正文，以及任何需要脱离当前对话独立成立的文字。

#### [`teach-me`](./skills/teach-me/SKILL.md)

当你面对陌生代码、隔了很久回到旧项目，或者想弄清 agent 刚完成的长任务时，让 agent 先自行查清事实，再一次讲明白一层内容。

它不会一次塞给你一篇长讲义。讲解会根据你的回复继续，直到你确认已经理解。

`think-twice` 负责把一份文字写得独立、准确；`teach-me` 负责通过来回交流把一件事真正讲懂。两者可以单独安装，也可以一起使用。

### 交付前审查

#### [`why-here`](./skills/why-here/SKILL.md)

在交付前对改动里每个可疑的部分问同一个问题：它现在为什么还在这里。完成后的结果仍然需要的留下，只因为做的过程走过某条路才存在的删掉，例如回应旧误解的说明、放弃方案留下的分支、迁移完成后仍在的临时字段。

它默认只审查和报告。文字按删掉后读者的理解会不会改变判断；代码、接口和数据结构要先查当前调用方、契约、已有数据和外部约束。公开接口、持久化数据和仍在使用的兼容路径需要你明确授权才会动。

`think-twice` 负责把文字写得独立可读；`why-here` 负责判断哪些内容还属于完成后的结果，范围同时包括文字和代码。

### Windows 工具

#### [`disk-master`](./skills/disk-master/SKILL.md)

只读分析 Windows 磁盘占用，找出最大的目录、文件和常见空间热点，并生成可交互的 HTML 报告。

它只负责扫描、解释和给出建议，不会删除文件、卸载软件或自动清理系统。

#### [`everything-file-search`](./skills/everything-file-search/SKILL.md)

通过 [Everything](https://www.voidtools.com/) 快速按文件名、扩展名或路径定位 Windows 上的文件和目录，适合搜索范围很大或目标位置不明确的情况。

使用前需要运行 Everything 桌面程序。这个 skill 负责查找文件位置，不负责搜索文件内容或理解代码语义。

### 图片转结构化数据

#### [`baimiao-table-ocr`](./skills/baimiao-table-ocr/SKILL.md)

把表格截图或扫描图片转换成 ASCII、Markdown、CSV、JSON 或 XLSX，适合提取账单、清单、报表和课程表等图片里的行列数据。

> [!WARNING]
> 图片会上传到白描的第三方服务进行识别。不要用它处理隐私敏感或不能离开本机的图片。

### 工作区初始化

#### [`init-workspace`](./skills/init-workspace/SKILL.md)

为个人执行工作区搭脚手架：创建目录骨架和 `.claude/skills` Junction，生成 `<project>.code-workspace`、`AGENTS.md` 与可选的 `CODINGRULES.md`。工作区模式是一个目录同时容纳源码仓库、本地文档库和参考库。

它只在你明确要求初始化或重构工作区时触发。已有文件不会被覆盖，改动会先逐节给出提案，确认后才写入。

## 常见用法

你可以直接对 agent 说：

- “用 `think-twice` 过一下这份交接文档，让没看过对话的人也能接手。”
- “我半年没碰这个项目了，先读代码，再用 `teach-me` 给我讲明白它现在怎么工作。”
- “分析一下 `C:` 盘为什么满了，只做只读扫描，并生成 HTML 报告。”
- “帮我找出这台 Windows 电脑上所有叫 `settings.json` 的文件。”
- “把这张表格截图转成 Markdown 表格。”
- “在 `E:\Projects\foo` 用 `init-workspace` 建一个工作区，源码仓是这个地址。”
oo` 用 `init-workspace` 建一个工作区，源码仓是这个地址。”
- “这次改动中途换过方案，提交前用 `why-here` 看看还有没有只属于旧方案的内容。”