mcpField
R
refactor-project

refactor-project

github.com/fradser开发596121 次安装5 周前更新
代码仓库

关于 refactor-project

一项项目级重构技能，使用 `refactor:code-simplifier` Agent 分析并修改跨文件代码。面向希望减少重复、统一代码模式，同时保留行为和公共接口的开发者。

主要功能

  1. 01检查 Git 工作区与版本
  2. 02发现项目代码文件
  3. 03减少跨文件重复代码
  4. 04启用旧代码清理模式
  5. 05提供变更摘要与回滚指引

适用场景

  1. 01跨多个文件重构代码库
  2. 02减少重复代码并统一模式
  3. 03依据记录的基准审查变更

安装

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

$npx skills add https://github.com/fradser/dotclaude --skill refactor-project

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

包含的文件

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

references/
agent-configuration.md
output-requirements.md
scope-analysis.md

详细介绍

重构项目命令

使用 refactor:code-simplifier Agent 执行自动化的全项目重构，重点关注跨文件优化。

操作前检查

目标：确保明确且可复现地执行全项目操作。

操作：

  1. 运行 git rev-parse --is-inside-work-tree；如果结果为 false，告知用户全项目模式需要在 Git 工作区中运行
  2. 使用 git rev-parse --short HEAD 记录当前版本，并在最终总结中附上该版本，以便回滚时参考
  3. 忽略命令参数，继续进行全项目发现

阶段 1：分析项目范围

目标：发现所有代码文件并显示范围摘要。

操作：

  1. 使用 Glob 模式查找常见扩展名的所有代码文件
  2. 排除 node_modules/、.git/、dist/、build/、vendor/、.venv/
  3. 按语言/扩展名对文件分组，并确定主要源代码目录
  4. 显示范围摘要（文件数量、语言、目录），然后自动继续

排除模式和边缘情况请参阅 references/scope-analysis.md。

阶段 2：启动重构 Agent

目标：启动 refactor:code-simplifier Agent，执行全项目重构并重点关注跨文件优化。

操作：

  1. 使用发现的所有代码文件启动 refactor:code-simplifier Agent
  2. 强调跨文件优化：减少重复、统一模式
  3. 传入用于移除旧代码的激进模式标志
  4. Agent 自动加载 refactor:best-practices 技能，并应用针对特定语言的模式

Task 参数详情请参阅 references/agent-configuration.md。

阶段 3：总结

目标：全面汇报全项目变更。

操作：

  1. 汇报重构的文件总数（数量及占项目的百分比）
  2. 按改进类型分类列出变更，并列出所做的跨文件改进
  3. 列出已应用的最佳实践和已移除的旧代码
  4. 建议运行的测试套件，并建议按逻辑分组审查变更
  5. 提供与已记录基线关联的安全回滚命令（例如：git restore --worktree --staged .）

详细总结格式请参阅 references/output-requirements.md。

要求

  • 显示范围后立即执行（无需确认）
  • 重构整个项目中发现的所有代码文件
  • 优先减少跨文件重复并统一模式
  • 保留行为和公共接口，除非用户明确要求更改行为

评论

支持 Markdown