中文 | English
# suyuan-skill 我是夙愿（X：[@suyuan1711](https://x.com/suyuan1711)），在一家 AI 创业公司做 Agent 产品。这里是我反复打磨的精品 Skill，会一直更新。 Skill 就是一份写给 agent 的说明书：装上以后，你说到相关的事，agent 会照着它来干。 | 你碰到的事 | 用哪个 | |---|---| | 看不懂一个概念，或者 agent 甩过来一屏又一屏的字读不进去 | [whatis](#whatis) | | AI 交出来的东西挑不出错，可也没什么用 | [break-ai-slop](#break-ai-slop) | | 想把 Get 笔记里的录音和笔记整个搬到自己电脑上 | [get-biji](#get-biji) | | 想把一个视频、播客或者手机里的录音转成文字 | [get-biji](#get-biji) | | 被 Claude 封过号的电脑，想先备份、再把本机的 Claude 记录清干净 | [claude-cleanup](#claude-cleanup) | | Claude Code 一开局上下文就很大，想关掉用不上的工具和插件 | [claude-cleanup](#claude-cleanup) | ## 安装 先装好 [Node.js](https://nodejs.org)，下面的 `npx` 是它自带的。 全装（会让你勾选要哪几个）： ```bash npx skills add suyuan2022/suyuan-skill -g ``` 只装一个，比如 whatis： ```bash npx skills add suyuan2022/suyuan-skill -g --skill whatis ``` `-g` 是装到你的用户目录，所有项目都能用；不加就只装进当前项目。 也可以把这句话直接发给你的 agent，让它自己装： > 帮我安装这个 skill：https://github.com/suyuan2022/suyuan-skill/tree/main/whatis 用不上的别装。agent 每次开工都会把装上的 skill 简介全读一遍，装多了白占它的注意力。 --- ### whatis：看不懂的东西，画成图给你看 碰到不熟的概念，或者 agent 吐了一大段字读不进去，叫一下 whatis。它生成一个 HTML 页面，大图为主、字很少：流程图、时序图、架构图、前后对比，哪个合适画哪个。上下文不够，它会先去翻你的文件或上网查，图里每个框都得有依据，不瞎编。 ``` /whatis 美联储加息为什么会让房贷变贵 ```
三个真实出图，点开看大图：Claude Code 的 LSP 过期快照问题、worktree 的构建产物、git rebase 和 merge 的区别。
改自 Anthropic 的 [@trq212](https://x.com/trq212) 分享的 ELI5（Explain Like I'm Five，像讲给五岁小孩听）。原版只有一句话，大意是「讲给一个完全不懂的人听，用一个大图多字少的 HTML 页面」。我在这上面加了排版和信息层级的要求，出图更稳。
### break-ai-slop：动手前，先想清楚行家会怎么干
AI 交出来的东西，常常挑不出错，可换谁来写都差不多。break-ai-slop 让它动手前先回答四个问题：
1. 这活在现实里，是什么人、在什么场景下干得最好？
2. 新手或者 AI 做砸了，结果长什么样？
3. 常见错误都避开了还是不对，根本问题在哪？
4. 所以真正决定成败的约束是什么？
想清楚了再动手。我让它写「杭州老小区门口一家 20 平米面包店的开业朋友圈」，下面是它动笔前想的，原文摘录：
> 不是「文案专家」，而是在小区门口开过几年小店、朋友圈靠自己发出第一批熟客的老板。
>
> ……即使文笔漂亮，也可能失败，因为目标写错了。这条文案要的不是点赞，而是让周围 1 公里内的人下周六真的走进来买第一次，之后变成习惯。还有一个隐藏约束：20 平米的店装不下太多人，所以文案要引导错峰。
怎么叫它：任务前加一句「这个别敷衍，先想清楚再做」，或者直接打 `/break-ai-slop`。
适合写东西、出方案、做判断这类没有标准答案的活。查个事实、改个错别字用不着，它的输出会长一倍。
### get-biji：把 Get 笔记搬到你电脑上，再用它的额度转逐字稿
[Get 笔记](https://biji.com)用户的两件事。
**把 Get 笔记整个搬到你电脑上。** 录音、存过的链接、随手记的文字，全部同步成本地的 Markdown 文件，按日期放好；以后有新的，再跑一次就补上。录音的逐字稿带说话人和时间，长的单独存一个文件。变成你自己的文件以后，agent 能跟你别的笔记一起搜，Get 改版或者断网，东西也还在你手里。
**用 Get 的转写额度转逐字稿。** 丢一个抖音、小红书、B 站、小宇宙的链接，Get 免费解析成文字；别的网站的视频、手机里的录音，上传给 Get 转，按音频时长扣你每月的转写额度，扣之前 agent 会先告诉你大概扣多少。转写要在 Get 里建一条临时笔记，拿到文字后只删这一条，你别的笔记不碰。
只想在对话里存笔记、搜笔记，装 Get 官方的 [MCP](https://www.npmjs.com/package/@getnote/mcp) 就够了，它能按意思搜。get-biji 管的是官方不做的那两件：整个搬到本地，和上传音视频转写。
装完要在 skill 目录里跑一次 `npm install && npx playwright install chromium`（会下载约 250MB 的浏览器，只用来登录），跟 agent 说一声它会自己跑。第一次用会弹出浏览器登录 biji.com，所以得在你自己的电脑上，之后大约 90 天不用再登。转本地音视频还要装 [ffmpeg](https://ffmpeg.org)。笔记存在你指定的目录，登录态存在 `~/.config/get-biji/`，重装或更新 skill 都不会丢。
基于 [skychentian/GET-biji](https://github.com/skychentian/GET-biji) 改的，经作者同意收录：同步部分是原作者写的，逐字稿脚本是我加的。
### claude-cleanup：清理本机的 Claude 记录，给开局上下文瘦身
两件事。
**清理本机记录（macOS）。** 被封过号的电脑不用换，把 Claude Code 和 Claude 桌面版留在本机的东西清掉就行。动手前先把 `~/.claude` 完整复制一份并逐个校验，`~/.claude.json` 也备份。可再生的缓存和日志自动清；轮换本地 ID、退出 CLI 登录、重置桌面版、把系统时区改成台北，这几样由你一项项选。清掉的东西只挪进一个带时间戳的废纸篓目录，不永久删除。你的会话记录、Skills、Hooks、设置都在保护名单里，不动。最后列出完整清单，你自己在终端里输入 `CONFIRM` 才开始写盘。
Claude Code 不能清理它自己正在用的 `~/.claude`，所以清理这一步要用 Codex 或普通终端来跑；在 Claude Code 里只能做只读体检。
> 执行这个 skill 帮我清理：https://github.com/suyuan2022/suyuan-skill/tree/main/claude-cleanup
**开局上下文瘦身（macOS、Windows 都行）。** Claude Code 每次开局都要先读一遍工具、MCP、skill、插件的说明，装多了白占上下文。它先实测开局占了多少、哪些近期没用过、各自关掉能省多少，跟你确认后只改 `~/.claude/settings.json` 里你同意的那几项，改之前先备份，每一项都能改回去，新开会话生效。
这个 skill 只管本机清理，不能用来绕过封号、支付检查或平台风控。
---
我平时用 AI 干活踩过的坑、这些 skill 为什么这么写，都在 X 上：[@suyuan1711](https://x.com/suyuan1711)。用着不顺或者有问题，开个 [issue](https://github.com/suyuan2022/suyuan-skill/issues)。
## 许可证
MIT。