【研发类-AI和ML开发Skills】ai-native-cli 技能

包含98条规则的设计规范用于构建AI代理可以安全使用的CLI工具。涵盖结构化JSON输出、错误处理、输入契约、安全护栏、退出代码和代理自我描述。技能概述ai-native-cli 技能用于构建AI原生CLI工具的综合设计规范。它定义了跨三个认证级别Agent-Friendly、Agent-Ready、Agent-Native的98条规则具有优先级要求P0/P1/P2。该规范涵盖结构化JSON输出、错误处理、输入契约、安全护栏、退出代码、自我描述以及通过内置问题系统的反馈循环。下载地址agentic-awesome-skills/skills/ai-native-cli at main · sickn33/agentic-awesome-skills · GitHub触发条件构建AI代理将调用的新CLI工具改造现有CLI使其对代理友好为自动化管道设计命令行界面审计CLI工具对代理安全标准的合规性核心理念代理优先默认输出是JSON人类友好通过--human选择加入代理不受信任在与公共API相同的级别验证所有输入失败关闭当验证逻辑本身出错时默认拒绝可验证每条规则的编写都可以自动检查层模型此规范使用两个正交轴层回答推出范围core、recommended、ecosystem优先级回答严重性P0、P1、P2认证级别级别要求描述Agent-Friendly所有core规则通过CLI是稳定的、可调用的APIAgent-Ready所有core recommended规则通过CLI是自我描述的、命名良好的、管道友好的Agent-Native所有层通过完整的代理原生集成工作原理步骤1输出模式默认是代理模式JSON。显式标志切换$ mycli list # 默认 JSON输出代理模式 $ mycli list --human # 人类友好彩色、表格、格式化 $ mycli list --agent # 显式代理模式如果需要覆盖配置步骤2agent/目录约定每个CLI工具必须在其项目根目录下有一个agent/目录。这是工具的身份和行为契约。agent/ brief.md # 一段话我是谁我能做什么 rules/ # 行为约束自动注册 trigger.md # 代理何时应使用此工具 workflow.md # 逐步使用流程 writeback.md # 如何写回反馈 skills/ # 扩展能力自动注册 getting-started.md步骤3四个级别的自我描述--brief名片注入代理配置每个命令响应始终在线上下文数据规则技能问题--help完整自我描述简介命令规则技能问题skills name按需深入特定技能Level 1Agent-Friendlycore - 20条规则目标CLI是稳定的、可调用的API。代理可以调用、解析和处理错误。输出[P0] O1默认输出是JSON。无需--json标志[P0] O2JSON必须通过jq .验证[P0] O3JSON模式在相同版本内不得更改错误[P0] E1错误→stderr的{error:true, code:..., message:..., suggestion:...}[P0] E4错误具有机器可读的code例如MISSING_REQUIRED[P0] E5错误具有人类可读的message[P0] E7出错时永不进入交互模式——立即退出[P0] E8错误代码是API契约——版本间不得重命名退出代码[P0] X3参数/用法错误必须退出2[P0] X9失败必须退出非零——永不退出0然后在stdout中报告错误可组合性[P0] C1stdout仅用于数据[P0] C2日志、进度、警告仅进入stderr输入[P1] I4缺少必需参数→结构化错误永不交互式提示[P1] I5类型不匹配→退出2 结构化错误安全[P1] S1破坏性操作需要--yes确认[P1] S4拒绝../../路径遍历、控制字符护栏[P1] G1未知标志被拒绝并退出2[P1] G2检测参数中的API密钥/令牌模式拒绝执行[P1] G3拒绝敏感文件路径*.env、*.key、*.pem[P1] G8拒绝参数中的shell元字符; | $()最佳实践默认使用JSON输出人类友好格式通过标志选择所有错误输出到stderr使用结构化JSON格式实现全面的输入验证和安全护栏使用一致的退出代码约定提供agent/目录进行自我描述支持四个级别的自我描述技能元数据风险等级safe来源https://github.com/ChaosRealmsAI/agent-cli-spec