SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场agent-builder

agent-builder

智能体与模型

查看项目

更新于 10-16 10:25

技能介绍

Agent Builder Skill 用于构建和部署 Claude Agent SDK 应用，目标环境为 Hetzner VPS。其元数据为：名称 agent-builder，版本 1.1.0，作者 KnearMe，标签包括 claude、agent-sdk、skills、vps、deployment。

适用场景

该技能适用于以下情况：创建新的 AI 智能体应用（编码或非编码用途）；设计智能体行为、升级路径与决策边界；将智能体部署到 Hetzner VPS；搭建多智能体架构；排查智能体部署问题。

非开发优先原则

应始终考虑非开发用途。许多高价值智能体聚焦工作流而非代码，例如：客户支持分流、销售资格评估、运营清单、营销内容协调、财务/QA 审查、招聘或入职工作流。如果请求为非开发或混合类型，应先从发现与工作流设计入手，再编写代码。

设计到构建的起点

  1. 定义结果、用户与触发条件 → references/agent-design-guide.md
  2. 选择架构模式 → references/architectures.md
  3. 按最小权限原则选择工具 → references/tool-development.md
  4. 定义角色与升级规则 → references/role-definition.md
  5. 监控与改进 → references/performance-monitoring.md 与 references/improving-agents.md
  6. 如需要则添加 UX → references/ui-development.md
  7. 发布前测试 → references/testing-guide.md

参考文档地图（渐进式披露）

  • references/agent-design-guide.md — 发现、用例匹配、工具决策树、反模式
  • references/architectures.md — 单智能体、编排器+子智能体、多智能体集群
  • references/role-definition.md — 角色提示、委派模式、升级触发条件
  • references/tool-development.md — 工具选择、MCP 工具、护栏
  • references/performance-monitoring.md — 指标、预算、告警、日志
  • references/improving-agents.md — 反馈循环、评估、回归测试
  • references/ui-development.md — 聊天 UX 模式与组件示例
  • references/testing-guide.md — 测试策略、夹具、模拟、评估
  • references/react-chat-component.tsx — 可直接使用的聊天 UI（React）
  • references/agent-template.ts — 完整的智能体服务器模板
  • references/non-dev-templates.md — 扩展的非开发模板（支持、销售、运营、营销、财务）
  • references/background-agents.md — 后台/自主角色执行模式
  • references/self-improving-agents.md — 自我改进智能体循环（AlphaEvolve 模式）

Claude Code Skill 编写规则

  • 必需前置元数据：name（小写，连字符或下划线）与 description（技能做什么 + 何时使用）。
  • 可选 allowed-tools：若存在，则限制 Claude Code 中的工具；若省略，则技能文件不限制工具。
  • 保持简短：SKILL.md 尽量控制在约 500 行以内，长内容移至 references/。
  • 渐进式披露：参考文件链接最多一层深度（不得嵌套参考链）。

快速开始

创建新智能体：

mkdir my-agent && cd my-agent
npm init -y
npm install @anthropic-ai/claude-agent-sdk express ws
# 完整服务器模板见 references/agent-template.ts

部署到 VPS（简版）：每台服务器运行一次 scripts/setup-vps.sh；每个智能体使用 scripts/deploy-agent.sh；多智能体部署见 references/architectures.md。

非开发智能体模板

