SkillForge — local-first agent skill runtime and registry

SkillForge — local-first agent skill runtime and registry

一句话结论

HaddenHunter/SkillForge 把 agent skill 从“提示词片段/仓库模板”推进到本地优先的可校验运行时：skill.yml manifest、SKILL.md、eval.md、白名单读写沙箱、Plan→Act→Observe→Reflect 执行、MCP 暴露、registry / signing / RBAC / audit 链路。这对 External-Agent-Skills-Design-Patterns 很重要，因为它把 skill 当作可安装、可验证、可分发、可审计的软件制品。

为什么对用户重要

用户已经在 Hermes 中使用 skill，但长期风险是 skill 数量增长后变成不可控 prompt 堆：触发不清、权限边界不明、版本不可追踪、是否有效无法评测。SkillForge 提供了一个可借鉴方向：不是盲目安装外部 skill，而是给本地 skill 增加 manifest、allowlist、eval、registry metadata 和审计记录。对 llm-wiki 来说，它也提示来源页面不只记录“这个工具做什么”，还应提取可迁移的 skill lifecycle 设计。

机制 / 一阶原理

SkillForge 的关键抽象是把 skill 拆成四层：

1. 结构化 manifest：skill.yml 声明名称、版本、模型、token budget、依赖、allow.read_paths / allow.write_paths / allow.net_hosts 等。
2. 执行运行时：Rust core 以 run / serve / validate / eval 方式执行技能，并在 macOS 上尽量接入 Seatbelt；不可用时回退逻辑白名单。
3. MCP 表面：技能可以通过 HTTP MCP tools/list 与 tools/call 暴露给 Claude Code、Cursor 或其他 MCP 客户端。
4. 分发与治理：registry CLI / service / web 支持 search、publish、install、GitHub Release 同步、Ed25519/minisig 风格签名、Scope RBAC、Bearer Token、audit log。

一阶原理是：可复用能力一旦能被 agent 执行，就不再只是文档，而是供应链组件；因此它需要版本、依赖、权限、评测和撤回机制。

与已有 wiki 概念的关系

• 对 External-Agent-Skills-Design-Patterns：补充 manifest + sandbox + eval + registry + signing 的工程化 skill package 模式。
• 对 Harness-Engineering：skill runtime 本身是 harness 的一部分，负责执行边界、观察、预算和证据。
• 对 Context-Engineering：skill manifest 是上下文路由和预算控制的结构化入口，优于把所有技能说明常驻 prompt。

对 Hermes / llm-wiki 的可执行启发

1. 给 Hermes skill admission 增加 manifest 字段：触发描述、输入/输出、读写路径、网络 host、依赖、验证命令、风险等级、相关 wiki 页面。
2. 外部 skill 先学设计，不直接安装：没有权限边界、eval、版本/hash、脚本清单和网络说明的 skill，只能作为 source note，不应进入长期可执行 skill set。
3. 将 registry 思路迁移为轻量目录索引：不必马上部署完整 registry，但可以为本地 skills 建 _index / lockfile / audit log，记录来源、版本、修改原因和验证 receipt。

失败模式 / 边界条件

• README 明确项目仍处 Phase 1 MVP；生产级 TUF 密钥轮换、Prometheus 指标、Token/审批流等仍在 Roadmap。
• macOS Seatbelt 和逻辑白名单覆盖范围有限；网络和进程能力仍需继续收紧。
• Registry / MCP 增加了供应链接面；签名、RBAC、审计若未实际执行，会形成 false confidence。

写入记录

• 2026-08-07 09:00 CST：新增 SkillForge 来源页，提炼本地优先 skill runtime、manifest、沙箱、MCP、registry/signing/RBAC 与 Hermes skill admission 启发。