SuperAPI AI 工具集

codeguard-metal

测试与质量

查看项目

更新于 10-16 05:47

技能介绍

用途:帮助 Codeguard 识别 Metal(.metal)文件及相关用户意图,在用户要求 lint、格式检查、自动修复、提交前质量验证,或出现与尚未接入的检查链相关失败时,明确说明当前支持状态与缺口,而不是冒充已执行规范门禁。

主要能力:识别 .metal 文件;报告 Codeguard 当前支持状态与缺口;为未来接入定义可验证的验收条件;区分 PASS、FAIL、UNVERIFIED、PLANNED 四种状态。据资料,本技能状态为 planned(自 Codeguard V0.5 起),文件扩展名 .metal,无专用标记文件,接入配置以仓库现有配置为准,无独立 CLI linter,依赖平台 IDE 诊断;探测命令为查找命令与项目配置检查;lint、format/fix、项目级 gate 均未接入。

使用方式:先确认仓库根、模块根、生成目录、vendor 目录与用户指定文件;读取仓库现有配置及 CI 中的实际命令,配置优先于技能示例,冲突时先报告差异;运行对应工具 --version 探测,缺失或不兼容记为无法验证;执行只读检查并记录命令、工作目录、退出码、工具版本与首个可操作错误;按格式、静态规则、配置、环境、工具内部错误分型;受控最小修复,自动修复前检查 diff,破坏性或大范围修改需用户确认;修复后必须复跑触发失败的原命令,并运行项目已有测试与构建。若必须检查,使用目标平台官方工具并把结果标为外部证据。

适用场景:用户要求检查或修复 Metal 代码规范;AI 修改 .metal 后需提交前验证;CI 出现与 Metal 工具链相关失败;判断问题能否自动修复或需人工处理。不适用:学习语言语法、框架设计或业务建模;依赖漏洞、安全审计或许可证治理;仅解释单条报错且无项目上下文时先做局部解释,不宣称仓库全绿。

限制:不执行不存在的通用 linter 命令,不把扩展名识别写成门禁通过,不在无运行证据时升级支持状态;工具缺失必须输出 UNVERIFIED 并给出准备方式;formatter 不等于 linter;不在错误模块运行以免漏检或加载错误配置;不静默安装依赖;自动加 ignore 或 suppression 需用户明确接受并记录理由,否则不可以;需 Xcode/metal 编译链证据后才能升级为 stable/beta。

数据与安全:不收集、上传、发送或存储用户代码和凭据;默认只读取本地仓库配置并运行本地工具;不联网安装依赖;不记录 token、密码或私有源码。

按需加载资源:退出码、失败分类或豁免决策读取 references/rules/gate-rules.md;核对语言注册表、工具链与项目配置读取 references/tooling/toolchain.md;需要可复制任务示例时按场景读取 examples/。

信息不足时,先给出安全的只读检查方案,再确认仓库/模块根目录、目标工具与版本、项目配置文件、CI 权威命令、是否允许自动修复等具体项。官方文档、收费信息与价格暂未提供。