SuperAPI AI 工具集

codeguard-yaml

测试与质量

查看项目

更新于 10-15 21:48

技能介绍

用途:对 YAML 项目执行并诊断代码规范门禁,把“看起来没问题”变成可重复的工具证据,并诚实区分通过、失败、无法验证与 planned。覆盖 .yml、.yaml 文件,无专用项目标记文件,接入以仓库现有配置为准。

主要能力:识别 YAML 工作区;执行 yamllint . 并保留退出码、作用域和工具版本;区分格式、静态规则、配置、环境、工具内部错误五类失败;对可逆问题受控修复并复扫;把本地结果与 CI、构建、测试证据分层汇报。

使用方式:先确认仓库或模块根、目标工具与版本、项目配置文件;探测工具运行 yamllint --version;只读检查运行 yamllint .;失败分型后仅对安全可修复项执行同一命令,再复跑原命令并运行项目已有测试与构建。工具准备:pip install yamllint。输出状态为 PASS / FAIL / UNVERIFIED / PLANNED,并列出范围、工具、命令、发现、修改、复验与未验证项。

适用场景:用户要求检查或修复 YAML 规范;AI 修改 .yml、.yaml 后需提交前验证;CI 出现 yamllint . 相关失败;判断问题能否自动修复。

限制:不把 formatter 通过当作编译、测试或安全审计通过;不静默安装工具、升级依赖或修改团队规则;不用 suppress/ignore 掩盖问题;工具缺失、版本不兼容或配置无法加载时记为无法验证而非通过;不从错误模块根运行;生成代码与 vendor 目录须遵循仓库规则;YAML 语法正确不等于 Kubernetes、Compose 或 CI schema 正确,需额外 schema 校验。修复后必须先检查 diff,破坏性或大范围修改须用户明确确认。本技能不收集、上传或存储用户代码和凭据,不联网安装依赖。