用途：把面向人类的命令行工具改造为 AI 智能体可无人值守驱动的形态，将「对智能体别扭」转化为可量化评分与具体修复清单。
主要能力与方法：
- 审计：运行 --help、各子命令 --help、--version、正常与错误调用，记录退出码，并检索源码中的输出与退出码写法。8 个评估维度详见 references/ergonomics-rubric.md。
- 评分：0–100，8 维各约 12.5 分，按 0/部分/满分记录分数、证据与失败的文件行。
- 整改：按杠杆排序，先做机器输出模式与退出码纪律，再补 --help 完整性、去除交互提示，最后打磨。模式见 references/robot-mode-patterns.md。
- 验证：重跑探测，JSON 需通过 jq . 解析，NDJSON 每行须独立可解析，附前后对比记录。
关键约束：默认人类输出与机器输出分离，禁止让智能体解析彩色/表格文本；退出码须稳定、有文档、有意义（0 成功、1 通用失败、2 用法错误，另设 3 未找到、4 前置条件、5 部分成功）；--help 即智能体的 API 面，需完整可 grep；有副作用的命令必须提供 --dry-run 并由标志读取确认，绝不使用 TTY 交互提示。
用法示例（原样保留）：mytool --help；mytool --json；mytool watch --ndjson；NO_COLOR=1 mytool status；bash {baseDir}/scripts/validate.sh（0 = 完整，1 = 结构性问题）。
输出物：cli-ergonomics-scorecard.md（各维度分数、总分、前后探测记录）与 cli-ergonomics-remediation.md（按优先级排列，含表面、现状、目标、file:line、验证命令）。
适用场景：为智能体改造 CLI、排查智能体「不知道是否成功」「卡住」「选错 flag」「输出无法解析」等问题。 限制：该技能自身资料未提供支持的语言清单、安装方式、收费或许可信息；实际效果取决于被审计工具的可改动程度。