内容
<p align="center">
<img src="./assets/agents.png" width="128" height="128" alt="Agent Enhancer Utilities broken-chain icon">
</p>
<h1 align="center">Agent Enhancer Utilities</h1>
<p align="center">
将 Agent Enhancer 添加到现有的代理工作流中，用于规划、检查点、去重、恢复和证据收集。
</p>
<p align="center">
<a href="https://liberated.site/status">服务状态</a> ·
<a href="https://liberated.site/effectiveness">效果</a> ·
<a href="https://liberated.site/tools">24 模块目录</a> ·
<a href="https://liberated.site/demo.mp4">视频演示</a> ·
<a href="https://glama.ai/mcp/connectors/site.liberated/agent-utility-lab">Glama 验证</a> ·
<a href="./LICENSE">MIT 许可证</a>
</p>
> `v1.6.0` 版本新增了可靠性 Sidecar 合同 v1、封闭的机器可读模式、本机和远程检查点适配器，以及预注册的配对基准。`0.6.9` 版本的后端已在现有的生产应用程序上运行，包含三个工具的核心和一个工具的紧凑型 Sidecar 配置文件、一个故障封闭的自主自动化标记和一个干净的外部使用截止点。所有公共模块仍然免费，真正的 USDC 结算功能仍然禁用。
Agent Enhancer 是一个**可靠性 Sidecar**，而不是现有代理或域工具的替代品。将它连接到现有的工作流中，仅在协调或故障处理将实质性地有所帮助时调用最小的相关实用程序。
## 技能
| 技能 | 使用它来 |
| --- | --- |
| `guard-external-plugin-workflows` | 为其他插件执行的重要或重复工作添加诚实的可靠性配置文件、验证和恢复 |
| `coordinate-parallel-agents` | 锁、去重、一次性棍棒、信号量、共享速率门、障碍和新鲜度租赁 |
| `test-http-failure-paths` | 有界状态/故障序列、Webhook 投递尝试、Retry-After 行为和合成固定装置 |
| `debug-x402-integrations` | 证据链接的 x402 错误诊断、需求漂移和促进者兼容性检查 |
| `review-mcp-tool-contracts` | 工具模式、注释、能力握手、诱导和边缘情况审查 |
| `guard-x402-retries` | 检测更改的付款要求并将一个重试身份绑定到一个标准报价 |
| `measure-webhook-delivery` | 收集关于有界 Webhook 投递尝试的仅一次、仅哈希证据 |
每个技能都是一个小的 Markdown 工作流。在安装前检查其 `SKILL.md`。
## Sidecar 模型
Agent Enhancer 不会自动拦截或扩展另一个插件。代理有意将其与域工具结合使用，当工作流重复、并行、调度、配额敏感、新鲜度敏感或容易受到有害重复的影响时。
Sidecar 协调工作流；域插件仍然执行和验证其自己的读取、写入、发送和分析。参见 [`guard-external-plugin-workflows`](./skills/guard-external-plugin-workflows/SKILL.md) 技能和供应商中立的 [可靠性 Sidecar 合同 v1](./docs/RELIABILITY_SIDECAR_CONTRACT_V1.md)，了解标准生命周期和保证标签。
## 安装
在安装前列出所有七个技能：
```sh
npx skills add artiehinz/Agent-Enhancer-Utilities --list
```
GitHub CLI 2.90 或更高版本可以预览或安装一个技能：
```sh
gh skill preview artiehinz/Agent-Enhancer-Utilities coordinate-parallel-agents
gh skill install artiehinz/Agent-Enhancer-Utilities coordinate-parallel-agents
```
同一个仓库包含版本化的包入口点：
| 主机 | 入口点 | 当前证据 |
| --- | --- | --- |
| ChatGPT 和 Codex | [`.codex-plugin/plugin.json`](./.codex-plugin/plugin.json) | 包验证器通过 |
| Claude Code | [`.claude-plugin/plugin.json`](./.claude-plugin/plugin.json) | Claude 验证器通过 |
| GitHub Copilot CLI | [`plugin.json`](./plugin.json) | 隔离安装发现所有七个技能 |
| Gemini CLI | [`gemini-extension.json`](./gemini-extension.json) | 扩展准备就绪；干净的主机安装仍然存在 |
| 通用 MCP 客户端 | [`.mcp.json`](./.mcp.json) | 实时流式 HTTP 合同通过 |
参见确切的、故意保守的 [兼容性证据](./docs/COMPATIBILITY.md)。准备好的清单并不是市场批准的声明。
代理也可以在不安装技能的情况下连接：
| 界面 | 端点 | 形状 |
| --- | --- | --- |
| Progressive MCP（推荐） | `https://liberated.site/mcp?profile=core` | 通过三个主机可见工具搜索、描述和调用所有 24 个模块 |
| Progressive MCP（完全控制平面） | `https://liberated.site/mcp` | 核心工具加上功能请求和目录管理工具 |
| Claude | `https://liberated.site/mcp/claude` | 后端 `0.6.0` 及更高版本上的 37 个直接操作特定工具 |
| ChatGPT | `https://liberated.site/mcp/chatgpt` | 相同的发布依赖直接接口 |
| HTTP/OpenAPI | `https://liberated.site/v1/openapi.json` | 后端 `0.6.0` 及更高版本上的 24 个生成的模块合同 |
所有公共模块目前都是免费的。真正的 USDC 结算功能仍然禁用。
## 可运行的示例
示例使用 Python 标准库、合成标识符和公共无身份验证 MCP 端点：
```sh
python -B examples/reliability-sidecar/run.py
python -B examples/multi-agent-checkpoint/run.py
python -B examples/sidecar-benchmark/test_benchmark.py
python -B examples/sidecar-agent-benchmark/test_benchmark.py
python -B examples/on-demand-sidecar/run.py both
goose recipe validate examples/goose/agent-enhancer-reliability-sidecar.yaml
```
- [通用 Sidecar 示例](./examples/reliability-sidecar/) 将实时守护计划器与模拟域代理结合，证明一个可搜索的记录在重放中幸存。
- [多代理检查点示例](./examples/multi-agent-checkpoint/) 使两个工作者竞争，承认一个所有者，记录一个合成操作，并保持 `external_proof: false`。
- [Goose 配方](./examples/goose/) 将无身份验证 Sidecar 添加到 Goose 任务中，停止模糊重试，并在记录调用者验证之前需要目标读取。
- [配对 Sidecar 基准测试](./examples/sidecar-benchmark/) 执行五个确定性有/无场景，在每个场景中发布 20 对，并将模型令牌字段暴露为不可用，而不是推断节省。
- [按需 Sidecar 原型](./examples/on-demand-sidecar/) 不为本地分类的低风险合同进行远程调用，而是为风险承担工作调用现有的托管计划器。本地/托管计划漂移失败关闭；测量的代理验证仍在进行中。
远程 MCP 示例通过渐进式外壳搜索、描述和调用。按需原型仅在本地选择后使用公共生成的 HTTP 合同。没有示例复制私有后端代码或模式。
## 目录列表
- [官方 MCP 注册表](https://registry.modelcontextprotocol.io/v0.1/servers?search=site.liberated%2Fagent-utility-lab) — `0.6.4` 最新
- [Glama](https://glama.ai/mcp/connectors/site.liberated/agent-utility-lab) — 所有权验证
- [Smithery](https://smithery.ai/servers/artemhinz2/Agent-Enhancer-Utilities)
这些列表指向实时服务。实现并未在此技能仓库中发布。
## 信任和效果
服务发布：
- 当前的每个模块自测结果和数据集新鲜度，位于 [`/status`](https://liberated.site/status)；
- 隐私安全方法和使用证据，位于 [`/effectiveness`](https://liberated.site/effectiveness)；
- 可重现的运行时 Sidecar 基准测试证据，位于 [`examples/sidecar-benchmark/results/latest.json`](./examples/sidecar-benchmark/results/latest.json)；
- 模式、限制、副作用、保留和类型化错误，位于 [目录](https://liberated.site/v1/catalog) 中；
- 隐私、允许使用、安全、支持和定价政策，位于 [服务首页](https://liberated.site)。
技能中不包含隐藏的安装遥测数据。不要将凭证、钱包私钥、个人数据、客户记录或对话历史发送到服务。
## 仓库范围
此公共仓库包含可重用的技能、其主机元数据和项目级验证/文档。托管服务实现单独运行。技能必须使用渐进式发现，不得复制私有模式、凭证或后端源代码。
参见 [架构](./docs/ARCHITECTURE.md)、 [CONTRIBUTING.md](./CONTRIBUTING.md)、 [SECURITY.md](./SECURITY.md) 和 [效果方法论](./docs/EFFECTIVENESS.md)。产品方向和计划的跨插件可靠性工作在 [docs/ROADMAP.md](./docs/ROADMAP.md) 中描述。提议的只读计划合同在 [docs/WORKFLOW_GUARD_PLANNER.md](./docs/WORKFLOW_GUARD_PLANNER.md) 中， 有界检查点合同在 [docs/OPAQUE_WORKFLOW_CHECKPOINTS.md](./docs/OPAQUE_WORKFLOW_CHECKPOINTS.md) 中， 当前的实时基本证据在 [docs/SIDECAR_RECIPE_TESTS.md](./docs/SIDECAR_RECIPE_TESTS.md) 中记录。确切的开源贡献序列和模块映射在 [docs/OPEN_SOURCE_INTEGRATION_PLAN.md](./docs/OPEN_SOURCE_INTEGRATION_PLAN.md) 中。
## 许可证
MIT
