如何优化你的 AI Harness:配置、框架与子代理指南
文章指出工程师的关注点已从 IDE 转向 AI Harness,并介绍了提升 Harness 输出质量的关键方法。核心策略包括:保持配置文件(如 .md)精简,采用渐进式披露原则以节省上下文;利用 R.P.I 框架(Research, Plan, Implement)像资深工程师一样分解问题;以及通过子代理清理主上下文窗口。文章强调,Harness 的核心在于工程判断力。
文章指出工程师的关注点已从 IDE 转向 AI Harness,并介绍了提升 Harness 输出质量的关键方法。核心策略包括:保持配置文件(如 .md)精简,采用渐进式披露原则以节省上下文;利用 R.P.I 框架(Research, Plan, Implement)像资深工程师一样分解问题;以及通过子代理清理主上下文窗口。文章强调,Harness 的核心在于工程判断力。
文章深度剖析了前沿AI代码工具的配置优化,给出了如R.P.I.框架和渐进式上下文披露等极具操作性的实用建议,且内容契合2026年技术环境,时效性极佳。
文章指出大多数开发者像使用初级工程师一样使用 Claude Code,缺乏有效的流程。作者提出了一套利用 Claude Code 内置原语(Plan Mode、Subagents、Hooks 等)构建的 9 步闭环流程,旨在模拟资深工程师的工作方式。该流程强调在编写代码前先探索代码库并制定计划,使用 CLAUDE.md 固化标准,利用 Hooks 强制执行不可协商的规则,并通过独立 Agent 进行代码审查,从而实现高质量、自动化的代码交付。
本文深入探讨了 Agent Harness 的概念,即包裹在 LLM 外部、将无状态模型转化为可用智能体的完整软件基础设施。文章引用了 Anthropic、OpenAI 和 LangChain 的实践,详细拆解了生产级 Harness 的 12 个核心组件(如编排循环、记忆系统、上下文管理、验证循环等),并阐述了如何通过优化这层“操作系统”来解决遗忘、工具调用失败和上下文腐烂等工程难题。
文章探讨了 Claude Code 在处理数百万行级单体仓库及遗留系统时的成功模式。区别于传统 RAG 工具的嵌入索引滞后问题,Claude 采用本地代理式搜索实时导航。核心论点指出,工具链生态(CLAUDE.md、钩子、技能、LSP 集成等)的重要性远超模型本身。文章详细解析了七大扩展点,并建议通过渐进式配置与插件分发来提升在大型复杂代码库中的协作效率。
本文详细介绍了 Claude Code 的会话管理策略。在 100 万 Token 上下文窗口的背景下,文章探讨了上下文衰减、压缩与清空的区别、回溯功能的优势以及子智能体的应用。文章指出,理解何时开新会话、如何有效利用 /rewind 修正错误,以及通过压缩或清空管理上下文,是提升 Claude Code 使用体验的关键。
文章系统解释了 AI 领域中 harness(套件/执行框架)的概念。作者指出 LLM 默认只能生成文本,要真正执行操作需要工具、调用语法、解析系统、结果回传和工具清单,这一切组成了 harness。文中区分了界面(如 Claude Code 的 TUI/GUI)与底层 harness(如 Anthropic Agent SDK、Codex App Server),并用厨房比喻说明 harness 与工具的关系。文章还解释了 MCP 的作用——类似'食谱',让代码可以在外部运行,以及 agent 的定义:LLM 与 harness 的结合体。
作者基于 Anthropic 工程师删除 Claude Code 80% 系统提示词却无性能损失的事实,反思提示词与 Agent Skill 的实践方法。提出提示词不是八股文,应聚焦任务三要素(目标、规则、完成标准),减少角色铺垫和冗余规则,多给思考方向而非僵硬示例,并设定明确验收标准。关于 Skill 沉淀,强调只有高频且流程稳定的任务才值得做成 Skill,要写入独特经验而非通识废话,严格控制单一职责与边界,主文件精简并渐进式加载,且必须内置自检环节形成质检闭环。
文章探讨了开发者对 AGENTS.md 和 CLAUDE.md 等 AI 编程工具说明文件的普遍误解。作者指出,很多团队把所有希望 AI 做到的事都写进一个不断膨胀的文件,导致维护规则本身成了负担,本末倒置。正确的做法是让 AGENTS.md 保持精简(作者根文件不到 50 行),只写每次开工都需要知道的少数核心事项,再指向不同任务对应的规则文件,让 Agent 按需读取。作者引用西蒙'存储信息'与'需要时获取信息'的区分,并提醒只有在流程确实需要反复执行时才值得做成 Skill,不必急于按需调用。
本文探讨了AI Agent开发中开放Harness与记忆所有权的重要性。作者引用Harrison Chase的观点——'不拥有Harness就不拥有记忆',并区分了Memory(从上下文窗口记录的事实,如用户偏好、仓库知识)和Intelligence(利用这些事实让会话更智能的机制)。文章详细介绍了Mem0的方案:通过custom_instructions和infer=False控制记忆提取,用语义+BM25+实体搜索进行检索,并借助Dream实现记忆合并、替代与综合。作者主张将记忆层置于Harness之外,存储于SQL、向量数据库和实体存储中,从而实现跨Harness的记忆与智能的可移植性,即使前沿实验室的循环保持封闭。
文章从工程视角系统讲解 Agent 概念:首先对比 AI 应用的三种形态——Chatbot(对话驱动)、Workflow(预设流程)与 Agent(ReAct 自主循环),分析各自优缺点及区分方法;随后给出最小 Agent 的循环伪代码,演示思考-决策-行动-感知的闭环机制;再梳理生产级 Agent 所需的八大能力模块,包括上下文管理、任务管理、记忆、连接器、Trace、容灾、编排与安全;最后探讨实际工程中三者混合使用的架构策略,如 Agentic Workflow、Workflow 包装为工具、前置路由分发等。
文章提出 Skill 本质是一个微型 Harness,一个完整 AI 工作系统包含六层:信息边界、执行编排、记忆与状态、工具系统、约束恢复、评估观测。作者给出六步写作法:先写 description 作为触发开关,再按任务脆弱程度定正文松紧,超过 500 行的资料拆成参考文件,重复操作固化为脚本,写明失败时的默认行为,最后用真实任务验证迭代。文章强调 description 是主要触发机制、模型天生欠触发、上下文窗口是公共资源、卡的下限由失败处理决定等实战经验,并提供最小可用卡模板和发布前检查清单。
本文从《给宝宝的机器人学》类比切入,系统讲解 Agent 的核心概念与发展脉络:大模型只负责生成回答,而 Agent 能借助工具、API、Agent Loop 和文件/终端等真实工作现场,把任务完整做完。文章依次介绍模型、Tool 与 API、Agent Loop、computer use、MCP 协议,以及 Claude Code、Codex CLI 到 Codex 桌面端的产品演进,说明为何同一个模型放进不同 Harness 表现差异巨大。最后以实战演示如何用 Codex 搭建论文资料整理 Agent,从建立项目结构、规划执行到接入 PubMed 检索工具,展现普通人也能上手的 Agent 工作流。