Go Cobra CLI 构建套件

解决什么问题

团队里的运维脚本大多散落在 Git 仓库的角落，能跑但没人记得住参数，换台机器要重新写一遍补全脚本。

如何工作

这个技能基于 Cobra 的设计，提供一套五步构建法，帮你把散落的脚本组织成可维护的命令行应用。核心能力包括子命令树设计、--flag 作用域划分、参数校验和 Shell 补全。

五步构建法

1. 初始化根命令：用 rootCmd 定义名称、短描述、长描述和版本，Execute() 作为入口。
2. 拆分子命令：每个能力对应一个 cmd，通过 rootCmd.AddCommand 挂载，形成清晰的命令树。
3. 声明 flag：局部 flag 用 Flags().StringVar，全局 flag 挂 root 并通过 PersistentFlags 暴露。
4. 校验与运行：在 PreRun 做参数校验，RunE 返回 error 由框架统一处理退出码。
5. 生成补全：执行 cobra completion 产出 bash、zsh、fish、powershell 脚本，提交到仓库。

适用边界

这个技能是开发方法论，AI 输出以 Cobra 官方文档为准。生产环境中需要补充单元测试与版本管理，确保稳定性。