CLI 工具开发专家

命令行工具开发中的重复劳动

写 CLI 的人大概都经历过：flag 解析逻辑散落各处、帮助文本和实际行为不一致、退出码随手填、换个 shell 补全就失效。真正花时间的往往不是"跑起来"，而是参数校验、错误提示、进度反馈这些边角料，而且每次都在重新搭脚手架。

这个技能做什么

它把 CLI 实现拆成五个可验证的步骤：

• 步骤 1：确认命令结构 — 先摆清子命令与全局/局部 flag
• 步骤 2：设计 — 参数校验规则、帮助文本、退出码约定
• 步骤 3：实现 — 产出解析、交互与输出代码
• 步骤 4：自检 — 核对帮助、错误码、补全是否一致
• 步骤 5：输出工件 — 返回结构化的 CliToolSpec

核心能力覆盖 flag/subcommand 解析、进度条与 spinner、交互式提示，以及生成 bash/zsh/fish 补全脚本。输入可以是自然语言描述的需求，也可以是已有的 CliToolSpec 做二次优化。输出分两部分：完整的结构化工件，以及一段自然语言摘要，附带质量自检结论和最该改的 2-3 点。工件下游交给 code-documenter 生成文档。

适用边界

• 只面向命令行工具，GUI 不在范围内
• 不处理 TUI 全屏界面框架的细节，如全屏交互式选择器
• 输出是规范与代码骨架，具体框架选型仍需按项目技术栈决定