SkillHub 技能商店操作

> SkillHub 是国内优先的 Skill 商店（skillhub.cn），安装文档 https://skillhub.cn/install/skillhub.md。
> 用户偏好：优先复用 SkillHub 上成熟高赞的现有 skill，不自己创造方法论/流程；只有无现成方案才新建。

触发条件

• 用户要求安装/搜索/比选 skill（"装个XX skill""有没有现成的XX方案""高赞 skill"）
• 需要某个能力但当前工具/skill 不具备 → 先到 SkillHub 找现成的
• 涉及"任务规划""方法论"类需求 → 优先搜商店现成方法论，不自创

安装 CLI（首次）

# ⚠️ 管道 curl|bash 会被 Hermes 安全扫描拦截 → 必须分两步：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh -o /tmp/skillhub_install.sh
bash /tmp/skillhub_install.sh

• CLI 安装到 ~/.local/bin/skillhub（Hermes 实测：/home/user/home/.local/bin/skillhub）
• 需 export PATH="/home/user/home/.local/bin:$PATH" 后可用
• 验证：skillhub --version（实测 2026.8.5）

搜索与安装

skillhub search <关键词>                    # 文本输出（含 namespace + version + install 命令）
skillhub search <关键词> --json             # 结构化输出
skillhub install <skill> --namespace <ns> --dir <skills目录>  # 必须 --dir 指向当前 Agent 的 skills 目录
skillhub list                               # 列出本地已安装
skillhub upgrade                            # 升级已装 skills

Hermes 的 skills 目录通常为 ~/./skills/ 或 /home/user/skills/。

评估候选（"高赞"比选，2026-08-14 实测）

不要只看 search 结果——search --json 的 stars/score/downloads 字段全为空。要拿热度数据必须用 rankings：

# 榜单（含 stars/score/downloads/installs 排序数据）
skillhub skill rankings --type all --timeout 60
skillhub skill rankings --type hot          # 最热下载榜
# --type 可选: all/hot/featured/newest/recommended/trending/paid

# 质量评测（多维评分：adaptability/boundary 等）
skillhub skill evaluation <slug> --namespace <ns>

# 安全报告（Keen/Yunding 扫描）
skillhub skill reports <slug> --namespace <ns>

⚠️ 解析陷阱

• rankings --type all 返回 {"rankings": {"hot": {"skills":[...]}, "featured": {...}, ...}}
• rankings --type hot 返回的是顶层 {"section":"hot_downloads","skills":[...]}（两者结构不同，解析前先看顶层 keys）
• 全量输出可达 639KB+ 超终端截断 → 用脚本重定向到文件解析，或 python 子进程调用后 json.loads
• skill 详情 REST API（api.skillhub.cn/skill/<slug> 等路径）实测 405/404 不可用——一律走 CLI
• skill 子命令只有三个：rankings / reports / evaluation（无独立 detail 命令）

安装后必做兼容性实测（2026-08-14 血泪教训）

SkillHub 的 skill 大多为 OpenClaw / Claude Code 生态编写，装进 Hermes 后脚本很可能不能直接跑。装完必须实测，不能只看 SKILL.md。

