内容
# 代理标准库
用于构建代理的标准库。
Anthropic 的工程博客记录了如何构建、评估和运行生产环境中的代理。大多数知识从未被封装成可安装的软件包；它们仍然是文本，您在遇到问题时需要重新阅读。`agent-stdlib` 打包了其他人没有的内容：一组技能、几个 MCP 服务器和两个安全钩子。
每个组件都指明了它来自的文章，并说明了它与已经涵盖类似内容的技能有何不同。该软件包只包含缺少的内容。已经被强大社区技能涵盖的主题将保持在外，下面提供指向它们的链接。
它作为 Claude Code 插件安装，技能、MCP 服务器和脚本在底层是与代理框架无关的。要在 OpenCode、Cursor、Cline 或任何模型上的自定义代理上运行它们，请参见 [AGENTS.md](AGENTS.md)。
## 技能
| 技能 | 提供内容 | 来源文章 |
|-------|-------------------|----------------|
| `build-agent-evals` | 为代理构建自动评估：选择评估器，选择 pass@k 或 pass^k，运行从零到一的路线图 | [解析 AI 代理的评估](https://www.anthropic.com/engineering/demystifying-evals-for-ai-agents) |
| `calibrate-eval-infrastructure` | 停止容器资源限制对基准测试分数的影响 | [量化代理编码评估中的基础设施噪声](https://www.anthropic.com/engineering/infrastructure-noise) |
| `reward-hacking-and-inoculation` | 防止代理利用可检查的目标，使用接种提示和评估器来支付工作量 | [奖励黑客和突现不匹配](https://www.anthropic.com/research/emergent-misalignment-reward-hacking) |
| `auditing-agent-behavior` | 自动红队一个代理：审计员运行场景，法官评估欺骗、阿谀奉承等 | [Petri，开源审计](https://www.anthropic.com/research/petri-open-source-auditing) |
| `coding-agent-scaffold` | 为编码代理设计两工具（bash + 文件编辑器）接口，以便模型停止滥用它 | [提高 SWE-bench 验证的水平](https://www.anthropic.com/engineering/swe-bench-sonnet) |
| `advanced-tool-use` | 通过几个工具访问大型工具目录：按需搜索、代码调用、示例学习 | [高级工具使用](https://www.anthropic.com/engineering/advanced-tool-use) |
| `durable-agent-architecture` | 将代理服务分成大脑、执行和会话，以便任何部分都可以崩溃并恢复 | [扩展托管代理](https://www.anthropic.com/engineering/managed-agents) |
| `agent-reliability-and-change-management` | 在不降低运行中的代理性能的情况下发布更改，并保持长期运行的可靠性 | [最近三个问题的事后分析](https://www.anthropic.com/engineering/a-postmortem-of-three-recent-issues) |
| `sandboxing-agentic-systems` | 逐层隔离运行代码或读取不受信任内容的代理 | [我们如何隔离 Claude](https://www.anthropic.com/engineering/how-we-contain-claude) |
| `defending-against-prompt-injection` | 防止代理服从隐藏在页面、电子邮件和文件中的指令 | [减轻越狱和提示注入](https://platform.claude.com/docs/en/test-and-evaluate/strengthen-guardrails/mitigate-jailbreaks) |
| `constitutional-classifiers` | 根据您编写的内容策略，使用合成数据加固，对代理的输入和输出进行筛选 | [宪法分类器](https://www.anthropic.com/research/constitutional-classifiers) |
| `using-the-think-step` | 确定在什么时候中间推理步骤有帮助以及如何提示它 | [“思考”工具](https://www.anthropic.com/engineering/claude-think-tool) |
| `multi-agent-orchestration` | 运行一个带有并行子代理的编排器-工作器研究系统 | [我们如何构建多代理研究系统](https://www.anthropic.com/engineering/multi-agent-research-system) |
| `parallel-autonomous-agents` | 在一个 git 仓库中协调不受监督的代理，使用锁定文件和自主循环 | [使用并行 Claudes 构建 C 编译器](https://www.anthropic.com/engineering/building-c-compiler) |
## 安装
添加市场并安装插件：
```
/plugin marketplace add pebeto/agent-stdlib
/plugin install agent-stdlib@agent-stdlib
```
技能在任务与描述匹配时会自行触发。您也可以使用 `Skill` 工具显式加载一个技能。
## MCP 服务器
三个服务器位于 `mcp-servers/` 下，每个服务器都与一个技能配对。它们需要 [`uv`](https://docs.astral.sh/uv/)，它会在第一次运行时从脚本头部安装每个服务器的依赖。
- **think**（已启用）。空操作 `think` 工具，与 `using-the-think-step` 配对。
- **tool-gateway**（已启用）。通过更大的目录搜索工具和调用工具，以便代理通过两个工具访问许多工具。与 `advanced-tool-use` 中的工具扩展指南配对。
- **code-execution**（按需启用）。将工具呈现为可导入的代码，并在子进程中运行组合的 Python 代码。它执行模型编写的代码，因此默认情况下不启用。请在启用前将其包装在真正的隔离中；参见 `mcp-servers/code-execution/README.md` 和 `sandboxing-agentic-systems` 技能。
`think` 和 `tool-gateway` 已连接到插件的 `.mcp.json`。要启用 `code-execution`，请将客户端的 MCP 配置指向 `uv run .../mcp-servers/code-execution/server.py`。
## 命令、代理和钩子
- **`/research <question>`** 运行编排器-工作器流程：它分解问题，并行派遣 `research-worker` 子代理，并综合引用答案。与 `multi-agent-orchestration` 配对。
- **`/autonomous-loop`** 使用 `scripts/locks.py` 和 `scripts/autonomy_loop.sh` 为一个仓库中的不受监督的代理设置锁定文件协调。与 `parallel-autonomous-agents` 配对。
- **action-gating** 是一个 `PreToolUse` 钩子，按风险对 Bash 命令进行分级，并拒绝或询问危险的命令。它在您设置 `AGENT_STDLIB_GATING=warn` 或 `enforce` 之前保持关闭，并且它只会增加摩擦。参见 `hooks/README.md`。
- **injection-screening** 是一个 `PostToolUse` 钩子，用于在获取的工具输出中标记可能的提示注入标记，并在命中时警告代理或阻止它采取行动，直到您确认。关闭状态下，您需要设置 `AGENT_STDLIB_INJECTION=warn` 或 `enforce`。与 `defending-against-prompt-injection` 配对。参见 `hooks/README.md`。
## 超出 Claude Code
此软件包的大部分内容并非 Claude 特有。MCP 服务器使用开放的 MCP 协议，脚本是纯 Python 和 Bash，技能内容是与代理框架无关的过程知识。要在 OpenCode、Cursor、Cline 或任何模型上的自定义代理上使用它，请参见 [AGENTS.md](AGENTS.md)，它将每个组件映射到其可移植形式。
## 已在其他地方涵盖
以下主题已经有很好的涵盖，因此不包含在此软件包中。请改用以下内容：
- **选择代理模式**（提示链、路由、编排器-工作器）：`markpitt/claude-skills` → `agent-patterns`
- **编写代理技能**（SKILL.md 结构、渐进式披露、描述即触发）：Claude Code 内置的 `skill-creator`
- **上下文工程**（压缩、记笔记、即时检索）：`muratcankoylan/agent-skills-for-context-engineering`
- **设计代理或 MCP 工具**（合并、命名空间、token 高效响应）：同一软件包的 `tool-design`
- **长期构建环境**（初始化器 + 编码代理，git 跟踪状态）：`eddiearc/long-running-harness`
- **GAN 风格的生成器/评估器环境**：`affaan-m/everything-claude-code` → `gan-style-harness`
- **上下文检索 RAG**：市场上存在封装版本
## 来源
此软件包提炼了 Anthropic 工程博客、研究帖子和开发者文档的内容。它是一个独立项目，无任何 Anthropic 的背书，也不包含任何 Anthropic 代码。
## 贡献
参见 [CONTRIBUTING.md](CONTRIBUTING.md)。每个技能都独立于 `skills/<name>/SKILL.md`，并以它提炼的文章开头。
## 许可证
MIT。参见 [LICENSE](LICENSE)。
