用途：Agentic CLI Design 是一套设计理念与评审框架，把 CLI 视为 LLM/智能体可安全、可靠、可重复调用的协议/API，而非仅供人类在终端操作的工具。目标是让智能体不困惑、不破坏、不卡住、可重复、可自愈地执行命令。
主要能力（7 项原则）：P1 机器可读，提供 --json/--output json|yaml|text，stdout 输出结果、stderr 输出日志，错误也结构化，并用 schemaVersion 管理变更；P2 默认非交互，提供 --yes/--force/--no-confirm/--non-interactive，能在无 TTY 环境完成；P3 幂等可重放，写操作支持 dedupe-key/client-request-id，--if-exists skip|update|error，读取使用 --limit/--cursor/--all 分页；P4 默认安全，破坏性操作需显式确认，支持 --dry-run/--confirm <id>；P5 可观测可调试，--verbose/--debug/--log-format json、--trace-id，退出码分类（0 成功、2 参数错误、3 认证权限、4 可重试）；P6 上下文高效，--fields/--select、--output ndjson 流式、默认摘要；P7 可自省，commands --json、schema --command --output json-schema、--help --json，以及 install-skills（从 <project dir>/skills 安装自身技能，默认 ./.agents/skills，--global 为 ~/.agents/skills，--claude 为 ./.claude/skills）。
使用方式：新 CLI 设计时对照 7 原则与 references/scorecard.md 清单，用 references/templates.md 实现，避开 references/anti-patterns.md；评审现有 CLI 时逐项打分（每项 0/1/2 分，满分 14）；为 CLI 创建 Agent Skill 时加入任务配方、护栏、输入输出类型、错误恢复与推荐默认值。OAuth/无头认证优先 Device Authorization Grant（RFC 8628），提供 auth status --json 与 auth export/import，非交互模式返回错误与后续步骤。
适用场景：为智能体/自动化设计新 CLI、改造现有 CLI、编写 Agent Skill、排查智能体调用失败、评审生产就绪度、在智能体工作流中选型。
限制：对一次性个人脚本、纯人类交互 CLI、原型或天然交互式工具（编辑器、REPL）可能过重。具体安装命令、依赖与版本信息暂未提供。