SuperAPI AI 工具集

codeguard-cobol

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:面向 COBOL 项目的 Codeguard 技能,帮助识别 COBOL 文件与用户意图,并在用户要求 lint、格式检查、自动修复、提交前质量验证,或 CI 出现 COBOL 工具链相关失败时使用。核心目标是把“看起来没问题”变成可重复的工具证据,并诚实区分通过、失败、无法验证和 planned。

主要能力与边界:能识别 .cbl、.cob、.cpy 文件,说明当前支持状态与缺口,为未来接入定义可验证的验收条件。当前状态为 planned(自 Codeguard V0.5),无专用标记文件,无独立 CLI linter,lint、format/fix、项目级 gate 均未接入,依赖平台 IDE 诊断。不执行不存在的通用 linter 命令,不把扩展名识别写成质量门禁通过,不在没有运行证据时升级支持状态。

使用方式:先确认仓库根、模块根、生成目录、vendor 目录和用户指定文件;读取仓库现有配置及 CI 中的实际命令,仓库配置优先;运行对应工具 --version 探测工具与版本;执行只读检查并记录命令、工作目录、退出码、工具版本和首个可操作错误;按格式、静态规则、配置、环境、工具内部错误分型;受控修复后复跑同一命令,再运行项目已有测试与构建。修复后必须复跑触发失败的原命令,先审查 diff。

适用场景:检查或修复 COBOL 代码规范;AI 修改 .cbl、.cob、.cpy 后提交前验证;CI 出现 COBOL 工具链相关失败;判断问题能否自动修复或需人工处理。

限制:不适用于学习语言语法、框架设计或业务建模;不适用于依赖漏洞、安全审计或许可证治理;用户只要求解释一条报错且无项目上下文时,先做局部解释,不宣称仓库全绿。工具缺失、版本不兼容或配置无法加载均记为无法验证,不是通过。formatter 不是 linter,格式全绿不能覆盖静态规则或编译错误。自动修复可能扩大 diff,破坏性或大范围修改须用户明确确认。本技能不收集、上传、发送或存储用户代码和凭据,默认只读取本地仓库配置并运行本地工具,不联网安装依赖。信息不足时先给出安全的只读检查方案,并列出仍需确认的仓库根目录、目标工具与版本、项目配置文件、CI 权威命令、是否允许自动修复等具体项。