用途：把 CLI 视为工具与智能体之间的契约，契约涵盖命令名、--help、标志、输出结构、退出码、stderr 与预览。适用于新建智能体可发现并调用的 CLI，或重构提示式、含糊命令、解析不友好的输出与虚假成功码，以及增加或审查 --json、--dry-run、--yes、幂等与惰性认证。
工作流：一是发现真实契约，每个服务一个 CLI（共用厂商认证者除外），编码前检查真实非健康读端点，核实认证头与响应结构，捕获命令树与失败情形，不凭 API 文档臆造标志；本地包装与文件管道用 Bash，HTTP、JSON、认证状态或三级命令树用 Python。二是构建可预测界面，统一动词/资源约定，命令非交互、标志驱动、拒绝未知标志，子命令帮助含具体示例；正常输出可读，--json 使用稳定精简模式、类型归一、顺序确定且 stdout 无其他内容；诊断走 stderr 并返回真实非零退出码；任何状态变更先实现 --dry-run，破坏性操作需显式 --yes/--force，创建更新删除保证重跑安全，认证惰性，--help 与安全 dry-run 无需凭据。三是验证契约，运行语法检查和各命令 --help，解析每个 --json 响应，检查缺参和未知标志，确认错误在 stderr，无凭据试干跑，证明第二次相同运行无副作用；对真实服务测试认证读取并试干跑每个变更。四是包装与维护，入口技能保持简洁，条件细节放引用，包装说明用途、设置、常用命令、输出含义与陷阱，不重复所有标志，实际使用后记录失败并按改进周期优先修复。核心契约：--help 可发现且含示例；--json 可单独解析，错误有稳定机器码；--dry-run 描述确切变更且不写入、不做前置查询；变更须显式授权、幂等并报告有意义状态；退出状态区分成功、用法失败与运行时失败。
限制：不用于一次性交互式人工命令、GUI/TUI 或 Web UI 设计、对话式智能体工具或 MCP 服务器；工具边界选择参考 MCP 与 CLI 决策指南，通用 API 契约设计归 api-design-and-evolution。具体参考资料与示例暂未提供完整内容。