mcpField
R
repo-cleanup

repo-cleanup

github.com/nickcrew开发62174 次安装17 周前更新
代码仓库

关于 repo-cleanup

用于清理代码、依赖、文档、测试和迭代产物的 Skill。其可重复流程强调先检查使用情况、保留回滚依据,并验证改动。

主要功能

  1. 01定义范围与安全模式
  2. 02记录基线并设置回滚点
  3. 03删除前检查使用情况
  4. 04通过测试和构建验证
  5. 05归档迭代产物

适用场景

  1. 01清理生成文件和缓存
  2. 02排查疑似废弃代码或依赖
  3. 03更新过时文档
  4. 04整理迭代收尾产物

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/nickcrew/claude-cortex --skill repo-cleanup

安装后在 Claude Code 中输入/repo-cleanup确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
archive-sprint.md
code-cleanup.md
deps-cleanup.md
docs-cleanup.md
test-cleanup.md

详细介绍

仓库清理

概述

建立安全、可重复的清理工作流,涵盖代码、依赖项、文档、测试和迭代产物。通过验证使用情况、删除前归档以及用测试进行验证,将风险降至最低。

适用场景

  • 仓库臃肿(生成的产物、缓存、未使用的文件)
  • 怀疑存在死代码或未使用的依赖项
  • 文档与实际行为脱节
  • 测试脆弱、冗余或位置不当
  • 迭代结束时需要有序归档

以下情况应避免:

  • 正在处理活动中的事故响应
  • 目标区域没有负责人或回滚保障

快速参考

任务加载参考文件
代码清理skills/repo-cleanup/references/code-cleanup.md
依赖项清理skills/repo-cleanup/references/deps-cleanup.md
文档清理skills/repo-cleanup/references/docs-cleanup.md
测试清理skills/repo-cleanup/references/test-cleanup.md
迭代归档skills/repo-cleanup/references/archive-sprint.md

工作流

  1. 明确范围和安全模式(安全或激进)。
  2. 记录基线状态(git status、关键测试、备份)。
  3. 加载目标区域对应的参考文件。
  4. 执行清理步骤,删除前先检查使用情况。
  5. 验证变更(测试、构建、lint 或文档检查)。
  6. 报告结果(已采取的操作、风险、后续事项)。

输出

  • 操作摘要和涉及的文件
  • 验证结果和剩余风险
  • 后续建议或待办事项

常见错误

  • 未确认使用情况或能否重新生成就直接删除
  • 跳过基线测试和回滚检查点
  • 删除依赖项时未更新构建/测试脚本
  • 合并文档时未保留入口

评论

支持 Markdown