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

agent-dx-cli-scale

智能体与模型

查看项目

更新于 10-15 18:31

技能介绍

Agent DX CLI Scale 是一个评分量表，用于评估一个 CLI 在多大程度上是为 AI 智能体而设计的。它依据“为 AI 智能体重写你的 CLI”原则，对任意 CLI 进行逐轴打分。

用途

该技能的核心用途是：对任意 CLI 进行智能体友好度评估。使用者按 7 个维度逐项打分，每轴 0–3 分，最后求和得到 0–21 分的总分，并据此判断该 CLI 处于哪个等级。

设计理念

资料中给出了两条对照原则：人类 DX 优化的是可发现性和容错性；智能体 DX 优化的是可预测性和纵深防御。

评分维度

  1. 机器可读输出：智能体能否无需启发式规则就解析 CLI 输出。0 分表示仅人类可读输出（表格、颜色代码、散文），无结构化格式；1 分表示存在 --output json 或等价选项，但不完整或跨命令不一致；2 分表示所有命令输出一致的 JSON，错误也返回结构化 JSON；3 分表示分页结果使用 NDJSON 流式输出，且在非 TTY（管道）上下文中结构化输出为默认。

  2. 原始载荷输入：智能体能否发送完整 API 载荷，而无需通过定制标志做转换。0 分表示只有定制标志，无法传入结构化输入；1 分表示部分命令接受 --json 或 stdin JSON，但多数仍需要标志；2 分表示所有变更命令都接受直接映射到底层 API 模式的原始 JSON 载荷；3 分表示原始载荷与便捷标志同为一等公民，智能体可将 API 模式作为文档使用且零转换损失。

  3. 模式自省：智能体能否在运行时发现 CLI 接受什么，而无需预先塞入文档。0 分表示只有 --help 文本，无机器可读模式；1 分表示部分界面有 --help --json 或 describe 命令，但不完整；2 分表示所有命令都有完整模式自省——参数、类型、必填字段——以 JSON 形式提供；3 分表示实时、运行时解析的模式（例如来自发现文档），始终反映当前 API 版本，包含作用域、枚举和嵌套类型。

  4. 上下文窗口纪律：CLI 是否帮助智能体控制响应大小以保护其上下文窗口。0 分表示返回完整 API 响应，无法限制字段或分页；1 分表示部分命令支持 --fields 或字段掩码；2 分表示所有读取命令都有字段掩码，支持 --page-all 或等价分页；3 分表示流式分页（每页 NDJSON），在上下文/技能文件中有关于字段掩码使用的明确指引，CLI 主动保护智能体免于 token 浪费。

  5. 输入加固：CLI 是否防御智能体特有的失败方式（幻觉，而非拼写错误）。0 分表示除基本类型检查外无输入验证；1 分表示验证部分输入，但不覆盖智能体特有的幻觉模式（路径穿越、内嵌查询参数、双重编码）；2 分表示在资源 ID 中拒绝控制字符、路径穿越（../）、百分号编码段（%2e）和内嵌查询参数（?、#）；3 分表示全面加固：以上全部，外加输出路径沙箱限制到 CWD、HTTP 层百分号编码，以及明确的安全姿态——“智能体不是受信任的操作者”。

  6. 安全护栏：智能体能否在行动前验证，响应是否针对提示注入做了净化。0 分表示无 dry-run 模式，无响应净化；1 分表示部分变更命令有 --dry-run；2 分表示所有变更命令都有 --dry-run，智能体可无副作用地验证请求；3 分表示 dry-run 加响应净化（例如通过 Model Armor）以防御嵌入 API 数据中的提示注入，完整的请求→响应循环都受到防护。

  7. 智能体知识打包：CLI 是否以智能体在对话开始时就能消费的格式提供知识。0 分表示只有 --help 和文档站点，无智能体专用上下文文件；1 分表示有 CONTEXT.md 或 AGENTS.md 提供基本使用指引；2 分表示有结构化技能文件（YAML frontmatter + Markdown），覆盖按命令或按 API 界面的工作流和不变量；3 分表示全面的技能库，编码智能体专用护栏（“始终使用 --dry-run”“始终使用 --fields”），技能有版本、可发现，并遵循 OpenClaw 等标准。

总分解读

0–5 分：仅面向人类。为人类构建，智能体在解析时会遇到困难、会幻觉输入，且缺乏安全护栏。

6–10 分：智能体可容忍。智能体可以使用，但会浪费 token、犯可避免的错误，并需要大量提示工程来补偿。

11–15 分：智能体就绪。扎实的智能体支持，有结构化 I/O、输入验证和部分自省，仍有一些缺口。

16–21 分：智能体优先。专为智能体打造，具备完整模式自省、全面输入加固、安全护栏和打包的智能体知识。

加分项：多界面就绪

不计分，但记录 CLI 是否从同一二进制暴露多个智能体界面：MCP（stdio JSON-RPC）——类型化工具调用，无需 shell 转义；扩展/插件安装——智能体将 CLI 视为原生能力；无头认证——通过环境变量提供 token/凭据，无需浏览器重定向。

适用场景

该技能适用于 CLI 作者、平台工程师和智能体工具链开发者，用于诊断现有 CLI 对 AI 智能体的友好程度，并识别改进方向。

限制

资料未提供该技能的具体安装命令、运行方式、依赖要求、收费模式或平台支持信息，这些内容暂未提供。