《ClaudeCode实战：Harness工程之道》读书笔记

⬛️四层架构模型：记忆层、扩展层、集成层、编程层 ◼️记忆层——CLAUDE.md ▪️1温故知新：Claude.md 五个层级的记忆体系：企业级->用户级->项目级->规则级->本地级 ◼️扩展层——四大组件 Commands、Skills、SubAgents、Hooks 它们之间呈现出正交性，遵循了软件工程中的单一职责原则(Single Responsibility Principle, SRP) ▪️2授人以渔：Skills(Commands已整合为任务型Skills) 四大核心设计：渐进式披露、语义触发、安全约束、动态注入 ▪️3分而治之：SubAgents 核心思想：委派式思考 三大核心价值：上下文隔离、权限约束、模块复用 五种子智能体模式：只读型、执行型、并行型、流水线型、团队型 ▪️4防微杜渐：Hooks 事件生命周期：17种事件（不需要死记硬背） 配置体系：企业策略配置、项目配置、项目本地配置、用户全局配置、插件内置Hooks、子智能体frontmatter内联Hooks 三种处理器类型：command类型、prompt类型、agent类型 引入异步Hooks：后台执行不阻塞 ◼️集成层——连接外部世界 面向工具生态——MCP，将外部数据与服务引入ClaudeCode。 面向自动化流水线——Headless模式，将ClaudeCodw无缝嵌入既有的CI/CD体系。 ▪️5海纳百川：MCP 连接的标准化：从 M*N 到 M+N 三大核心能力：Tools、Resources、Prompts 三种传输方式：stdio(本地)、HTTP(远程)、SSE(已废弃) ▪️6无为而治：Headless模式与CI/CD集成 四个维度的核心参数体系：输出格式、成本护栏、安全边界、执行控制 ◼️编程层——Agent SDK ▪️7器以载道：Agent SDK 核心API、消息类型、ClaudeAgentOptions、会话管理、自定义工具、Agent SDK Hooks 四道安全防线：权限模式、工具白名单、canUseTool回调、PreToolUse Hooks ⬛️打包与分发——Plugins ▪️8集腋成裘：Plugins Plugin设计原则：单一职责、渐进式迭代、最小权限、文档是必需品 ⬛️底层视角：Harness与Agentic Loop Agent = Model + Harness