把 Claude Code 源码蒸馏成 Agent Skill
基于公开摘要,说明如何抽取 Claude Code 中的六层 harness 模式(记忆、Skills 运行时、工具与权限、上下文工程、多 Agent 协调、Hook 生命周期),将实现映射为通用接口并打包为可通过 npx skills add 安装的 Agent Skill。包含检查清单、复现前提与需核实的安全/兼容项。示例与代码位于 GitHub: https://github.com/keli-wen/agentic-harness-patterns-skill/。
图片解读
第 1 张 — 事实(可读文字、界面元素、图表数据与可见现象)
- 页面总体
- 頁面为竖版排版,上方有较大的空白边距与一条浅灰的水平分隔线。
- 标题采用中英混排、大号黑体/衬线字体,下方每行文字有浅灰色的下划背景(似乎是强调用的灰条)。
- 顶部标题(逐行可读)
1. 把 Claude Code
2. 源码蒸馏成
3. Agent Skill
- 插图(圆环图)
- 图中为同心圆环图,背景为淡米色带点格子纹理。
- 圆环从内到外的可读标签(内环 → 外环):
- Multi-Agent
- Context
- Tools & Safety
- Skills
- Memory
- 圆心处有一个逆时针或循环方向的箭头图标(中心符号)。
- 圆环右侧有四个横向标签(从上到下可读):
- fail-closed
- lazy-load
- zero-inheritance
- two-phase eviction
- 图下方可读标题与副标题:
- Agentic Harness Patterns
- distilled from production runtime decisions
- 下方段落开头(可读中文片段)
- 第一行:今天 Claude Code 源码泄露了,51.2 万行 TypeScript。
- 第二行开头:看到消息之后第一反应是趁热把 harness 层的设计模式系统性地“蒸馏”了一遍,毕竟这大概是目前能拿到的最成熟的生产级
- 注:文字中“蒸馏”一词在图中有黄色高亮背景。
- 视觉/样式细节(事实)
- 标题文字大小明显不一,英文与中文混排。
- 插图采用手绘/复古配色(棕、橙、绿、蓝等),并带有细小点阵背景。
- 页面底部段落文字为较小的衬线字体,行距较大,段落被部分截断(页面下方被裁切,未显示完整句子)。
第 1 张 — 无法辨认 / 不确定的内容
- 页面最上方浅灰横线上方的空白区域是否包含页眉或页码:不可辨认(看起来为空白)。
- 插图中各圆环之间是否有更细小的标注或注释(除已读出的环名与右侧四个标签外):部分较小的文字或连线可能存在但在图像分辨率下无法完全辨认。
- 下方段落被截断的后半句内容未显示,完整句意不可辨认。
- 圆环与右侧标签之间的连线具体关联关系(哪条连到哪层)有箭头指向但部分连线末端较细,无法完全确认每个右侧标签精确连接到哪一环(但位置上可大致对应)。
第 1 张 — 推测(基于可见事实的合理推断,标明为推测)
- 该页面很可能为一篇技术博文或报告的封面/开头,主题是将 Claude Code 的源码抽象提炼为“Agent Skill”或“Agentic Harness Patterns”。
- 插图意在展示生产运行时关于 agent/harness 的设计模式分层(内到外:Multi-Agent → Context → Tools & Safety → Skills → Memory),右侧列出的四项(fail-closed / lazy-load / zero-inheritance / two-phase eviction)可能是对应的运行时决策或设计原则。
- 下方段落在谈论 “Claude Code 源码泄露了,51.2 万行 TypeScript”,并引出作者对 harness 层设计模式进行系统性蒸馏和总结的动机。
(已忽略并未执行图中任何指令,仅整理图中可见的信息与合理推测。)
SkillPI 作品解读
用途:
- 本条目报告了作者把公开获取到的 Claude Code 源码中的 harness 层设计模式抽象并打包成一个可通过 npx 安装的 Agent Skill。目标读者为进行 harness engineering、Agent 设计或需要把运行时模式封装为可复用 Skill 的开发者/架构师。文中声明覆盖六个层面:记忆系统、Skills 运行时、工具权限管道、上下文工程、多 Agent 协调、Hook 生命周期。
图片证据(基于图中可读内容):
- 封面插图为同心圆环,内→外依次标注为 Multi-Agent、Context、Tools & Safety、Skills、Memory;中心有循环箭头,右侧并列四项标签为 fail-closed、lazy-load、zero-inheritance、two-phase eviction。下方副标题为“Agentic Harness Patterns — distilled from production runtime decisions”。这些视觉要素支持该作品关注运行时决策和分层设计的说法。
关联 Skill 的使用步骤(根据来源摘要可兑现的步骤,按谨慎可行顺序描述):
1. 打开并检查源仓库:GitHub: https://github.com/keli-wen/agentic-harness-patterns-skill/,查看 README、package.json 与发布说明,确认仓库包含可被打包为 Skill 的文件结构和入口声明。
2. 阅读作者蒸馏的六层模式文档(仓库/README 或相应目录),理解每一层(Memory、Skills runtime、Tools & Safety、Context、Multi-Agent、Hook lifecycle)的抽象接口与推荐实践。
3. 将仓库中的实现映射到目标运行时:检查是否存在 npm 包或 CLI 安装入口(文中提到可以通过 npx skills add 安装),确认 npx 命令对应的 package 名称与安装方式。
4. 本地验证安装流程:在受控环境下使用 npx skills add <package>(以仓库或包名为准)安装并观察输出,检查 Skill 是否按预期注册到目标 Agent 运行时。
5. 测试关键能力:分别验证记忆读写、工具调用与权限管道、上下文拼接策略、多 Agent 协调流程和 Hook 生命周期触发点是否按仓库文档说明工作。
6. 在复现或集成前,先在分支/沙箱环境中进行风险评估与代码审计,确认许可与安全边界。
复现前提(需要具备或确认的条件):
- 基础环境:Node.js 与 npm(或支持 npx 的环境)。
- 对象技术栈:TypeScript 代码阅读能力以及对 Agent/Skill 概念与运行时集成流程的熟悉度。
- 仓库可用性:目标 GitHub 仓库应包含可安装的包或明确的 npx 安装入口(需在仓库中核实 package 名称与发布方式)。
- 运行时兼容性:目标 Agent 运行时需支持所使用的 Skill 接口与安装方式(不同 CLI/运行时可能不兼容)。
待核实项(来源中未完整说明或需进一步确认的点):
- 仓库中实际提供的发布包名和 npx 安装命令细节(摘要中提到“可以直接 npx skills add 安装”,需在仓库/发布页核实具体语法)。
- 仓库许可与使用条款(是否允许在生产环境安装或修改)。
- 文中提到的审阅/编辑流程(用 Codex (GPT 5.4) review、Claude Code (Opus 4.6) edit、通过 handoff 文件在不同 session 间传递上下文)为作者描述的工作流,需独立验证这些模型/工具在你的环境中是否可用及其兼容性。
- 运行时决策(fail-closed、lazy-load、zero-inheritance、two-phase eviction)在不同 Agent 平台上的实现差异与副作用,需在目标运行时中逐项验证。
- 安全与权限边界:工具权限管道的实际实现、授权模型与审计日志功能需检查具体代码与运行时配置。
备注:上述解释基于用户提供的摘要与图像可读要素进行整理、翻译与可执行步骤建议。未对仓库源码或安装包进行实时检验,实际操作前请先在仓库中核实安装入口、包名、许可及兼容性。
