Agent 开发指南：技术太多，该怎么学？

• 原文链接：https://mp.weixin.qq.com/s/Mx1pclSLzkRFXKEME24TYA
• 作者：lencx
• 发布：2026-07-28
• 原始素材：[[2026-07-lencx-Agent开发指南-技术太多-该怎么学]]

核心结论

Agent 原生软件的目标不是最大自治，而是让不完全可靠的推理者在可靠系统中持续承担责任。代码生成越便宜，越需要把身份、状态、执行、验证、副作用、恢复和人工接管设计成确定边界。

分类提炼

• 场景：生产级 Agent / 跨应用自动化 / 开发者平台
• 类型：Agent 基础设施趋势研究，横跨 Harness、状态、浏览器、宿主、语言和 Skills
• 分类理由：文章的主问题是 Agent 如何从回答走向可托付的持续执行，核心落在任务状态、能力授权与验证，而非某一个语言或框架的教程。
• 证据口径：区分已发生事实、趋势推断和预测；项目方性能与成本数据视为项目自报。

知识节点

• 可信完成：生产 Agent 的完成状态应由测试、可测指标、diff、截图、外部状态或人工验收证明，而不是模型声称“已完成”。
• 动作回执：对会产生副作用的调用保存稳定动作 ID、幂等键和 receipt；超时或崩溃后先 reconcile，再决定恢复、补偿或人工处理。
• Harness 边界：Context 管一次采样的有限视野，Loop 管时间轴，Graph 管拓扑，Skill 管规程；Harness 持有目标并协调它们形成可恢复执行。
• Goal 契约：长任务至少要显式声明 outcome、constraints、verifier 和 budget，并在 completed、blocked、needs-input 等终态间可审计地转换。
• 五类记忆：工作状态、事件历史、领域知识、情节偏好、身份隐私拥有不同的一致性、TTL 与恢复语义，不能统一视作“向量库”。
• 状态合流：CLI、桌面、IM Gateway 与通知只是不同工作表面，运行、等待输入、审批、阻塞和结果必须来自同一持久任务状态。
• 浏览器能力平面：浏览器同时汇聚高权限身份、不可信网页、真实动作与人机接管，必须隔离 profile、限制网络与下载、保留 trace，并对高风险行为确认。
• Agent-readable surface：JSON Schema、稳定 ID、幂等键、dry-run、结构化错误、退出码、artifact manifest 和可比较 trace 让接口可被可靠调用与验证。
• Skill 供应链：Skill 是带版本、来源、权限、评测、恢复和回滚的程序性知识；发现、安装、激活、执行应分别授权和审计。

关联图谱

上游（基于 / 来自）

• [[harness-engineering]]：本文将 Harness 从“工程环境”扩展为跨状态、身份、恢复和验证的责任外壳。
• [[图工程-Graph-Engineering-来了-LangChain说不是新东西]]：Graph 只描述任务拓扑，本文将它放回 Context、Loop、Skill 与 Harness 的边界关系中。
• [[OpenClaw-vs-Hermes-多-Agent-架构设计]]：该文的 Gateway、进程和会话边界，可解释本文所说的异步入口与状态合流。

下游（应用于 / 验证于）

• [[Loop-Engineering-验证才是瓶颈]]：本文“可信完成”的判断由 Loop 中的验证器、回归和证据闭环具体化。
• [[若飞-Agent-记忆与可验证自我改进怎么设计]]：五类记忆的分层进一步落到候选经验准入、证据、权限与回滚链。
• [[腾讯-AI-Agent-Skill-测评方案落地]]：本文主张的 verifier、负向路径和副作用验证，可在 Agent 评测维度与基线中落地。

同级（横向 / 并列）

• [[Skill-Self-Evolution]]：二者都把 Skill 视为程序性资产；本文补上发现、安装和执行的供应链治理，后者聚焦独立验证下的演化。
• [[架构腐朽与Loop-Engineering]]：同为 lencx 的工程反思，前者讨论长期代码与反馈循环，本文扩大到整个 Agent 执行基础设施。

正文要点

1. 先定义“完成”，再设计恢复。 对每个任务先说明何种证据可通过、哪些副作用不可重试、每个中断点如何对账，以及何时必须交回人类。
2. 把长任务当作状态机。 任务、步骤、动作、预算、资源租约与审批需要稳定身份；未知外部结果不能用盲目重试掩盖。
3. 把入口和运行时分离。 CLI 可保持高密度、脚本化的行动闭环，桌面与 IM 承担可视化监督和异步触达，但不应各自维护一份会话真相。
4. 让浏览器成为受治理的能力，而非无边界工具。 CDP 提供机械控制，WebMCP 试图声明页面业务语义；两者都仍需要 origin、身份、权限、审批与动作证据。
5. 按系统责任选择技术，而非按热点选择语言。 TypeScript/Python 连接产品和生态，Rust/Go/Zig 覆盖不同的运行时与分发边界；先度量冷启动、延迟、崩溃、跨平台和维护成本。
6. 把 Skill 当作有生命周期的操作资产。 对 Skill 的版本、owner、兼容矩阵、所需能力、脚本审查、行为 eval、失败恢复和退役规则做显式管理。

采用边界与相关链接

• 文中列举的收购、实验性 API、性能数据和路线图不构成稳定产品承诺，落地前应验证发布日期、当前兼容性和原始公告。
• “Agent-readable surface”是本文归纳的工程方向，不等同于某个单一标准；MCP、WebMCP、CLI contract 与 Agent Skills 仍在并行演进。
• [[2026-07-lencx-Agent开发指南-技术太多-该怎么学-digest]]：7 个分析角度和 21 个写作钩子。
• [[harness-engineering]]、[[Loop-Engineering-验证才是瓶颈]]、[[若飞-Agent-记忆与可验证自我改进怎么设计]]、[[Skill-Self-Evolution]]：可按 Harness、验证、Memory、Skill 四条主线继续查询。