Suyuan Skill

<p align="right"> <strong>中文</strong> | <a href="./README_EN.md">English</a> </p>

suyuan-skill

我是夙愿（X：@suyuan1711），在一家 AI 创业公司做 Agent 产品。这里是我反复打磨的精品 Skill，会一直更新。

Skill 就是一份写给 agent 的说明书：装上以后，你说到相关的事，agent 会照着它来干。

你碰到的事	用哪个
看不懂一个概念，或者 agent 甩过来一屏又一屏的字读不进去	whatis
AI 交出来的东西挑不出错，可也没什么用	break-ai-slop
想把 Get 笔记里的录音和笔记整个搬到自己电脑上	get-biji
想把一个视频、播客或者手机里的录音转成文字	get-biji
被 Claude 封过号的电脑，想先备份、再把本机的 Claude 记录清干净	claude-cleanup
Claude Code 一开局上下文就很大，想关掉用不上的工具和插件	claude-cleanup

安装

先装好 Node.js，下面的 npx 是它自带的。

全装（会让你勾选要哪几个）：

npx skills add suyuan2022/suyuan-skill -g

只装一个，比如 whatis：

npx skills add suyuan2022/suyuan-skill -g --skill whatis

-g 是装到你的用户目录，所有项目都能用；不加就只装进当前项目。

也可以把这句话直接发给你的 agent，让它自己装：

帮我安装这个 skill：https://github.com/suyuan2022/suyuan-skill/tree/main/whatis

用不上的别装。agent 每次开工都会把装上的 skill 简介全读一遍，装多了白占它的注意力。

---

<a id="whatis"></a>

whatis：看不懂的东西，画成图给你看

碰到不熟的概念，或者 agent 吐了一大段字读不进去，叫一下 whatis。它生成一个 HTML 页面，大图为主、字很少：流程图、时序图、架构图、前后对比，哪个合适画哪个。上下文不够，它会先去翻你的文件或上网查，图里每个框都得有依据，不瞎编。

/whatis 美联储加息为什么会让房贷变贵

<a href="./assets/whatis-demo.jpg"><img src="./assets/whatis-demo.jpg" alt="whatis 的三个出图：Claude Code 的 LSP 过期快照问题、worktree 的构建产物、git rebase 和 merge 的区别"></a>

_{三个真实出图，点开看大图：Claude Code 的 LSP 过期快照问题、worktree 的构建产物、git rebase 和 merge 的区别。}

改自 Anthropic 的 @trq212 分享的 ELI5（Explain Like I'm Five，像讲给五岁小孩听）。原版只有一句话，大意是「讲给一个完全不懂的人听，用一个大图多字少的 HTML 页面」。我在这上面加了排版和信息层级的要求，出图更稳。

<a id="break-ai-slop"></a>

break-ai-slop：动手前，先想清楚行家会怎么干

AI 交出来的东西，常常挑不出错，可换谁来写都差不多。break-ai-slop 让它动手前先回答四个问题：

1. 这活在现实里，是什么人、在什么场景下干得最好？
2. 新手或者 AI 做砸了，结果长什么样？
3. 常见错误都避开了还是不对，根本问题在哪？
4. 所以真正决定成败的约束是什么？

想清楚了再动手。我让它写「杭州老小区门口一家 20 平米面包店的开业朋友圈」，下面是它动笔前想的，原文摘录：

不是「文案专家」，而是在小区门口开过几年小店、朋友圈靠自己发出第一批熟客的老板。

……即使文笔漂亮，也可能失败，因为目标写错了。这条文案要的不是点赞，而是让周围 1 公里内的人下周六真的走进来买第一次，之后变成习惯。还有一个隐藏约束：20 平米的店装不下太多人，所以文案要引导错峰。

怎么叫它：任务前加一句「这个别敷衍，先想清楚再做」，或者直接打 /break-ai-slop。

适合写东西、出方案、做判断这类没有标准答案的活。查个事实、改个错别字用不着，它的输出会长一倍。

<a id="get-biji"></a>

get-biji：把 Get 笔记搬到你电脑上，再用它的额度转逐字稿

Get 笔记用户的两件事。

把 Get 笔记整个搬到你电脑上。 录音、存过的链接、随手记的文字，全部同步成本地的 Markdown 文件，按日期放好；以后有新的，再跑一次就补上。录音的逐字稿带说话人和时间，长的单独存一个文件。变成你自己的文件以后，agent 能跟你别的笔记一起搜，Get 改版或者断网，东西也还在你手里。

用 Get 的转写额度转逐字稿。 丢一个抖音、小红书、B 站、小宇宙的链接，Get 免费解析成文字；别的网站的视频、手机里的录音，上传给 Get 转，按音频时长扣你每月的转写额度，扣之前 agent 会先告诉你大概扣多少。转写要在 Get 里建一条临时笔记，拿到文字后只删这一条，你别的笔记不碰。

只想在对话里存笔记、搜笔记，装 Get 官方的 MCP 就够了，它能按意思搜。get-biji 管的是官方不做的那两件：整个搬到本地，和上传音视频转写。

装完要在 skill 目录里跑一次 npm install && npx playwright install chromium（会下载约 250MB 的浏览器，只用来登录），跟 agent 说一声它会自己跑。第一次用会弹出浏览器登录 biji.com，所以得在你自己的电脑上，之后大约 90 天不用再登。转本地音视频还要装 ffmpeg。笔记存在你指定的目录，登录态存在 ~/.config/get-biji/，重装或更新 skill 都不会丢。

基于 skychentian/GET-biji 改的，经作者同意收录：同步部分是原作者写的，逐字稿脚本是我加的。

<a id="claude-cleanup"></a>

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。用着不顺或者有问题，开个 issue。

许可证

MIT。