agent-builder

用途

Agent Builder 用于为任意领域设计与构建 AI 智能体，涵盖客户服务、研究、运营、创意工作或专门的业务流程。该技能适用于以下情况：用户要求“创建一个智能体”“构建一个助手”或“设计一个 AI 系统”，以及用户想理解智能体的工作方式。

核心理念

资料给出的核心哲学是：模型本身已经知道如何成为智能体，开发者的工作是不要挡路。智能体不是复杂工程，而是一个邀请模型行动的简单循环：

LOOP:
  Model sees: context + available capabilities
  Model decides: act or respond
  If act: execute capability, add result, continue
  If respond: return to user

资料强调，魔力不在于代码，而在于模型；代码只是提供机会。

三大要素

能力（Capabilities）——它能做什么：智能体可执行的原子动作，如搜索、读取、创建、发送、查询、修改。设计原则：从 3-5 个能力开始，仅当智能体因缺少某项能力而持续失败时再增加。
知识（Knowledge）——它知道什么：按需注入的领域专业知识，如政策、工作流、最佳实践、数据结构。设计原则：让知识可用而非必须，在相关时加载，而非前置加载。
上下文（Context）——发生过什么：连接各项行动、使之成为连贯行为的对话历史。设计原则：上下文很宝贵，隔离嘈杂的子任务，截断冗长输出，保护清晰度。

智能体设计思路

在构建之前，需要理解以下方面：目的（这个智能体应完成什么）、领域（它在哪个世界运作，如客户服务、研究、运营、创意）、能力（哪 3-5 个动作是必需的）、知识（它需要访问哪些专业知识）、信任（哪些决策可以委托给模型）。资料特别强调：信任模型，不要过度工程，不要预先规定工作流，给它能力并让它推理。

渐进式复杂度

从简单开始，仅当真实使用暴露出需求时才增加复杂度：

基础（Basic）：3-5 个能力，始终从这里开始。
规划（Planning）：进度跟踪，适用于多步骤任务失去连贯性时。
子智能体（Subagents）：隔离的子智能体，适用于探索污染上下文时。
技能（Skills）：按需知识，适用于需要领域专业知识时。

资料指出，大多数智能体永远不需要超过第二级。

领域示例

业务：CRM 查询、邮件、日历、审批
研究：数据库搜索、文档分析、引用
运营：监控、工单、通知、升级
创意：资产生成、编辑、协作、评审

资料称该模式是通用的，只是能力不同。

关键原则

模型就是智能体——代码只是运行循环；能力提供可能——它能做什么；知识提供信息——它知道如何做什么；约束聚焦——限制创造清晰；信任解放——让模型推理；迭代揭示——从最小开始，从使用中演进。

反模式

资料列出的反模式及应对：过度工程（需求之前先上复杂度）应对为从简开始；能力过多（模型困惑）应对为从 3-5 个开始；僵化工作流（无法适应）应对为让模型决定；前置知识（上下文膨胀）应对为按需加载；微观管理（削弱智能）应对为信任模型。

资源路由

仅加载当前任务所需的资源：

理解或讨论架构时，加载 references/agent-philosophy.md；当用户只需要可运行的起步代码时不要加载。
检查最小的完整循环时，加载 references/minimal-agent.py；当任务为概念性或提供商无关时不要加载。
添加或适配单个能力时，加载 references/tool-templates.py；当未请求实现时不要加载。
设计上下文隔离的子智能体时，加载 references/subagent-pattern.py；当单一智能体循环已足够时不要加载。
生成本地 Python 起步项目时，使用 scripts/init_agent.py；当用户只要求设计建议时不要加载。

提供商适用性

资料说明，架构与编排指导为提供商无关（provider-agnostic）。附带的 Python 起步代码当前使用 Anthropic SDK 与 Anthropic 模型配置；使用其他提供商时，需适配该实现层。不要将示例客户端误认为必需的智能体架构。

限制与安全

资料指出，Python 资源是面向学习的示例，而非安全边界。其 shell 能力默认需要用户批准；生产系统仍需要隔离、最小权限、审计日志以及适合其威胁模型的政策。

智能体思维

资料建议的思维转变：从“我如何让系统做 X？”转为“我如何让模型能够做 X？”；从“这个任务的工作流是什么？”转为“哪些能力有助于完成它？”资料认为，最好的智能体代码几乎是无聊的——简单的循环、清晰的能力、干净的上下文；魔力不在代码中。给模型能力与知识，然后信任它去弄明白其余部分。

暂未提供的信息

资料未提供该技能的具体收费与价格信息、支持平台列表、版本更新记录以及与其他工具的集成方式，这些内容暂未提供。