当目标是业务工作流影响而非编码时使用。扩展模板见 references/non-dev-templates.md。

  1. 支持分流智能体
  • 结果：在 2 分钟内给出准确类别与下一步行动
  • 触发：创建新工单或聊天
  • 输入：工单文本、用户方案、最近 5 次交互
  • 输出：优先级、摘要、建议回复、升级标记
  • 工具：Read、Glob、Grep、AskUserQuestion（草稿用 Write）
  • 升级条件：退款、安全、法律威胁、愤怒用户
  • 模式：单智能体 → 随量增长改为编排器+子智能体
  1. 销售资格评估智能体
  • 结果：线索评分 + 建议下一步
  • 触发：入站表单或销售收件箱消息
  • 输入：表单字段、来源、公司规模、既往联系
  • 输出：匹配分数、异议、建议回复
  • 工具：Read、Glob、Grep、AskUserQuestion（草稿用 Write）
  • 升级条件：企业级/法律要求、定价例外
  • 模式：单智能体
  1. 运营清单智能体
  • 结果：完成运行手册并给出清晰状态
  • 触发：每日/每周运营节奏、事件清单
  • 输入：运行手册文件、系统状态快照
  • 输出：清单状态、异常、建议后续
  • 工具：Read、Glob、Grep（仅在严格必要时用 Bash）
  • 升级条件：信号缺失、关键阈值
  • 模式：单智能体（系统多时为编排器）
  1. 营销内容协调智能体
  • 结果：符合品牌调性的草稿 + 分发清单
  • 触发：新活动请求或内容简报
  • 输入：品牌语调文档、产品更新、目标画像
  • 输出：内容草稿、渠道清单、CTA 选项
  • 工具：Read、Glob、Grep、Write、Edit
  • 升级条件：声明需法律审查、敏感话题
  • 模式：编排器+子智能体（研究员/撰稿人/审查者）
  1. 财务/QA 审查智能体
  • 结果：标记异常 + 建议后续
  • 触发：月度结账、QA 批次或审计请求
  • 输入：报告、阈值规则、上期基线
  • 输出：发现列表、置信度、下一步
  • 工具：Read、Glob、Grep（除非草拟否则不用 Write）
  • 升级条件：大幅偏差、政策违规
  • 模式：带严格约束的单智能体

非开发决策清单：事实来源是否清晰可访问？哪些操作是建议性的、哪些是自动的？什么需要人工批准？升级触发条件是什么？成功如何以可衡量方式定义？仍能工作的最低风险工具集是什么？

后台智能体（摘要）

离散任务（事件、cron）使用基于作业的执行；实时路由与监控使用连续执行；将权限映射到自主性阶梯并强制执行升级规则。完整模式见 references/background-agents.md。

自我改进智能体（摘要）

使用生成 → 评估 → 提升循环并配合自动评估器；将最佳提示/工作流视为随时间演化的“技能库”；仅在固定回归套件上指标改善时才提升。AlphaEvolve 启发的模式见 references/self-improving-agents.md。

架构模式（摘要）

  • 单智能体：单领域、逻辑简单
  • 编排器 + 子智能体：多专业、并行工作
  • 多智能体集群：独立产品/领域 完整决策树见 references/architectures.md。

SDK 要点（摘要）

const response = query({
  prompt,
  options: {
    systemPrompt,
    allowedTools: ["Read", "Glob", "Grep", "Task", "Skill"],
    agents: SUBAGENTS,
    permissionMode: "acceptEdits",
    settingSources: ["user", "project"],
  },
});
  • 子智能体要生成，Task 必须在 allowedTools 中
  • 子智能体不能生成其他子智能体
  • 技能仅在设置 settingSources 且 allowedTools 中含 "Skill" 时加载
  • 包含 "project" 以加载 CLAUDE.md 指令
  • allowed-tools 前置元数据适用于 Claude Code CLI，而非 SDK
  • 流式/会话示例见 references/agent-template.ts

部署与运维（摘要）

使用 scripts/setup-vps.sh + scripts/deploy-agent.sh；在 Web UI 前放置 Nginx + SSL；跟踪延迟、成本与错误预算（references/performance-monitoring.md）；添加反馈循环与评估（references/improving-agents.md）。

测试与质量（摘要）

测试行为而非措辞，保留回归夹具；验证工具安全边界与升级路径。完整模式见 references/testing-guide.md。

资源

  • Claude Agent SDK 文档：https://docs.anthropic.com/claude-code/agent-sdk
  • Hetzner Cloud Console：https://console.hetzner.cloud
  • PM2 文档：https://pm2.keymetrics.io/docs
  • Cloudflare Tunnel 文档：https://developers.cloudflare.com/cloudflare-one/connections/connect-apps

脚本

  • scripts/setup-vps.sh — 初始 VPS 配置
  • scripts/deploy-agent.sh — 部署新智能体
  • scripts/new-agent.sh — 脚手架生成新智能体项目