keli-wen/agentic-harness-patterns-skill

AI编码代理的制作设计模式，提取自512,000行Claude代码。

英语 ·中文

---

[!提示] 这是如何构建的： 阅读《蒸馏Claude代码源代码——线束工程实践日志》，了解Codex与Claude代码如何协作、受PCA启发的口味注入，以及哪些有效（哪些无效）。

模型循环很简单。[User -> LLM -> tool_use -> execute -> loop 简直贴在餐巾纸上。使生产代理真正能够可靠、安全、大规模运行的，是环绕环圈的一切：跨会话持续存在的内存、关闭时失败的权限、不会崩溃的上下文预算、不会崩溃成混乱的多代理协调，以及不会成为安全漏洞的可扩展性。

Anthropic称之为“背带”。这个仓库教你如何制作一个。

[!注] 该技能兼容开放代理技能生态系统。使用npx skills add安装——可使用Claude Code、Codex及其他40+代理。

这是什么

Production design patterns for AI coding agents, distilled from 512,000 lines of Claude Code.

English · 中文

---

[!TIP] How this was built: Read the Distilling Claude Code Source — A Harness Engineering Practice Log for the full story of how Codex and Claude Code collaborated, the PCA-inspired taste injection, and what worked (and didn’t).

The model loop is easy. User -> LLM -> tool_use -> execute -> loop fits on a napkin. What makes a production agent actually work — reliably, safely, at scale — is everything around the loop: memory that persists across sessions, permissions that fail closed, context budgets that don’t explode, multi-agent coordination that doesn’t collapse into chaos, and extensibility that doesn’t become a security hole.

Anthropic calls this the harness. This repo teaches you how to build one.

[!NOTE] This skill is compatible with the open agent skills ecosystem. Install with npx skills add — works with Claude Code, Codex, and 40+ other agents.

What This Is

6 design-pattern chapters and 11 deep-dive references, extracted from systematic source-level analysis of the Claude Code runtime — the production AI coding agent behind Claude’s 512,000-line TypeScript codebase.

[!IMPORTANT] This is not a code dump or a source mirror. Every pattern is expressed as a portable, runtime-agnostic design principle. Claude Code is used as grounding evidence, not as the only possible implementation. If you’re building an agent on a different stack, these patterns still apply.

Also not: A Claude Code user guide / prompt engineering tutorial / “agents 101” / model selection guide.

Who Should Read This

Engineers building or extending:

• Coding-agent runtimes (like Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf)
• Custom agents and agent plugins
• Multi-agent orchestration systems
• Any production system where an LLM calls tools in a loop and needs to be reliable

The Six Harness Layers