SuperAPI AI 工具集

agent-ready-go

编程与开发

查看项目

更新于 10-16 01:11

技能介绍

用途:让 Go 应用与 AI 编码智能体高效协作,核心是让工具输出机器可读、错误结构化、命令默认非交互执行。

主要能力与流程: 审计:对照检查清单找出差距,涵盖结构化日志、JSON 输出、linting、测试、错误处理、非交互设计、Makefile、退出码、context 传递、优雅关闭、健康检查、govulncheck、NO_COLOR、环境变量配置等。 结构化日志:配置 slog、Zap、ZeroLog 或 Logrus,非 TTY 或 LOG_FORMAT=json 时输出 JSON,字段含 level、ts、msg 及上下文;日志写 stderr,stdout 保持纯净。支持 LOG_FORMAT=json 环境变量。 机器可读输出:命令支持 --json 或 --output json,结构化数据写 stdout,进度/人类信息写 stderr。 Linting:复制 assets/.golangci.yml 到项目根目录,运行 golangci-lint run ./...,需 golangci-lint v1.59+(v1.x)。 测试:运行 go test -race -count=1 -timeout=5m -coverprofile=coverage.out ./...,不强制任意行覆盖率百分比,而是要求主要导出 API 有可用的 ExampleXxx 测试。 错误处理:错误用 fmt.Errorf("...: %w", err) 包装;退出码 0 成功、非零失败;CLI main 捕获错误;不在业务深处 os.Exit,不在 init 外 panic。 非交互设计:阻塞提示需有 --yes/-y 绕过,优先环境变量。 Makefile:复制 assets/Makefile,调整 BINARY_NAME 与 MAIN_PKG,标准目标 build、test、lint、cover、ci。

适用场景:新 Go 项目或改造现有项目,使其便于智能体与人类基于契约测试协作。

限制:资料仅提供流程与命令,未提供具体安装命令、收费、价格或效果数据;参考文档包括 logging、testing、error-handling、non-interactive、services、config。

本技能属于 rshade/agent-skills,URL:https://www.skills.sh/rshade/agent-skills/agent-ready-go