# 1. 检查脚本换行符（SkillHub 下载的 .sh 常为 Windows CRLF，bash 直接报错）
head -c 100 <skill_dir>/scripts/*.sh | od -c | head -3
# 看到 \r\n 即为 CRLF → 修复：
sed -i 's/\r$//' <skill_dir>/scripts/*.sh

# 2. 实测关键脚本能否运行
python3 <skill_dir>/scripts/*.py --help   # python 编排脚本
bash <skill_dir>/scripts/check-complete.sh # bash 脚本（先修 CRLF）
python3 <skill_dir>/scripts/*.py start <plan.md>  # 完整跑一次 start 命令

# 3. 检查生态绑定
grep -rn "openclaw\|session_spawn\|CLAUDE_PLUGIN_ROOT\|powershell" <skill_dir>/SKILL.md <skill_dir>/scripts/ | head

实测案例（2026-08-14，stp + manus）

判定准则：方法论（文件持久化、步骤分解、状态跟踪）跨生态可迁移；脚本（路径硬编码、hooks、子代理机制）基本绑定原生态。给用户评估时如实说明"方法论可用/脚本不可用"，并主动提出适配方案。

用户偏好（重要）

• 用户明确要求（2026-08-14）：方法论/科学流程类需求，先查商店有没有现成高赞 skill，不自创；搜索关键词要多角度试（"任务规划"→"任务执行"→"进度"→"task plan"→英文）
• 给用户比选时输出表格：Skill 名 / 热度（★/下载）/ 核心能力 / 匹配度 / 推荐理由
• 安装到 Hermes 的 skills 目录（--dir），装完用 skillhub list 验证

⚠️ 大坑：找"平台标准 skill"搜索不全（2026-08-14 用户质疑后查证）

用户问："Hermes 是大平台，按道理应有自己的流程标准，不可能一点都没有。"——查证后确实有，是搜索策略错了。根因：
1. 只搜功能词（任务规划/多任务/进度），没搜平台词（hermes/Hermes Agent/nous）
2. 没查官方文档（hermes-agent.nousresearch.com/docs sitemap 有全部 bundled skills）
3. 没先看本地已装资产（官方 skill 早就在 /home/user/skills/software-development/ 下）

正确搜索顺序（找任何平台的 skill 标准）：
1. 先看本地：hermes skills list + ls /home/user/skills/（bundled 官方 skill 已在本地）
2. 查官方文档：sitemap.xml grep bundled 列出全部官方 skill 页面
3. 搜平台词：skillhub search hermes --json（补搜发现 8+ 个 Hermes 专属 skill）
4. 最后才搜功能词

本会话案例：Hermes 官方规划三件套 = plan（.hermes/plans/ 规划模式）+ writing-plans（方法论）+ subagent-driven-development（delegate_task 执行）——都在本地软件-development/ 下，只是没先看。第三方 stp/manus 反而是 OpenClaw/Claude 生态的，脚本不兼容。

穷尽搜索新发现：hermes-workflow-engine（2026-08-14 后续）

用 3平台词 × 12功能词 矩阵补搜（hermes/Hermes Agent/nous × plan/task/workflow/orchestrator/任务规划/编排/多任务…）发现 22 个唯一候选，最强的是：

hermes-workflow-engine v3.1.0（clawhub_lgx281227231，作者"小狗"）— 真正 Hermes 原生：
- 架构在 ~/.hermes/workflow-engine/，subagent 步骤类型直接用 delegate_task
- YAML 定义工作流（5种步骤类型：terminal/skill/subagent/user_input/llm）、DAG 依赖+拓扑排序、并行执行（delegate_task batch）、故障转移（fallback链+on_fail）、资源监控（token/时间/API）、版本管理（diff/rollback）、模式检测、HTML 可视化面板
- 实测（装到 /home/user/skillhub_eval2 后）：validate/plan/execute/delegate 四个命令全通过
- ⚠️ 需 pyyaml（PEP668 环境用 uv venv + uv pip install --python <venv>/bin/python pyyaml 装）
- ⚠️ 社区 skill 非官方，维护风险高于官方

三方对比结论（官方标准7.1 / 自建三文件7.8 / 此引擎8.4）：此引擎匹配 Hermes 平台程度最高，但状态持久化仍弱于三文件模式 → 最优组合 = "引擎做骨架（DAG/并行/故障转移）+ 三文件持久化"。

已安装并验证（2026-08-14 用户拍板后）：
- 已装到 /home/user/skills/@clawhub_lgx281227231/hermes-workflow-engine/（hermes skills list 已识别 enabled）
- 依赖 pyyaml：venv /home/user/wf_venv（PEP668 下 uv venv + uv pip install --python <venv>/bin/python pyyaml）
- 运行入口：/home/user/wf_venv/bin/python <skill>/scripts/run.py <validate|plan|execute|next|delegate>
- B+C 拼装模式实测通过（2 场景）：C 引擎每步 command 尾部追加 B 的 update_progress.py 同步状态；故障时 C 自动 fallback + B 标记"fallback恢复"。拼装细节见 hermes-planning-files skill 的"拼装模式"章节
- 同任务对比实测：C 8.1 vs B 7.1（C 强在故障转移/自动化/功能丰富；B 强在 markdown 三文件人读/发现落盘）

方法论：比选"匹配平台的最优质 skill"时必须做平台词×功能词矩阵穷尽搜索，只搜功能词会漏掉平台原生方案。

个人发布 Skill 到社区（2026-08-14 实测支持）

SkillHub 允许个人上传：官网"发布 Skill"按钮 + CLI publish 命令（支持目录或 .zip，内必须含 SKILL.md）。

skillhub publish <目录或zip> [--version V] [--changelog 文本] [--dry-run] [--token skh_...]
skillhub login --key skh_xxx          # 登录（token 从官网登录后获取）
skillhub auth whoami                  # 查当前身份
skillhub auth token                   # 打印已登录 token
skillhub verify <目录或zip>           # 验证本机 skill 与平台签名一致
skillhub publish <path> --dry-run     # 本地预检：校验 metadata+打包，不发 HTTP

注册/登录方式（官网实测）：
- 手机号验证码 或 微信扫码（open.weixin.qq.com qrconnect）即注册即登录
- 个人登录 / 团队登录两种模式（个人即可）
- CLI 未登录报错："未登录。请先执行: skillhub login --key skh_xxx"

⚠️ 发布前必须隐私扫描：含用户个人信息（姓名/手机/小区/账号配置）的 skill 不能原样上传——memory 里有隐私词表（用户/[社区名]/[小区名]/财务类隐私词等），发布前 grep 检查。

支持文件

• references/task-planning-candidates.md — 任务规划/多任务类现成 skill 清单（stp/manus/taskr/ai-task-master 等，2026-08-14 调研）

相关技能

• autonomous-problem-solving（先搜索再执行 + SkillHub 基础用法）— 单任务执行准则
• multi-task-orchestration（多任务编排）— 若商店 skill 不适用时的兜底流程