93 lines
4.2 KiB
Markdown
93 lines
4.2 KiB
Markdown
# 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]
|
|
> 图片会上传到白描的第三方服务进行识别。不要用它处理隐私敏感或不能离开本机的图片。
|
|
|
|
## 常见用法
|
|
|
|
你可以直接对 agent 说：
|
|
|
|
- “用 `think-twice` 过一下这份交接文档，让没看过对话的人也能接手。”
|
|
- “我半年没碰这个项目了，先读代码，再用 `teach-me` 给我讲明白它现在怎么工作。”
|
|
- “分析一下 `C:` 盘为什么满了，只做只读扫描，并生成 HTML 报告。”
|
|
- “帮我找出这台 Windows 电脑上所有叫 `settings.json` 的文件。”
|
|
- “把这张表格截图转成 Markdown 表格。”
|
|
- “这次改动中途换过方案，提交前用 `why-here` 看看还有没有只属于旧方案的内容。”
|