suyuan2022/suyuan-skill

解决的问题

AI 代理经常给你一堵你不想读的文字墙，或者给出技术上正确但无用的通用答案，或者无法帮你从云服务中取出自己的数据。这个项目收集了三个实用技能来解决这些具体问题：一个将复杂概念转化为简单图表，一个强制 AI 在回答前像专家一样思考，一个将你的 Get Notes（biji.com）数据迁移到自己的电脑上。

工作原理

每个技能都是一组指令，代理在触发时读取。你可以通过类似 npx skills add suyuan2022/suyuan-skill -g 的命令安装它们，这会将其放入你的用户目录，以便在所有项目中生效。你可以安装全部三个，也可以只选一个。每次代理开始任务时，它会读取所有已安装技能的描述，因此作者建议只安装你实际使用的技能，以免浪费代理的注意力。

• whatis – 当你不理解某个概念或代理的文本太长时，你可以调用它（例如 /whatis 美联储加息为什么会让房贷变贵）。它会生成一个以图表（流程图、时序图、架构图、前后对比）为主的单个 HTML 页面，文本极少。如果上下文不足，它会先搜索你的文件或网络，并且图表中的每个框都必须有证据支持——不能编造事实。它改编自 Anthropic 的 ELI5 想法，并增加了排版和结构要求，以提高输出可靠性。
• break-ai-slop – 这会让代理在开始任何开放式任务前回答四个问题：在现实生活中谁最擅长做这件事，在什么情况下？初学者或 AI 的拙劣结果是什么样？如果避免了常见错误但仍然出错，根本问题是什么？哪些约束真正决定成功？只有在思考完这些之后才开始。你可以通过说“这不是一次性任务，先仔细思考”或使用 /break-ai-slop 来触发它。它适用于写作、规划和判断任务，不适用于事实或拼写错误——输出会变长一倍。
• get-biji – 适用于 Get Notes（biji.com）用户。它将你所有的录音、保存的链接和快速笔记同步到按日期组织的本地 Markdown 文件中。新项目可以增量拉取。转录包含说话者和时间戳，长转录会单独成文件。由于文件属于你，你的代理可以像搜索其他笔记一样搜索它们，即使 Get 更改或离线，你也能保留它们。它还利用 Get 的免费转录配额：你可以粘贴抖音、小红书、Bilibili 或小宇宙链接，Get 会将其解析为文本；对于其他网站或本地音频，你上传到 Get，它会从你的月度配额中扣除（代理会事先告诉你大致费用）。转录发生在临时 Get 笔记中，技能随后会删除该笔记，不影响你的其他笔记。设置需要运行 npm install && npx playwright install chromium（约 250MB 下载，仅用于登录）。首次使用会打开浏览器登录 biji.com，因此必须在自己的电脑上运行。之后，你大约保持登录 90 天。转换本地音频/视频还需要 ffmpeg。笔记存储在指定的目录中；登录状态在 ~/.config/get-biji/ 中，并在重新安装或更新后保留。此技能基于 skychentian/GET-biji，经作者许可；同步部分来自原版，转录脚本是新增的。

适用人群

适用于使用 AI 代理（如 Claude Code 或类似工具）进行实际工作并遇到这些常见问题的人：不理解概念、得到平淡的通用输出，或希望拥有并重用锁定在笔记应用中的数据。这些技能全局安装，因此适用于你的代理处理的任何项目。

亮点

• 图表优先的解释 – whatis 将概念渲染为视觉 HTML 页面，文本极少，并根据主题选择最佳图表类型。
• 基于证据的图表 – 每个框都必须有依据；代理在需要时会检查你的文件或网络。
• 反“AI 味”思考流程 – break-ai-slop 的四个问题迫使代理在行动前考虑现实世界背景、失败模式、根本原因和真实约束。
• Get Notes 的本地所有权 – 完整导出为 Markdown，带说话者标签的转录、增量更新和离线访问。
• 无需额外工具的转录 – 使用 Get 自己的配额转换链接或上传，并提前警告费用。
• 跨项目工作 – 全局安装意味着你的代理接触的任何项目都可以使用这些技能。
• MIT 许可 – 免费使用和修改。