Thin-Harness-Fat-Skills

定义

Thin Harness, Fat Skills(薄 Harness 厚 Skill) 是一种 Agent 架构哲学:Harness(Agent 基础设施层)只做最少必要的事——调度、路由、基础安全,复杂逻辑和领域知识封装在 Skill 中。这与主流将重点放在 Harness Engineering 上的路径形成对照。

关键数据点

  • 核心理念: Harness 只做最少必要的事(调度、路由、基础安全),复杂逻辑和领域知识封装在 Skill 中
  • 与主流的对比: 主流 Agent 框架(如 OpenClaw、Claude Code)将大量工程精力投入 Harness Engineering(Context 管理、多 Agent 编排、工具调度),GBrain 反其道而行
  • 实现方式: 通过 "Skillify" 将非结构化知识转化为可被 Agent 高效调用的结构化资产——万物皆可为 Skill,处处皆可存记忆
  • 设计动机: 避免 Harness 层过度膨胀导致维护成本激增,同时让知识/Skill 层独立演化

前提与局限性

  • Thin Harness 的前提是 Skill 体系足够丰富和完善——如果 Skill 质量差,薄 Harness 反而暴露短板。
  • 在复杂多 Agent 协作场景中,过薄的 Harness 可能导致编排能力不足。
  • Skill 之间的冲突和优先级管理需要额外机制。
  • 该哲学更适用于知识密集型 Agent 系统,对于需要强实时控制和硬件交互的场景可能不够。

两种架构路径的对比

Thin Harness 和 Harness Engineering 不是"谁对谁错",而是针对不同系统类型的架构选择:

维度Thin Harness, Fat SkillsHeavy Harness
复杂度位置Skill 层Harness 层
演化单位单个 Skill 独立迭代Harness 整体升级
典型代表GBrain、Obsidian 插件生态Claude Code、OpenClaw
适用场景知识密集型、Skill 可独立验证多 Agent 编排、强一致性要求
风险Skill 质量参差、冲突管理弱Harness 膨胀、维护成本高
扩展方式增加 Skill增加 Harness 组件

GBrain 选择 Thin Harness 的核心原因是:知识密集型 Agent 的能力瓶颈不在调度和路由,而在 Skill 层的知识覆盖度和结构化程度。把工程精力投入 Harness 层的边际收益递减——Harness 做到"够用"后,每新增一个高质量 Skill 的系统价值远大于每优化一次 Harness 编排。

与 Latent Space vs Deterministic 的连接

Thin Harness 的底层逻辑与 潜在空间与确定性分工 一致:Harness 层处理的是确定性任务(路由、调度、安全校验),这些任务的输入输出可预测,适合用规则实现;Skill 层处理的是需要语义理解的任务(知识检索、内容生成、推理),这些任务需要 LLM 的潜在空间能力。

薄 Harness 的本质是把确定性任务留给确定性系统,把语义任务留给语义系统。如果 Harness 层开始承担语义判断(比如"这个 Skill 是否适用于当前任务"),它就从薄变厚了——同时承担了它不该承担的判断风险。

关联概念

  • GBrain — Thin Harness, Fat Skills 的主要实践案例。
  • Harness-Engineering — 主流的 Harness 重型化路径,Thin Harness 的对照面。
  • Agent-Harness — Agent 基础设施的 12 组件模型;Thin Harness 只实现其中的最小必要子集。
  • Progressive-Disclosure — Skills 实现渐进式披露的技术基础。
  • LLM-Wiki — LLM Wiki 的设计也体现了"让 LLM 做维护、人做策展"的薄层哲学。
  • Agent-Workflow-Patterns — 不同 Workflow Pattern 对 Harness 厚度的要求不同。
  • Latent-Space-vs-Deterministic — Thin Harness 的底层分工原则:确定性任务给 Harness,语义任务给 Skill。