用途：面向使用 Go 构建命令行应用的开发者，提供 Cobra 与 Viper 的惯用模式与最佳实践，适用于新建 CLI、为现有 Cobra 应用添加命令与标志、集成 Viper 管理配置文件/环境变量/标志，以及重构和测试 CLI 代码。
主要能力：
- 命令优先架构：二进制作为命令路由器，Cobra 只负责标志、参数与路由，业务逻辑不感知 CLI 层。
- 工厂模式：用 NewRootCmd() 等构造函数构建命令树，避免包级全局变量，便于测试与作为库复用；main.go 仅调用 cmd.Execute()。
- 包组织：cmd/ 放路由层，engine/ 等顶层包放领域逻辑，核心逻辑不导入 cobra 或 viper。
- Cobra 实践：用 RunE 返回错误、SilenceUsage/SilenceErrors、context 传递与信号处理、Args 校验位置参数、PersistentPreRunE 共享初始化、标志分组与 Shell 补全、通过 cmd.OutOrStdout() 输出。
- Viper 配置：优先使用 viper.New() 实例而非全局单例；Unmarshal 到强类型结构体；绑定层级为 Set > 标志 > 环境变量 > 配置文件 > 默认值；SetEnvPrefix/AutomaticEnv/SetEnvKeyReplacer 映射环境变量；YAML 配置示例。
- 版本处理：使用 Cobra 内置 Version 与 -ldflags 注入版本、提交与构建时间。
- 测试：通过工厂在内存中构建命令树，SetArgs/SetOut/SetErr 驱动完整调用路径，避免 os/exec 与全局状态泄漏。
使用方式：资料给出目录结构、main.go 与 root.go 工厂示例、initConfig 配置加载、go build -ldflags 命令及补全安装命令（如 myapp completion bash > /etc/bash_completion.d/myapp）。
限制与注意：AutomaticEnv 不会注册键，仅环境变量提供的值在 Unmarshal 时不可见，需 SetDefault 或 BindEnv；子命令的 PersistentPreRunE 会覆盖父命令，需显式调用或启用 cobra.EnableTraverseRunHooks（Cobra 1.8+）；标志需显式 BindPFlags；嵌套键需 SetEnvKeyReplacer。具体版本兼容与更多细节以官方资料为准。