用途：为构建或改进命令行界面（CLI）提供架构与设计规范，使同一工具既能服务人类操作者（丰富 TUI），也能服务 AI 智能体（确定性、机器可读输出）。
主要能力与原则：
- 双模式体验：DX 面向人类，强调可发现性、TUI、语义配色与别名；AX 面向智能体，强调确定性、--json 等机器可读输出、无头认证、数据范围控制（limit/filter）与变更安全（--dry-run）。尊重 NO_COLOR 与 [APP]_NO_TUI 环境变量，自动回退到非交互、无样式模式。
- 无头认证：智能体无法完成浏览器 OAuth，需支持服务账号、环境变量 API Key、--token 等无头方式，或立即以机器可读错误提示人工先认证。
- 合理默认与过滤：不输出未分页或未过滤列表，默认限制（如 top 10），提供 --status、--mine、--limit 等过滤标志。
- 变更安全：创建、更新、删除类命令实现 --dry-run，便于智能体先验证参数与载荷。
- 上下文窗口保护：截断大文本、关键项置顶、默认掩码凭据，提供 --full 或 --verbose 显式请求完整数据。
- 可执行错误提示：向 stderr 注入可复制粘贴的修复命令（如 Hint: run 'app init'）。
- 委托状态管理：避免 CLI 内长时状态循环，使用无状态任务标识（--task <ID>、--ref <ID>）交由后端维护上下文。
- 外部化智能体说明：仓库根添加 AGENTS.md 或 GEMINI.md，并提供 agentskills.io 兼容的 skills/ 目录与 SKILL.md。
- API 发现与渐进便利：分析 Discovery Document 保证 API 覆盖，再叠加便利包装命令。
Go 实现：使用 Cobra 做命令路由、Viper 做配置。Cobra 中用 GroupID 分类命令，填充 Short、Long、Example 三要素，在 PersistentPreRun 中快速校验配置与连通性。Viper 遵循 XDG 规范（如 ~/.config/app/config.yaml），取值优先级为命令行标志 > 环境变量 > 配置文件 > 默认值，密钥优先用环境变量避免进入 shell 历史。
人类模式视觉设计：最大化数据墨水比，减少装饰边框；先做宽度填充再套用样式，避免 ANSI 转义码破坏表格对齐；使用语义色（Accent 蓝、Command 灰、Pass 绿、Warn 橙黄、Fail 红、Muted 深灰、ID 青绿），并在管道输出、--json 或 NO_COLOR 时优雅降级。
限制：资料未提供具体安装命令、版本、收费或平台信息；内容为设计指南，非可直接运行的工具。