Skills hermes-qq

当用户想在 Hermes Agent 正式版 main 分支上补充 QQ platform 支持，或明确提到“给 hermes main 增加 QQ 渠道”“把 QQ support 作为 skill 安装到 Hermes”“让正式版 Hermes 支持 QQ 和文件发送”时使用。这个技能会把当前仓库补成支持 QQ Bot、QQ 文件发送、QQ 平台配置和工具集接线的版本。

install

source · Clone the upstream repo

git clone https://github.com/chujianyun/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/chujianyun/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/hermes-qq" ~/.claude/skills/chujianyun-skills-hermes-qq && rm -rf "$T"

manifest: skills/hermes-qq/SKILL.md

source content

Hermes QQ Installer

这个技能用于把 Hermes Agent 的

main

正式代码 补成支持 QQ platform 的版本。

适用场景：

当前仓库是
```
hermes-agent
```
用户希望在正式
```
main
```
代码上增加 QQ 渠道
需要同时支持 QQ 文本、图片、音频、视频、普通文件发送

不适用场景：

当前仓库不是
```
hermes-agent
```
用户只是想分析 QQ adapter 原理，不想改代码
仓库已经是自带 QQ 支持的分支，且不需要再次打补丁

工作流程

先确认目标仓库是
```
hermes-agent
```
，并且工作树里没有会冲突的本地改动。
运行
```
scripts/install_hermes_qq.py
```
，默认对当前工作目录打补丁。

如仓库有

venv

，优先执行：

source venv/bin/activate && python -m pytest tests/gateway/test_platform_base.py tests/gateway/test_extract_local_files.py tests/gateway/test_send_image_file.py tests/cron/test_scheduler.py tests/gateway/test_background_command.py tests/gateway/test_internal_event_bypass_pairing.py -q -n 0

如果没有现成环境，再按仓库约定补测试环境后执行同一组定向测试。

运行方式

当前目录就是目标

hermes-agent

仓库时：

python /Users/liuwangyang/Documents/coding/our/skills-wuming/skills/hermes-qq/scripts/install_hermes_qq.py

指定目标仓库时：

python /Users/liuwangyang/Documents/coding/our/skills-wuming/skills/hermes-qq/scripts/install_hermes_qq.py /path/to/hermes-agent

资源

```
assets/qq.py
```
QQ adapter 完整实现，会被复制到
```
gateway/platforms/qq.py
```
```
references/verification.md
```
安装后建议执行的验证命令

如果脚本提示某个补丁锚点不存在，说明目标仓库已经偏离官方

main

太多。这种情况下不要盲写，先读 references/verification.md，再手动审查差异后补丁。