面向代理的命令行接口规范 v0.1

在构建或修改命令行工具时，请遵循这些规则以确保它们安全并且

用于构建 AI 原生命令行工具的全面设计规范。它定义了

三个认证级别（适合代理、准备代理、原生代理）的98条规则

具有优先级要求（P0/P1/P2）。规范涵盖结构化 JSON 输出，

错误处理、输入合同、安全防护、退出代码、自我描述，

并通过内置的问题系统形成反馈循环。

默认是代理模式（JSON）。显式标志用于切换：

$ mycli list              # default = JSON output (agent mode)
$ mycli list --human      # human-friendly: colored, tables, formatted
$ mycli list --agent      # explicit agent mode (override config if needed)

每个 CLI 工具在其项目根目录下必须有一个 agent/ 目录。这是

AI 代理工具的身份和行为契约。

agent/
  brief.md          # One paragraph: who am I, what can I do
  rules/            # Behavior constraints (auto-registered)
    trigger.md      # When should an agent use this tool
    workflow.md     # Step-by-step usage flow
    writeback.md    # How to write feedback back
  skills/           # Extended capabilities (auto-registered)
    getting-started.md

每个级别包括前一个级别的所有规则。

优先级标签 [P0]=没有它代理程序就会崩溃，[P1]=代理程序可以工作但表现较差，[P2]=有则更好。

第1级：对代理友好（核心——20条规则）

目标：CLI 是一个稳定的、可调用的 API。代理可以调用、解析并处理错误。

输出 -- 默认是 JSON，稳定的架构

错误 -- 结构化输出，发送到标准错误，绝不以交互方式

等级 2：代理准备就绪（推荐 -- 59 条规则）

目标：命令行界面是自描述的、命名合理的，并且适合管道操作。代理能够发现功能并链式执行命令，无需反复试验。

自我描述 -- 代理发现命令行界面能做什么

--agent JSON output (default) Explicit override

--human Human-friendly output Colors, tables, formatted

--brief One-paragraph identity For sync into agent config

--help Full self-description JSON Brief + commands + rules + skills + issue

--yes Confirm destructive ops Required for delete/destroy

--fields Filter output fields Save tokens

等级 3：代理-本地（生态系统——19 条规则）

目标：CLI具有身份、行为契约、技能系统和反馈循环。代理可以学习工具、扩展其使用，并报告问题——完整的闭环协作。

代理目录 -- 工具身份和行为契约

响应结构 -- 每次调用时的内联上下文

$ mycli list
{"result": [{"id": 1, "title": "Buy milk", "status": "todo"}], "rules": [...], "skills": [...], "issue": "..."}

0   success         10  auth failed       20  resource not found
1   general error   11  permission denied 30  conflict/precondition
2   param/usage error

Ai Native Cli 实用指南

Design spec with 98 rules for building CLI tools that AI agents can safely use. Covers structured JSON output, error handling, input contracts, safety guardrails, exit codes, and agent self-description.

开发工具

编程语言

人工智能

AI原生CLI设计规范提供了98条可自动检查的规则，定义三级认证体系（代理友好、代理就绪、代理原生）。核心要求包括默认JSON输出、结构化错误处理、非零退出码、agent/目录自描述及内置反馈机制，确保CLI工具能被AI代理安全可靠地调用和解析。

命令行工具

身份验证

Agent

JSON

2026上云采购 | AI焕新·智启新局

cclid

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

Ai Native Cli 实用指南

Ai Native Cli 实用指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