SuperAPI AI 工具集

axi

通用与其它

查看项目

更新于 10-16 07:14

技能介绍

AXI(Agent eXperience Interface)是一套规范与标准,用于构建供自主智能体通过 shell 执行来调用的 CLI 工具,聚焦 token 效率与可被智能体可靠解析的行为约定。

主要能力与约定:

  1. 输出格式:stdout 使用 TOON(Token-Oriented Object Notation),据资料比等价 JSON 节省约 40% token,仍可被智能体阅读;内部逻辑保持 JSON,在输出边界转换为 TOON。
  2. 默认 schema 精简:字段越少越省 token,列表默认 3-4 个字段,默认 limit 覆盖常见情况,长文本放详情视图,提供 --fields 让智能体显式请求更多字段。
  3. 内容截断:详情中的大字段默认截断,同时给出总长度和 --full 等完整获取方式,截断长度建议 500-1500 字符。
  4. 预计算聚合:列表输出包含 total 总量,内联轻量派生状态(如 checks: 3/3 passed、comments: 7),仅包含后端能廉价提供的摘要。
  5. 明确空状态:明确说明“0 条”,附带上下文,让智能体知道命令成功且结果为空就是答案。
  6. 结构化错误与退出码:幂等变更已达成时不报错并返回 0;错误以结构化格式输出到 stdout 并给出可执行建议;不使用交互式提示;未识别 flag 必须报错而非静默忽略;帮助错误自我纠正,列出有效 flag。输出通道约定:stdout 为结构化数据/错误/建议,stderr 为调试与进度,退出码 0 成功、1 错误、2 用法错误。
  7. 会话集成:通过 setup 命令显式注册会话钩子或插件,在会话开始时注入紧凑上下文。默认支持 Claude Code、Codex、OpenCode;钩子命令需 PATH 可移植、幂等、按目录限定、控制 token 预算,并可用会话结束钩子捕获状态。
  8. 内容优先:无参数运行时展示最相关的实时内容,而非使用手册。
  9. 上下文披露:包含逻辑上合理的下一步建议,命令可执行、动态值用占位符、自洽时可省略。
  10. 一致的帮助获取:顶层视图先给出可执行文件绝对路径与一句话描述;各子命令 --help 保持简洁完整;-v、-V、--version 必须打印纯版本并以 0 退出,可通过 leaf 模块与动态 import 实现快速路径。

使用方式:资料提及 npx skills add <owner>/<repo> --skill <name> 作为可安装 Agent Skill 的补充集成路径;官方未提供完整安装命令细节。

适用场景:构建、修改或审查供智能体调用的 CLI 工具时参考。

限制:具体支持范围、收费、平台与版本等信息暂未提供。