Hermes Agent 自定义技能开发实战：用 Skill 打通 CSDN 文章发布流程

1. 为什么我要给 Hermes Agent 写一个 CSDN 发布技能Hermes Agent 是一个跑在终端里的开源 AI 智能体它能读写文件、执行命令、调用浏览器但真正让它从「通用助手」变成「我的专属工作流引擎」的是自定义 Skill 机制。简单说Skill 就是一份 Markdown 格式的指令文档放在~/.hermes/skills/目录下当你说的话和某个 Skill 的描述匹配时Agent 会自动加载它按里面写好的步骤去执行。它适合那些每周都要重复做、步骤超过五步、还特别容易踩坑的操作——比如把一篇本地 Markdown 文章发布到 CSDN。我写这个 Skill 的起因很直接每次发文章都要手动登录、填标题、粘贴正文、选标签、挑分类、点发布一套下来十分钟没了中间还经常遇到编辑器不响应、标签弹窗不出现、Cookie 过期要重新导出这些破事。更麻烦的是这些操作步骤和避坑经验只存在我脑子里换台机器或者过两周再来又得重新试错一遍。Hermes Agent 的自定义技能正好解决这个问题——把一次成功操作的全过程固化成文件以后每次只需要说一句「帮我发篇文章」剩下的交给 Agent。这篇文章我会完整拆解csdn_publish这个自定义 Skill 的开发过程从技能定义、参数编排到settings.json配置片段再到一次从触发到发布成功的验证动作。你跟着做能跑通自己的第一个自定义技能。过程中涉及模型调用和 API 接入的部分我会用 TaoToken 的接口来演示因为它兼容 Anthropic 风格配置起来比较省事。2. 前置准备TaoToken 接入与 Hermes Agent 环境在写 Skill 之前得先让 Hermes Agent 能正常调用模型。Hermes Agent 支持多种模型后端我这里用的是 TaoToken 提供的 API 服务它的接口地址是https://taotoken.net/api兼容 Anthropic 的调用格式对于 Hermes 这种需要长上下文和工具调用的 Agent 场景比较合适。首先你需要在 TaoToken 控制台创建一个 API Key。打开https://taotoken.net/api-keys登录后点「创建密钥」复制生成的 Key形如sk-xxxxxxxx。这个 Key 只显示一次记得存好。如果你还没注册可以先从官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content进去注册流程很快邮箱验证即可。拿到 Key 之后配置 Hermes Agent 的模型后端。Hermes 的配置文件通常在~/.hermes/settings.json你需要把模型提供方指向 TaoToken。下面是我实际使用的配置片段你可以直接复制修改{ model: { provider: anthropic, base_url: https://taotoken.net/api, api_key: sk-你的实际密钥, model_name: claude-sonnet-4-20250514, max_tokens: 8192, temperature: 0.3 }, skills: { enabled: true, scan_paths: [ ~/.hermes/skills/custom, ~/.hermes/skills/social-media ], auto_reload: true }, browser: { headless: false, timeout: 30000 } }这里有几个参数值得说明。base_url填https://taotoken.net/api不要加多余的路径Hermes 会自动拼接/v1/messages。model_name我选的是 Claude Sonnet 系列因为 Skill 执行过程中需要理解自然语言指令并操作浏览器对模型的理解能力要求较高。temperature设 0.3 是为了让执行步骤更稳定减少随机发挥。skills.scan_paths里我加了custom目录这是后面放自定义 Skill 的地方。auto_reload设为 true这样新增或修改 Skill 文件后不用重启 Agent。配置写完后用一条命令验证模型连通性hermes chat --prompt 回复 OK 两个字母即可 --no-skill如果终端返回OK说明 TaoToken 的接入没问题。如果报 401检查 Key 是否复制完整如果报连接超时确认base_url没有拼错。这一步跑通之后再进入 Skill 开发。3. 可复制配置csdn_publish 技能骨架与 settings.jsonSkill 的核心是一份SKILL.md文件放在~/.hermes/skills/custom/csdn_publish/目录下。Hermes Agent 启动时会扫描这个路径读取文件头部的 YAML 元信息用来判断什么时候该加载这个技能。下面是我最终定稿的技能骨架你可以直接复制到本地把 Cookie 和文章路径换成自己的。--- name: csdn_publish description: 使用 Cookie 登录 CSDN 并发布博客文章。支持设置标题、内容、标签、分类可选择直接发布或保存草稿。默认标签为 [AI, Hermes, 技术分享]默认分类为人工智能默认直接发布。 tags: [csdn, blog, publishing, social-media, cookie-auth, custom] defaults: tags: [AI, Hermes, 技术分享] category: 人工智能 publish_mode: publish --- # CSDN 文章发布技能 ## 触发条件 当用户提到发布到 CSDN发篇文章CSDN 博客等关键词时加载本技能。 ## 前置要求 - 用户需提供有效的 CSDN CookieJSON 数组格式 - 用户需提供本地 Markdown 文章路径 - 浏览器需保持登录态 ## 执行步骤 ### 步骤 1解析输入参数 从用户消息中提取 - cookieCSDN 登录凭证 - article_path本地文章文件路径 - title文章标题可选默认取文件名 - tags标签列表可选使用默认值 - category分类可选使用默认值 - publish_mode发布模式可选默认 publish ### 步骤 2读取文章内容 使用文件读取工具加载 article_path 指向的 Markdown 文件提取正文。 ### 步骤 3打开 CSDN 编辑器 导航到 https://editor.csdn.net/md/注入 Cookie等待页面加载完成。 ### 步骤 4填写标题 定位标题输入框使用 JS 方式设置标题值避免输入事件不触发。 ### 步骤 5注入正文 切换到 Markdown 编辑器模式将文章内容注入编辑区域。 ### 步骤 6设置标签和分类 点击标签按钮输入标签并回车确认。选择分类下拉框选中目标分类。 ### 步骤 7发布 根据 publish_mode 决定点击发布文章或保存草稿。 ### 步骤 8返回结果 按固定格式输出发布结果。 ## 异常处理 | 异常场景 | 处理策略 | |----------|----------| | CSDN 403 错误 | 自动重试一次导航到管理页面验证 | | 发布按钮无响应 | 自动切换编辑器模式后重试 | | Cookie 过期 | 提示用户Cookie 已过期请重新导出 | | 内容注入失败 | 切换编辑器模式后重试注入 | | 标签弹窗不出现 | 跳过标签设置继续发布 | | 标题输入不生效 | 使用 JS 方式设置标题值 | | 首页 403 | 使用管理页面验证 | ## 返回格式发布结果 ━━━━━━━━━━━━━━━━━━━━━━━━━ 标题 {title} 链接 {url} 状态 {status} 标签 {tags} ━━━━━━━━━━━━━━━━━━━━━━━━━这份骨架的关键在于 YAML 头部的defaults字段。它让 Agent 在用户没有明确指定标签和分类时自动填充默认值减少每次调用时的重复输入。description写得越具体Agent 匹配触发条件的准确率越高——我特意把「默认标签」「默认分类」「默认直接发布」都写进去这样即使用户只说「发篇文章」Agent 也能知道该用什么参数。创建这个文件的命令很简单mkdir -p ~/.hermes/skills/custom/csdn_publish cat ~/.hermes/skills/custom/csdn_publish/SKILL.md EOF 把上面的 SKILL.md 内容粘贴进来 EOF保存后Hermes Agent 会自动扫描到新技能。你可以用hermes skills list确认它是否被识别hermes skills list --category custom预期输出里应该出现csdn_publish状态为active。如果没出现检查文件路径是否在settings.json的scan_paths里以及 YAML 头部是否有语法错误——比如冒号后面少了空格或者缩进用了 Tab 而不是空格。4. 验证请求从触发到发布成功的完整动作配置写好了接下来跑一次真实发布来验证整条链路。我准备了一篇测试文章~/test_article.md内容是一段关于 Hermes Agent 的简短介绍。Cookie 我从浏览器开发者工具里导出格式是 JSON 数组每个元素包含name、value、domain等字段。调用命令如下hermes chat --prompt 请使用 csdn_publish 技能发布文章。 Cookie 是[{\name\:\UserToken\,\value\:\abc123...\,\domain\:\.csdn.net\}] 文章路径/home/user/test_article.md 标题Hermes Agent 自定义技能开发实战Agent 收到请求后会先匹配到csdn_publish技能加载 SKILL.md然后按步骤执行。我在终端里观察到的执行日志大致是这样的[Skill] 加载 csdn_publish [Step 1] 解析参数titleHermes Agent 自定义技能开发实战, tags[AI,Hermes,技术分享], category人工智能 [Step 2] 读取文件 /home/user/test_article.md共 1200 字 [Step 3] 打开编辑器 https://editor.csdn.net/md/注入 Cookie [Step 4] 设置标题Hermes Agent 自定义技能开发实战 [Step 5] 注入正文切换 Markdown 模式 [Step 6] 设置标签AI, Hermes, 技术分享分类人工智能 [Step 7] 点击发布 [Step 8] 发布成功链接https://blog.csdn.net/xxx/article/details/123456789最终终端输出的返回结果发布结果 ━━━━━━━━━━━━━━━━━━━━━━━━━ 标题 Hermes Agent 自定义技能开发实战 链接 https://blog.csdn.net/xxx/article/details/123456789 状态 发布成功审核中 标签 AI, Hermes, 技术分享 ━━━━━━━━━━━━━━━━━━━━━━━━━从触发到发布成功整个过程大约 40 秒其中大部分时间花在浏览器页面加载和编辑器切换上。我试过连续发布三篇文章除了第一篇需要手动确认 Cookie 有效性后面两篇都是直接跑通参数默认值生效没有重复输入标签和分类。这里有个细节值得注意CSDN 的编辑器有两种模式默认是富文本注入 Markdown 内容时需要先切换到 Markdown 模式。我在 SKILL.md 的步骤 5 里写了「切换到 Markdown 编辑器模式」Agent 会先点击模式切换按钮再注入内容。如果跳过这一步正文会以纯文本形式堆在富文本编辑器里格式全乱。这个坑我在第一次测试时就踩过后来写进异常处理表里现在 Agent 会自动处理。5. 本篇常见错排查即使配置写对了实际跑的时候还是可能遇到各种报错。下面是我在开发和使用过程中遇到的几个高频问题以及对应的排查思路。问题一Agent 没有加载 csdn_publish 技能直接当成普通对话回复。这通常是因为description字段写得不够具体或者用户消息里的关键词和技能描述匹配度低。排查方法先用hermes skills list确认技能是否在列表中状态是否为 active。如果技能存在但没触发试着在 prompt 里显式写出技能名比如「请使用 csdn_publish 技能」。另外检查settings.json里的scan_paths是否包含了~/.hermes/skills/custom路径要用绝对路径或~展开不能写相对路径。问题二Cookie 注入后页面仍然跳转到登录页。CSDN 的 Cookie 有多个字段只复制UserToken往往不够还需要UserName、UserInfo等。建议从浏览器开发者工具的 Application 面板里选中.csdn.net域下的所有 Cookie整体导出为 JSON 数组。另外 Cookie 有时效性一般几天到几周不等过期后需要重新导出。我在 SKILL.md 的异常处理里写了「Cookie 过期时提示重新登录」Agent 检测到登录页跳转后会返回这个提示而不是继续执行。问题三发布按钮点击后无响应页面卡住。这种情况多半是编辑器还在加载中或者标签弹窗遮挡了按钮。我的处理策略是自动切换一次编辑器模式再重试。具体来说Agent 会先点击「Markdown 编辑器」标签等 2 秒再点「发布文章」。如果还是没反应就导航到https://mp.csdn.net/mp_blog/manage/article管理页面检查文章是否已经进入草稿箱——有时候按钮没反馈但实际已经提交了。问题四标签设置失败弹窗不出现。CSDN 的标签输入框有时需要先点击「添加标签」按钮才会展开。如果 Agent 直接往输入框里打字可能找不到元素。我在 SKILL.md 里写的策略是如果标签弹窗 3 秒内没出现就跳过标签设置继续发布并在返回结果里标注「标签未设置」。这样至少保证文章能发出去标签可以后续手动补。问题五TaoToken API 返回 429 限流。如果你短时间内频繁调用模型可能会触发限流。排查方法查看 Hermes 日志里的 HTTP 状态码如果是 429等 60 秒再重试。长期方案是在settings.json里加一个retry配置{ model: { retry: { max_attempts: 3, backoff_seconds: 5 } } }这样 Agent 遇到限流会自动退避重试不用手动干预。问题六文章发布成功但链接返回 404。这通常是 CSDN 的审核延迟导致的。刚发布的文章会进入审核队列链接暂时不可访问等几分钟到几小时不等。Agent 返回的「状态发布成功审核中」已经说明了这一点。你可以导航到管理页面确认文章确实在列表中链接过段时间会自动生效。6. 继续迭代把 Skill 用起来跑通第一个自定义技能之后你会发现这套机制的扩展性很强。csdn_publish只是一个起点同样的思路可以复制到其他平台——比如把文章同步到掘金、知乎或者把发布流程拆成「草稿」「审核」「发布」多个技能用参数控制。关键是把每次操作中遇到的坑和解决方案都写进 SKILL.md让 Agent 下次自动避开。如果你在配置 TaoToken 接入或调试 Skill 触发条件时遇到问题可以先检查 API Key 和base_url是否正确再确认settings.json里的scan_paths是否指向了技能目录。需要创建新的 API Key 或查看调用额度可以访问https://taotoken.net/api-keys。模型对话调试可以用https://taotoken.net/chat快速验证接口连通性。如果你打算长期用 Hermes Agent 做编码和自动化任务Coding Plan 的额度方案在https://taotoken.net/coding-plan有详细说明。接入文档和参数细节在https://taotoken.net/doc可以查到包括 Anthropic 兼容接口的完整字段列表。回到 Skill 本身我现在的习惯是每完成一次新的重复操作就顺手让 Agent 把它封装成技能。比如批量重命名文件、定时抓取数据、自动生成周报这些都可以用同样的「对话驱动 迭代优化」的方式固化下来。Skill 即代码把经验变成可复用的模块下次就不用从头再来了。