你的 AI Agent 刚写完 README。它画了一张图表、截了一张图，往 Markdown 里塞了一句 ，然后告诉你搞定了。等你一 push，图片就裂了——那个文件只存在于你的磁盘上，别的地方都没有。
解决办法从来不是难点，难的是知道什么时候该用它。PicGo Skills 是官方的 Agent Skills 合集，教的正是这件事，而且你现在用的是哪个 AI Agent 都行。
一条命令，适配任何 AI Agent
npx skills@latest add PicGo/skills按提示选好你要的 Skills，就完成了。
因为 Agent Skills 是一种通用格式，而不是某个厂商的插件 API，同一次安装在 Claude Code、Cursor、Codex、GitHub Copilot、Windsurf、Gemini、Cline 等工具里都能用。下个月换了编辑器，你的 AI Agent 依然知道怎么上传。
这个 Skill 到底教了什么
Skill 不是工具，而是指令——是 AI Agent 用好工具所需要的判断力。这个区别在这里很关键，因为上传一个文件很简单，决定要不要上传却不简单。
什么时候上传
最主要的触发场景，也是最常遇到的：你在写文档，需要插一张图进去。 往 README 里放截图，往博客文章里放示意图，往 Obsidian 或 Notion 笔记里放图片。Skill 会告诉 AI Agent 把这当成默认场景，直接处理掉。
什么时候不上传
这恰恰是通用的「上传这个文件」类工具做错的那一半。
- 你指定了目的地。 如果你说的是「放到我们的飞书云盘」或者「推到 S3」，那 PicGo 就不是合适的工具，AI Agent 应该转去别的途径。
- 你要的是本地文件。 保存、下载、把 base64 解码到磁盘，这些都不是上传。
- 文件看起来很敏感。 合同 PDF、内部数据的压缩包，任何名字看起来就是机密的东西——上传后的链接是公开的，所以 AI Agent 会先问你，而不是悄悄把它发布出去。
- 你没提到剪贴板。 AI Agent 绝不能擅自认定你的剪贴板内容需要上传。里面可能是毫不相干的东西，也可能是隐私内容。
失败也要失败得有用
上传失败并不都是一回事，Skill 划清了真正重要的那条线：哪些是重试能解决的，哪些不是。
网络抖动或者 5xx，值得重试一次。没登录、超出配额、文件类型被拒、路径不对，这些重试都没用——在这上面反复循环，只会浪费你的时间和 AI Agent 的 token。对于每一种情况，Skill 都会让 AI Agent 告诉你一个明确的操作，而不是乱试一通。
这里面有一个值得单独拎出来说的细节：如果登录检查本身因为网络错误失败了，这和「没登录」不是一回事。把两者混为一谈的 AI Agent，会让你走一遍根本不需要的登录流程。
直接沿用你现有的配置
Skill 会按顺序选用你机器上已经能用的方式：
- PicGo 桌面端，如果它正在运行——它的本地服务器可以直接上传，不用安装、不用登录，复用你在 GUI 里配置好的图床。
- 否则用
picgo命令行。 - 从零开始的用户则用 PicGo Cloud，免费额度足够日常使用。
所以如果你几年前就把 GitHub 设成了图床，AI Agent 的截图就会传到那里。Amazon S3、腾讯云 COS、七牛、又拍云、SM.MS，或者第三方的 PicGo 上传插件——全都能沿用。不用重复配置，也不会多出一份凭证副本。
经过测试，而不只是写出来
听起来合理的指令，和真正能改变行为的指令，是两回事。这个 Skill 自带 evals——带预期结果的具体场景——所以它的行为是经过验证的，而不是想当然：
- 给一份 README 和一张截图，AI Agent 返回的是
格式的 Markdown 图片，而不是一个光秃秃的链接吗？ - 被要求把一份 PDF 上传到飞书云盘时，它会正确地拒绝使用 PicGo 吗？
- 拿到一份双方已签字的保密协议时，它会在发布到公开 URL 之前先确认吗？
最后一条比看上去更重要。一个悄悄把机密文件传到公开图床的 AI Agent，造成的是实实在在的损害，而在提示词里写多少遍「小心点」，都没法可靠地防住这种事。
在用 DeepSeek Harness？
有专门的插件：@picgo/dsh-plugin 注册了一个原生的 picgo_upload 工具和一个 /picgo 命令，并且内置了同一个 Skill。
dsh plugin --profile web add @picgo/dsh-plugin详情见这篇专门的文章。
常见问题
问：支持哪些 AI 工具？
答：任何支持 Agent Skills 格式的工具——Claude Code、Cursor、Codex、GitHub Copilot、Windsurf、Gemini、Cline 等等。安装命令在哪里都一样。
问：需要 PicGo 账号吗？
答：只有用 PicGo Cloud 时才需要。如果你已经在 PicGo 里配置了 GitHub、S3、腾讯云 COS、七牛或其他图床，Skill 会直接用它，不涉及任何登录。
问：需要让 PicGo 桌面端保持运行吗？
答：不需要。如果它恰好在运行，Skill 会优先用它，因为这是最快、零配置的方式。否则会退回到 picgo 命令行。
问：AI Agent 会不经询问就上传我的剪贴板吗？
答：不会。Skill 明确要求 AI Agent 绝不能默认剪贴板需要上传——只有你说了才会。
问：上传后的链接是公开的吗？
答：是的，而且 Skill 会确保 AI Agent 把这一点告诉你。对于看起来敏感的内容，它会在上传前先跟你确认。
试试看
npx skills@latest add PicGo/skills这些 Skills 在 GitHub 上开源，并收录在 skills.sh。如果你的 AI Agent 做了某件本该被 Skill 拦下的事，欢迎提个 issue——evals 存在的意义，就是把这类行为固定下来并修好。
上传愉快！