kunchenguid/axi

AXI – Agent eXperience Interface

它是什么 – AXI是一个设计框架和一组具体的命令行工具，专为AI代理而非人类构建。它定义了十条“代理人体工程学”原则（令牌高效输出、最小化模式、显式空状态等），并提供了一系列遵循这些规则的AXI包装CLI（GitHub、Chrome DevTools、AWS、Docker、Notion等）。

为什么重要 – 大型语言模型代理在调用外部服务时有严格的令牌预算。传统CLI和工具协议（例如MCP）冗长，需要交互式提示，并在不必要的JSON字段上浪费令牌。AXI的原则使数据保持小巧、确定且易于LLM解析，从而降低成本、延迟并提高可靠性。

关键组件

• 10条设计原则 – 令牌高效的TOON格式、微小的默认模式、显式空结果、结构化错误、环境上下文、内容优先默认值等。
• AXI目录 – 精选的现成AXI工具列表。官方示例包括：
  • gh-axi – GitHub CLI的令牌高效包装器。
  • chrome-devtools-axi – 通过Chrome DevTools MCP进行浏览器自动化。
  • lavish-axi、quota-axi以及许多社区贡献的AXI，用于Android、npm、SQLite、Slack、AWS、Docker等。
• 基准测试 – README显示了实证结果（Claude Sonnet 4.6），其中AXI包装工具在成功率、成本、轮次和运行时间方面优于标准CLI或基于MCP的方法。

典型工作流程

1. 安装AXI工具（例如 npm install -g gh-axi）。
2. 在LLM驱动的脚本或提示中，像任何shell命令一样调用该工具。
3. 工具返回TOON（一种紧凑、节省令牌的格式），并带有可选聚合和下一步建议。
4. 代理可以解析输出，决定下一步操作，或将数据呈现给用户。

开始使用

# 安装两个旗舰AXI
npm install -g gh-axi
npm install -g chrome-devtools-axi

# 从LLM提示中使用的示例
使用 `gh-axi issue list --repo owner/repo --state open` 获取开放问题。
使用 `chrome-devtools-axi navigate https://example.com` 驱动无头浏览器。

将工具添加到代理的知识库中（例如在 CLAUDE.md 或 AGENTS.md 中），以便模型知道它们的存在。

谁应该使用

• 构建需要与SaaS API、云服务或本地工具交互的自主代理的开发人员。
• 希望减少令牌消耗并提高工具调用可靠性的提示工程师。
• 任何对标准化、低开销的LLM执行现实世界操作方式感兴趣的人。

了解更多

• 项目网站：https://axi.md
• Discord社区用于讨论和支持。
• 仓库中的 principles.yaml 和 catalog.yaml 文件详细说明了完整规范和不断增长的AXI列表。

---

以上所有信息均直接取自仓库的README；未推断任何额外功能。