SuperAPI AI 工具集

go-spec-reviewer

通用与其它

查看项目

更新于 10-16 00:20

技能介绍

用途:在开始实现前审查 Go 设计文档,确认其完整、一致且符合 Go 惯用法。评审视角参考 Rob Pike、Go 标准库作者与 spf13 的风格:拒绝不必要的抽象、要求显式错误处理、追求能真正工作的最简设计。

主要能力:检查代码库上下文(包结构、命令构造方式、注册点、可复用模式、go.mod 中的 Go 版本);进行 Go 哲学检查(简洁性、依赖是否可用标准库替代、接口是否由使用方定义且足够小、错误是否显式返回并用 %w 包装、context 是否贯穿 I/O、并发是否有明确所有权与关闭路径、包职责、命名、测试策略、YAGNI);若为 Cobra/Viper CLI,检查命令是否用工厂函数构造、是否注册、RunE 与 Run、持久与局部标志、Args 校验、Viper 绑定与默认值、输出是否走 cmd.OutOrStdout()、输入输出路径冲突防护;最后检查规格完整性、一致性、清晰度、范围、数据流、兼容性与安全性。

使用方式:若可用子代理/Task 工具,派发通用子代理并传入规格文件路径;否则自行内联执行相同步骤。若已安装 go 与 cobra-viper 技能(检查 /mnt/skills/user/go/SKILL.md 与 /mnt/skills/user/cobra-viper/SKILL.md),先读取它们作为惯用法的权威来源。

输出格式:状态为 Approved、Approved with Questions 或 Issues Found,并分列阻塞实现的问题、需作者回答的疑问、建议性推荐。

限制:只标记会导致实际实现问题的缺陷;措辞偏好与格式不一致不算问题;歧义默认作为疑问而非阻塞;除非存在会导致实现有缺陷或不完整的缺口,否则应批准。具体安装命令与更多细节暂未提供。