SuperAPI AI 工具集

tidy

通用与其它

查看项目

更新于 10-16 00:24

技能介绍

用途:tidy 是“顺手童子军”式的主动改进循环,回答“今天能对代码库的某一小片做哪些安全的结构性改进,并作为一个紧凑 PR 交付,且不混入行为变更”。它把 Kent Beck《Tidy First?》的 tidyings、童子军规则与智能体重构研究结合起来,强调结构变更与行为变更必须分开提交、分开 PR。

主要能力:按 lane 轮换扫描代码库,lane 由 lane 文件定义 scope globs、watch-for tidyings、排除项、验证命令、Conventional Commits 类型与推荐研究来源;内置 shell-tooling、docs-prose、self-update 三个 lane,并提供 dependency-root、host-wiring、apps、polyglot-services 模板供项目复制到 .claude/tidy-lanes/。支持 dry-run 只规划不改动、self-update 维护插件自身、help 打印路由与 lane 目录。

使用方式:参数为空时根据当前分支、最近提交与 git status 推断 lane;也可传入 lane 名或 dry-run [<lane>]。工作流分 8 阶段:Triage、Branch、Explore+research、Hunt+prioritize+scope-budget、Implement、Verify、Self-review+simplify、Ship。分支命名 chore/tidy-<lane>-YYYY-MM-DD;每个逻辑 tidying 一次提交,仅 git add <path>;提交信息用 Conventional Commits;验证需跑构建、测试与 linter;PR 创建走 /pull-request create,并在 PR 上补一条审计评论。

限制:有 backlog 节流,若已有 ≥3 个 chore/tidy-* 开放 PR 则停止;scope 预算目标 ≤200 LOC 且 ≤8 文件,硬上限 ≤400 LOC 且 ≤15 文件;全局硬排除包括 .claude/settings*、.claude/agents/、.claude/hooks/、.claude/rules/、.github/workflows/、.mcp.json、lint 配置等;软排除包括浏览器渲染 UI、交互式认证、真实实例数据库迁移等;不做行为变更、不自动合并、不处理 issue-tracker 起始项、不做文档事实核查。具体命令与脚本细节以官方资料为准。