用途:对当前分支改动执行一次完整的清理流程,属于自主式工作流——所有检查和修复先自动执行,最后才向开发者呈现结果并请求审批。
主要能力:先确定基础分支(读取 .agent 中的 baseBranch=<value>,默认 main),通过 git status、git diff、git diff --cached 和 git diff <base-branch>...HEAD 了解改动范围,按类别汇总本分支改动;调用 /verify-test-cases 检查自上次推送后修改的测试文件;运行一次覆盖率命令(Node.js、Python、Rust、Go 各有对应命令)并复用输出做全部分析;针对本分支改动文件补齐缺失测试至 100%;按项目类型自动执行 lint 修复(如 npm run lint:fix、npx eslint . --fix、ruff、cargo fmt、gofmt 等);运行审计修复(npm audit fix、pip audit、cargo audit、govulncheck)。
使用方式:输入 /cleanup 启动完整工作流。流程结束后用 AskUserQuestion(multiSelect: true)让开发者勾选要保留的修复项,再 git add 暂存并提交。
适用场景:提交前对当前分支做统一质量把关,涵盖审查、测试、覆盖率、lint 与依赖安全。
限制与边界:仅处理当前分支相对基础分支引入的改动,不修改未改动代码中的既有问题;覆盖率命令只运行一次;npm audit fix 不会自动加 --force;无未提交改动时提示并停止;未检测到 lint、审计或覆盖率工具时跳过对应步骤;若开发者拒绝全部修复,则只提交原始改动。