Skill Factory - Hermes Agent 的元技能自动生成器¶
[!info] 基本信息 - 仓库: https://github.com/Romanescu11/hermes-skill-factory - Stars 35 / Forks 1 / Open Issues 0 - 作者: @superman32432432 (Romanescu11) - 协议: MIT(README 声明,仓库未设 license 文件) - 版本: 1.0.0 - 创建时间: 2026-03-18(约 23 天) - 主要语言: Python (88%), Shell (12%) - 依赖: Hermes Agent v2026.3+ - 关联项目: NousResearch/hermes-agent
一句话定位¶
Hermes Agent 的 meta-skill -- 静默观察你的工作流,自动检测重复模式,把工作流转化为可复用的 Hermes skill。
核心解决的问题¶
用 Hermes 工作时,每次解决一个问题的工作流(环境搭建、调试、创建 PR)在会话结束后就消失了,下次又要重新描述。Skill Factory 自动捕捉这些可复用的工作流,生成标准化的 skill 文件和 plugin 文件。
工作原理¶
本质是两个文件的配合:
- SKILL.md(AI 指令)-- 教 Hermes AI 如何观察、检测、提出 skill 候选
- skill_factory.py(Plugin)-- 提供
/skill-factory命令和文件生成逻辑
五阶段流程¶
| 阶段 | 行为 |
|---|---|
| 1. 静默观察 | 跟踪重复操作、多步骤工作流、工具组合模式 |
| 2. 触发检测 | 用户显式请求 / 斜杠命令 / 重复 2 次以上 / 会话结束 / 用户表达挫败感 |
| 3. 提出建议 | 输出标准化的 skill 提案卡片,含名称、分类、步骤摘要 |
| 4. 生成文件 | 用户确认后生成 SKILL.md 和/或 plugin.py |
| 5. 后续跟进 | 告知安装方式,询问是否继续处理队列中的下一个模式 |
触发条件¶
| 触发方式 | 示例 |
|---|---|
| 用户显式请求 | "save this as a skill" |
| 斜杠命令 | /skill-factory propose |
| 重复模式 (2x+) | 同一工作流出现两次 |
| 会话结束 | 用户说 "done", "thanks" |
| 用户挫败 | "I always have to do this manually..." |
生成的产物¶
SKILL.md¶
标准 Hermes skill 格式,包含:frontmatter、触发条件、分阶段工作流步骤、质量检查清单、实际示例、反模式提醒。
路径:~/.hermes/skills/<category>/<name>/SKILL.md
plugin.py¶
Hermes plugin 格式,包含:注册 slash command + 可选 tool 注册。
路径:~/.hermes/plugins/<name>.py
技术实现细节¶
SessionTracker 类(纯内存,per-session):
- events -- 记录 tool_call / command 事件
- generated_skills -- 已生成的 skill 列表
- proposal_queue -- 待提出模式队列
- last_proposal -- 最近一次提案
事件钩子:
@hermes.on("tool_call") # 被动记录工具调用
@hermes.on("command") # 被动记录命令执行
文件生成:
- generate_skill_md() -- 用 textwrap.dedent 拼接 SKILL.md
- generate_plugin_py() -- 用 textwrap.dedent 拼接 plugin.py
- _sanitize_name() -- 字符串转 kebab-case
斜杠命令¶
| 命令 | 功能 |
|---|---|
/skill-factory propose |
分析当前会话,提出最佳 skill 候选 |
/skill-factory list |
列出本次会话已生成的 skill |
/skill-factory status |
显示当前跟踪状态 |
/skill-factory queue |
显示待处理模式队列 |
/skill-factory save <name> |
用自定义名称保存最近提案 |
/skill-factory clear |
清空会话跟踪日志 |
仓库结构¶
hermes-skill-factory/
├── skills/
│ └── skill-factory/
│ └── SKILL.md # 核心元技能(AI 指令)
├── plugins/
│ └── skill_factory.py # Plugin:命令 + 文件生成
├── templates/
│ ├── SKILL_TEMPLATE.md # 生成 skill 的模板
│ └── PLUGIN_TEMPLATE.py # 生成 plugin 的模板
├── examples/
│ └── generated/
│ └── git-pr-workflow/ # 生成示例
├── docs/
│ └── how-it-works.md # 架构详解
└── install.sh # 一键安装
评价¶
优点: - 概念很好 -- 把"程序记忆"自动化的思路清晰 - 触发条件设计合理(不只是机械检测,还包括情绪/语义触发) - 生成的 skill 格式完整(含 anti-patterns、quality checklist)
局限: - 实际的模式检测逻辑依赖 AI 推理(SKILL.md 里的指令),没有真正的算法模式匹配 - SessionTracker 只记录原始事件,没有相似度计算或聚类 - plugin.py 生成的是脚手架代码(全是注释和 pass),不是真正可执行的实现 - 仓库很轻量(~20KB Python),更像是一个精心设计的 prompt + 简单框架 - 单一贡献者,项目基本停滞(最后更新 3/18)
对 Hermes skill 生态的参考价值:SKILL.md 的 skill 模板格式和质量标准值得借鉴。