关于 repo-cleanup
用于清理代码、依赖、文档、测试和迭代产物的 Skill。其可重复流程强调先检查使用情况、保留回滚依据,并验证改动。
主要功能
- 01定义范围与安全模式
- 02记录基线并设置回滚点
- 03删除前检查使用情况
- 04通过测试和构建验证
- 05归档迭代产物
适用场景
- 01清理生成文件和缓存
- 02排查疑似废弃代码或依赖
- 03更新过时文档
- 04整理迭代收尾产物
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ nickcrew/ claude-cortex --skill repo-cleanup安装后在 Claude Code 中输入/repo-cleanup确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/archive-sprint.mdcode-cleanup.mddeps-cleanup.mddocs-cleanup.mdtest-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 |
工作流
- 明确范围和安全模式(安全或激进)。
- 记录基线状态(git status、关键测试、备份)。
- 加载目标区域对应的参考文件。
- 执行清理步骤,删除前先检查使用情况。
- 验证变更(测试、构建、lint 或文档检查)。
- 报告结果(已采取的操作、风险、后续事项)。
输出
- 操作摘要和涉及的文件
- 验证结果和剩余风险
- 后续建议或待办事项
常见错误
- 未确认使用情况或能否重新生成就直接删除
- 跳过基线测试和回滚检查点
- 删除依赖项时未更新构建/测试脚本
- 合并文档时未保留入口
评论
支持 Markdown