mcpField
R
refactor

refactor

github.com/fradser开发596113 次安装3 天前更新
代码仓库

关于 refactor

通过 `refactor:code-simplifier` Agent 执行自动重构的命令技能。它可根据路径、语义搜索或近期改动确定范围，排除依赖和生成文件，并汇总变更。

主要功能

  1. 01按路径或语义查询确定范围
  2. 02无参数时使用近期改动
  3. 03排除依赖和生成产物
  4. 04以激进模式启动代码简化 Agent
  5. 05汇总变更并建议测试

适用场景

  1. 01重构指定文件或目录
  2. 02查找符合语义请求的代码
  3. 03重构近期修改的代码文件
  4. 04查看自动变更的范围与摘要

安装

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

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

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

包含的文件

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

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

详细介绍

Refactor Command

使用 refactor:code-simplifier agent 为 $ARGUMENTS 执行自动重构。

操作前检查

目标：启动 agent 前，确保范围解析具有确定性。

操作：

  1. 运行 git rev-parse --is-inside-work-tree；即使结果为 false，只要提供了明确路径也继续
  2. 规范化参数：去除空白，并保留引号括起的路径片段
  3. 将空参数列表视为“最近更改”模式

阶段 1：确定目标范围

目标：根据参数或会话上下文识别要重构的文件。

操作：

  1. 如果提供了参数：使用 Glob 验证其是否为文件或目录路径
  2. 如果路径存在：直接将其作为重构范围
  3. 如果路径不存在：将参数视为语义查询，使用 Grep 搜索代码库
  4. 如果没有参数：运行 git diff --name-only 查找最近修改的代码文件
  5. 如果未找到最近更改：告知用户并退出，不执行重构

重要：绝不要将 node_modules/、.git/、dist/、build/、锁文件或编译产物纳入重构范围——使用 Grep 的 --glob 排除项确保这一点。

有关搜索策略和边缘情况，请参阅 references/scope-determination.md。

阶段 2：启动重构 Agent

目标：启用激进模式，执行 refactor:code-simplifier agent。

操作：

  1. 使用目标范围和激进模式标志启动 refactor:code-simplifier agent
  2. 传递范围判定方法（路径、语义查询或会话上下文）
  3. Agent 会自动加载 refactor:best-practices 技能，并应用特定语言的模式

有关 Task 参数的详细信息，请参阅 references/agent-configuration.md。

阶段 3：总结

目标：全面汇报更改内容。

操作：

  1. 汇报重构的文件总数，并按改进类型分类说明更改
  2. 列出应用的最佳实践和移除的旧代码
  3. 建议运行的测试，并提供与实际范围相符的回滚命令（例如：git restore --worktree --staged <files>）

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

要求

  • 立即执行，无需用户确认
  • 如果语义搜索返回多个结果，重构所有匹配的文件
  • 项目级范围请引导用户使用 /refactor-project
  • 保留行为和公共接口，除非用户明确要求更改行为

评论

支持 Markdown