Kitbash — cross-host agent skill format and compiler
Kitbash — cross-host agent skill format and compiler
为什么值得关注
Kitbash 把 agent skill 当作类似 npm/Docker/ESLint 的工程制品：一个稳定的 Kitbash Skill Format（KSF）加 compiler，把同一份 skill 编译到 Claude Code、Cursor、Copilot、Cline、Devin、Gemini CLI、Aider、AGENTS.md 等目标。最有价值的点不是“又一个格式”，而是它在编译期测量 standing token cost、维护 content-hash lockfile、drift detection、budget enforcement 和 stale-output pruning。
深度判断：值得晋升，因为它直接击中了 External-Agent-Skills-Design-Patterns 的核心问题：跨宿主复制 skill 会漂移；不同宿主 eager/lazy loading 会产生隐藏 token tax；没有 lockfile 和 budget，skill 生态会像无版本依赖一样腐化。
机制 / 一阶原理
Kitbash 的一阶原理是：skill 是有成本、有目标平台、有版本和依赖漂移风险的编译产物，而不是一段可随意复制的 Markdown。它把源 skill 与目标宿主分离，按目标支持的加载方式输出 native slash commands、AGENTS.md floor 或 vendor-specific 文件，并在编译时报告常驻 token 成本。
README 给出的关键机制包括：KSF manifest 稳定、kitbash init/install/compile、10 个目标、doctor/list/remove、budget enforcement、content-hash lockfile、drift detection、--strict 和 benchmarks。对 Hermes 来说，这与“methodology 层 + adapter 层”的设计原则高度一致。
与现有 wiki 概念的关系
- 对 External-Agent-Skills-Design-Patterns：补充 cross-host compilation、token budget、lockfile/drift detection。
- 对 Context-Engineering：把 standing token cost 作为 context budget 的可测指标。
- 对 Harness-Engineering：skill catalog 需要 doctor、strict mode 和 stale-output pruning 才能成为可靠 harness 组件。
- 对 AGENTS.md-Context-Files：AGENTS.md 可以作为最低公共目标，但不是所有宿主的最优加载方式。
对 Hermes / llm-wiki 的可执行启发
- 为外部 skill 关注名单增加 token-cost 维度：一个 README 很好的 skill，如果 eager load 成本高，也不应常驻。
- 未来 skill 改造要分 source 与 compiled output：
SKILL.md/references 是源，profile-specific 文件是产物，避免手工复制漂移。 - 引入 lockfile 心智模型：记录外部 skill 的 repo、commit、hash、权限和编译目标，便于审计和回滚。
- 把 wiki 页面晋升也看作编译：raw/source/concept/index/vector 是同一知识的不同产物，应检查 drift 和 stale output。
失败模式 / 边界条件
- Kitbash 生态仍早期；README 自称 KSF core stabilized，但 adapters、index、first-party skills 仍 experimental。
- 编译格式不能自动证明 skill 安全或有效；仍需 lint、sandbox、eval 和权限审计。
- Cross-host 最低公共目标可能牺牲宿主特性；过度抽象也可能隐藏关键差异。
- 今天只学习其工程模式，未安装 Kitbash 或编译用户 skill。
写入记录
- 2026-07-29 09:00 CST：基于 README 深度入库，提炼其对 Hermes / llm-wiki / agentic workflow 的机制启发、边界条件和未安装原因。