Rewrite README for skill users

README.md

@@ -1,50 +1,83 @@
-# agent-skills
+# Agent Skills
 
-从一个入口按用途选择并安装 im0o 的 agent skill。
+这是我日常使用的一组 agent skills。
+
+我把反复遇到、又适合交给 agent 稳定处理的任务整理成了独立 skills。每个 skill 只处理一类问题：需要哪个就安装哪个，也可以按任务组合使用。
+
+## 安装
+
+运行：
 
 ```bash
-npx skills add ssh://gitea/agent-skills/skills.git
+npx skills add https://git.im0o.top/agent-skills/skills.git
 ```
 
-会出现一个按用途分组的多选列表。可以选择整组，也可以只勾选其中几个 skill。仓库是
+安装程序会让你选择需要的 skills，以及要安装到哪些 agent。
-私有的，`skills add` 使用系统 Git 克隆；本机的 SSH key 能访问该仓库即可，不需要另外
-配置安装凭据。
 
-## 目录里有什么
+这个仓库是私有仓库，安装时会调用系统 Git。请先确认本机已经配置 `git.im0o.top` 的访问凭据。连接失败时，可以先运行下面的命令检查访问权限：
 
-| 组 | skill | 做什么 | 平台 |
+```bash
-|---|---|---|---|
+git ls-remote https://git.im0o.top/agent-skills/skills.git HEAD
-| Writing Clarity | `think-twice` | 重写一段输出,让它脱离上下文也能读懂,每条声明都经过验证,不留只在写作过程中有意义的内容 | 任意 |
+```
-| Writing Clarity | `teach-me` | 对接上下文:长任务跑完、隔久回到旧项目、面对陌生代码时,先自己探索,再一轮讲一层 | 任意 |
-| Windows Tools | `disk-master` | 只读扫描磁盘占用,解释盘为什么满了,生成可交互 HTML 报告 | Windows |
-| Windows Tools | `everything-file-search` | 借 Everything 的 IPC 按文件名和路径极快定位文件 | Windows,需要 Everything 在跑 |
-| Image To Data | `baimiao-table-ocr` | 表格截图转 CSV / JSON / Markdown / XLSX | 任意,需要网络 |
 
-`think-twice` 和 `teach-me` 各自完整,单独装任何一个都能用,不存在跨 skill 的文件
+命令返回 commit hash 就表示 Git 可以访问这个仓库。
-依赖。放同一组是因为它们互相交接:`think-twice` 重写一次仍然没打中的时候转给
-`teach-me`,`teach-me` 遇到会活得比对话久的内容时交给 `think-twice` 过一遍。两个都
-装上,这两条路才通。
 
-`baimiao-table-ocr` 会把图片上传到第三方服务。隐私敏感的图不要用它。
+以后需要拉取新版本时运行：
 
-## 这个仓和源码仓的关系
+```bash
+npx skills update
+```
 
-`skills/` 下的五个目录是真副本,不是子模块也不是软链接。原因在
+> [!TIP]
-`vercel-labs/skills` 的两处代码:`git.ts:241` 的克隆没有 `--recurse-submodules`,
+> 安装后直接描述任务即可。agent 会在任务匹配时使用对应的 skill；你也可以明确说“用 `think-twice` 重写这份文档”。
-子模块目录克隆出来是空的;`plugin-manifest.ts:89` 会跳过 marketplace.json 里的
-远端来源,只认仓内的本地路径。
 
-各自的源码仓在同一个 org 下:
+## Skills
 
-| skill | 源码仓 | 仓内路径 |
+### 写作与上下文
-|---|---|---|
-| `think-twice` | `agent-skills/think-twice` | `skill/` |
-| `teach-me` | `agent-skills/teach-me` | 仓根 |
-| `disk-master` | `agent-skills/disk-master-skill` | `skill/` |
-| `everything-file-search` | `agent-skills/everything-skill` | `everything-file-search/` |
-| `baimiao-table-ocr` | `agent-skills/img2excel-skill` | `skills/baimiao-table-ocr/` |
 
-改动在源码仓完成，分发仓只承载可安装副本。源码仓发布正式 `v*` tag 并生成 Release
+#### [`think-twice`](./skills/think-twice/SKILL.md)
-ZIP 后，分发仓按 `.dist-sync/sources.json` 白名单同步 latest Release。当前只自动同步
+
-`think-twice`；其余四个 skill 具备标准 Release 后再逐项加入。白名单来源尚无 latest
+重写准备交付的文字，让没有参与过当前对话的人也能读懂并采取行动。它会先补齐和核实事实，再从结论开始重写，而不是只润色原稿。
-Release 时会跳过并保留现有副本。
+
+适合文档、交接说明、PR 或 issue 正文，以及任何需要脱离当前对话独立成立的文字。
+
+#### [`teach-me`](./skills/teach-me/SKILL.md)
+
+当你面对陌生代码、隔了很久回到旧项目，或者想弄清 agent 刚完成的长任务时，让 agent 先自行查清事实，再一次讲明白一层内容。
+
+它不会一次塞给你一篇长讲义。讲解会根据你的回复继续，直到你确认已经理解。
+
+`think-twice` 负责把一份文字写得独立、准确；`teach-me` 负责通过来回交流把一件事真正讲懂。两者可以单独安装，也可以一起使用。
+
+### 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 表格。”