v1.1.0 — CLI 设计与评审技能

agent-native-cli

为 AI 智能体设计真正可用的 CLI。稳定的 stdout 契约、确定性退出码、dry-run、Schema 自省、委托式认证 — 作为一项评审与重构技能。

git clone https://github.com/Agents365-ai/agent-native-cli.git ~/.claude/skills/agent-native-cli
GitHub SkillsMP ClawHub

为什么需要这项技能

让任何 CLI 同时服务人类、智能体和编排系统。

📦

稳定的 stdout 信封

每个命令都返回相同结构 — ok、data、error、meta。智能体一次解析，永远不靠猜。

🚦

确定性退出码

每类故障对应一个文档化的退出码。不再把所有非零返回都当成一回事。

🔍

Schema 自省与 dry-run

完整的自描述层。无需执行即可预览请求形态，智能体可以即时学习工具用法。

🛡️

安全分级

开放 / 警示 / 隐藏三级可见性。让危险操作不会出现在智能体默认接触的命令表面。

🔑

委托式认证

人类管理认证生命周期，智能体只使用 token。在环境变量与 CLI 参数之间建立定向信任模型。

📊

14 项评分标准

按 14 项标准（每项 0–2 分）为任意 CLI 评分，并输出包含具体接口示例的 P0/P1/P2 优先级重构计划。

Stdout 契约

同一个命令，同样的结果 — 一边靠猜，另一边可直接解析。

原生 CLI 
$ weatherctl today --city Paris
Fetching weather for Paris...
Temp: 14°C (feels like 12°C)
Oops: network flaky, retrying (1/3)
Done.
$ echo $?
0
智能体原生 CLI 
$ weatherctl today --city Paris --json
{
  "ok": true,
  "data": {
    "city": "Paris",
    "temp_c": 14,
    "feels_like_c": 12
  },
  "error": null,
  "meta": { "retries": 1, "elapsed_ms": 412 }
}
$ echo $?
0

stderr 留给人类，stdout 留给机器；退出码映射到故障类型，而不仅仅是成功/失败。

有 skill 与无 skill 的对比

直接让模型来做，和使用本 skill 的差别。

能力原生智能体本 Skill
评估 CLI 是否具备智能体原生特性✗✓ 基于 7 项原则的结构化诊断
设计 stdout JSON 契约不稳定✓ ok / data / error 稳定信封
定义退出码语义临时性✓ 文档化、按故障类型确定
分层 --help 与 Schema 自省✗✓ 完整自描述模式
设计 dry-run 预览少见✓ 不执行即可预览请求形态
定义命令安全分级✗✓ 开放 / 警示 / 隐藏
设计委托式认证✗✓ 人类管理生命周期，智能体仅使用 token
区分环境变量与 CLI 参数的信任级别✗✓ 定向信任模型
生成优先级重构计划少见✓ P0 / P1 / P2，含示例
按 14 项标准对 CLI 评分✗✓ 每项 0–2 分，含最终判定

安装

选择你所在的平台。或者直接让任意编码 Agent 帮你克隆仓库。

# 全局安装（在所有项目中可用）
git clone https://github.com/Agents365-ai/agent-native-cli.git ~/.claude/skills/agent-native-cli

# 项目级安装
git clone https://github.com/Agents365-ai/agent-native-cli.git .claude/skills/agent-native-cli
# 通过 ClawHub 安装
clawhub install agent-native-cli

# 手动安装
git clone https://github.com/Agents365-ai/agent-native-cli.git ~/.openclaw/skills/agent-native-cli

# 项目级安装
git clone https://github.com/Agents365-ai/agent-native-cli.git skills/agent-native-cli
# 安装到 Hermes engineering skills 目录
git clone https://github.com/Agents365-ai/agent-native-cli.git ~/.hermes/skills/engineering/agent-native-cli
# pi-mono 支持从任何注册过的目录加载 skills
git clone https://github.com/Agents365-ai/agent-native-cli.git ~/skills/agent-native-cli
# 用户级安装
git clone https://github.com/Agents365-ai/agent-native-cli.git ~/.agents/skills/agent-native-cli

# 项目级安装
git clone https://github.com/Agents365-ai/agent-native-cli.git .agents/skills/agent-native-cli