Go CLI · 命令结构、配置层次与可测试输出
@public/golang-cli
查看空间 →指导 Go 命令行工具的创建、扩展与审查,覆盖子命令、参数、配置来源、版本信息、退出码、输出流、信号取消和命令测试。以 Cobra、Viper 为常见方案,简单工具可使用标准库,按现有命令契约选择结构。采用 MIT 许可证。
能力与使用条件
适用场景
- 为 Go 工具设计子命令与参数校验
- 梳理 flags、环境变量和配置文件的优先级
- 检查可脚本化输出、退出行为与命令测试
输入要求
- 现有 Go CLI 源码或新命令需求
- 参数、配置来源、输出格式、兼容要求和使用场景
输出结果
- 命令与配置组织方案
- 适用实现、参数校验及输出或退出行为测试建议
前置条件
- 具备 Go 工具链,按项目需要准备 Cobra、Viper 等依赖并读取当前官方 API
- 先检查命令树和配置初始化,在项目容器中运行 CLI 与测试
不适用场景与限制
- 示例配置优先级不覆盖 Viper 的所有来源或显式覆盖,实际行为取决于绑定、Set 与所选版本
- 示例根命令和配置使用全局状态,测试应隔离状态并核对 hooks 的继承与覆盖,不把示例视为已通过目标项目测试
- 输出与退出码约定需与现有脚本兼容;本技能用于开发 CLI,不自动执行命令中的外部写入或发布
- 下载链接为固定提交的完整仓库快照,使用其中 skills/golang-cli 目录。配图是说明性示例。
说明性示例
- 为现有 Go CLI 新增一个只读 list 子命令,先核对命令树和配置来源,支持可解析输出,并在容器中测试参数错误与 stdout/stderr 行为。
资料依据
- https://github.com/samber/cc-skills-golang/blob/d68d80aec298e1b74b37c2a472c002b5217248b3/skills/golang-cli/SKILL.md
- https://github.com/samber/cc-skills-golang/blob/d68d80aec298e1b74b37c2a472c002b5217248b3/LICENSE
外部资源
内容由外部网站提供,平台不保证第三方文件的完整性、可用性或安全性。
外部文件的访问权限由第三方管理,本站无法限制其地址的访问。