SuperAPI AI 工具集

tidy-repo

部署与运维

查看项目

更新于 10-16 01:35

技能介绍

用途:在单次运行中扫描仓库(或指定范围)的目录结构,识别结构性问题并输出带优先级的整理报告,指导人工或自动清理;可选在 apply-safe 模式下执行安全、可逆操作。

主要能力:检测 misplaced(错放文件)、naming(命名违反约定)、empty-dir(空目录)、dead-artifact(.bak/.tmp/.orig、名称含 DEPRECATED/OLD/UNUSED、超 180 天未修改且无引用)、duplicate(重复条目)、structure(非预期或缺失顶层目录)、root-categorization(docs/ 根目录文件应归入子目录)、naming/timestamp-misuse(时间戳误用或缺失)。发现按位置、类别、严重性、标题、描述、建议输出,并按影响与操作代价排序,生成含路径、操作类型、原因、完成条件、是否可自动执行的最小清理步骤。

使用方式:前置条件是项目已建立文档规范 docs/ARTIFACT_NORMS.md;若不存在则拒绝继续,提示先运行 /discover-docs-norms。默认 report-only 模式不修改任何文件;显式启用 apply-safe 时先展示操作列表并等待确认,仅执行 git mv 优先的移动/重命名与删除空目录,记录操作日志。报告默认写入 docs/calibration/repo-tidy.md,含 artifact_type、created_by、lifecycle、created_at 前置事项。

适用场景:日常结构健康检查、新成员入职对齐目录约定、重构后清理残留、CI/CD 结构合规门控、发布前整理。

限制:report-only 不修改任何文件;apply-safe 不删除有内容目录,危险操作标记为需人工处理;不伪造或推测文件内容,仅基于路径、名称、修改时间、大小判断;不修改 git 历史,不执行网络操作。代码质量与架构归 review-codebase,文档规范归 assess-docs,需求规划归 align-planning,提交变更归 commit-work。命令与命令行为以技能文档为准,具体价格与平台支持暂未提供。