项目重构Skill refactor-project

此技能用于自动执行项目范围内的代码重构,专注于跨文件优化、减少代码重复、标准化代码模式,以提高代码质量和可维护性。关键词:项目重构、代码重构、跨文件优化、重复减少、一致性标准化、自动化工具、代码优化、软件维护。

架构设计 0 次安装 0 次浏览 更新于 3/16/2026

name: refactor-project description: 当用户请求项目范围重构、跨文件简化、代码库一致性标准化、重复减少或调用/refactor-project时,应使用此技能。 argument-hint: (无需参数) allowed-tools: [“Task”, “Read”, “Bash(git:*)”, “Grep”, “Glob”] user-invocable: true

重构项目命令

使用refactor:code-simplifier代理执行自动化的项目范围重构,专注于跨文件优化。

预操作检查

目标: 确保项目范围执行是明确且可复现的。

操作:

  1. 运行git rev-parse --is-inside-work-tree;如果为假,告知用户项目范围模式需要一个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: 启动重构代理

目标: 执行refactor:code-simplifier代理,具有项目范围和跨文件焦点。

操作:

  1. 使用所有发现的代码文件启动refactor:code-simplifier代理
  2. 传递跨文件优化重点:重复减少、一致模式
  3. 传递激进模式标志以移除遗留代码
  4. 代理自动加载refactor:best-practices技能并应用语言特定模式

有关详细的任务参数,请参阅references/agent-configuration.md

阶段3: 摘要

目标: 报告项目范围更改的全面摘要。

操作:

  1. 报告重构的总文件数(项目中的数量和百分比)
  2. 列出按改进类型和跨文件改进分类的更改
  3. 列出应用的最佳实践和移除的遗留代码
  4. 建议运行的测试套件并推荐按逻辑组审查更改
  5. 提供绑定到记录基线的更安全回滚命令(例如:git restore --worktree --staged .

有关详细摘要格式,请参阅references/output-requirements.md

要求

  • 显示范围后立即执行(无需确认)
  • 在所有发现的代码文件中重构整个项目
  • 优先考虑跨文件重复减少和一致模式
  • 除非用户明确请求行为更改,否则保留行为和公共接口