用途:对 Codeguard 检出的可逆格式与静态规则问题执行受控自动修复。适合用户要求自动修复、/fix、格式化修复,或 lint 明确给出 autofix 时使用。
主要能力:一键修复格式类问题;bin/codeguard fix --dry-run 预览不实际修改;bin/codeguard fix 执行修复;bin/codeguard fix --lang python 只修 Python。只运行 format 工具,不触碰业务逻辑。
前置条件:对应 format 工具已安装。fix 只在 Legacy Python 引擎下存在,Rust codeguard 组件没有自动修复命令,探测到 Rust 引擎时不要构造 codeguard fix。
工作流:先 bin/codeguard check 确认失败项并保存基线(失败命令、退出码、工具版本、失败数、git status --short);再 bin/codeguard fix --dry-run 预览,核对工具、目录与排除范围;然后 bin/codeguard fix 执行;用与基线相同的 check 命令复扫至全绿;最后 git diff review 自动修复的改动,确认无业务逻辑变更,并执行受影响测试与构建。
限制与注意:没有失败基线不自动修复;每次修复都必须审查 diff 并复跑原命令;工具缺失时输出 UNVERIFIED,不静默安装;不把 lint PASS 扩大为功能正确;不修改用户未提交内容。不适用范围包括尚未得到可复现 lint 失败、违规涉及业务语义/并发/安全/API 兼容性、需升级依赖或大范围重写。npm audit fix 可能引入破坏性升级,固定后必须回归测试;eslint --fix 只修可自动修复规则,复杂度/unused 需人工。数据安全:本技能不上传、发送或存储源码和凭据,不用 reset/checkout 覆盖现有工作,不用 suppression 隐藏失败。安装:npx skills add full-stack-skills/codeguard-skills --skill codeguard。