SuperAPI AI 工具集

codeguard-protobuf

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:对 Protobuf 项目执行并诊断代码规范门禁,适用于用户要求 lint、格式检查、自动修复、提交前质量验证,或出现 buf lint 相关失败时。

主要能力:根据 .proto 与项目标记识别 Protobuf 工作区;执行 buf lint 并保留退出码、作用域与工具版本;把失败分为格式、静态规则、配置、环境、工具内部错误等类型;用 buf format 处理可逆的格式问题并复扫;把 lint、format、compile、test、security 分层汇报。

使用方式:在仓库根或模块根确认目标文件;探测工具 buf --version;先只读运行 buf lint;读取 buf.yaml、buf.gen.yaml、buf.work.yaml 及 CI 实际命令,仓库配置优先;只对可安全修复项运行 buf format;修复后复跑原命令并执行项目已有测试/构建门禁。结果状态写 PASS / FAIL / UNVERIFIED / PLANNED。

适用场景:检查或修复 Protobuf 代码规范;AI 修改 .proto 后的提交前验证;CI 中 buf lint 相关失败排查;判断问题能否自动修复或需人工处理。

限制:不把 formatter 通过当作编译、测试或安全审计通过;不静默安装工具、升级依赖或修改团队规则;不新增 ignore/suppress 掩盖问题;工具或配置缺失时必须标为 UNVERIFIED,不能声称通过。工具需已安装且版本与项目约束兼容,须从正确模块根执行;生成代码、vendor 与缓存目录是否扫描遵循仓库规则。该技能不收集、上传或存储用户代码和凭据,默认只读本地配置并运行本地工具,不联网安装依赖。仅当命令、范围和退出码都明确时才写“通过”,否则写“未运行”或“无法验证”。Buf lint 通过后仍应单独检查 breaking changes,风格合规不等于 wire compatibility。官方文档未提供更多平台或版本支持细节。