用途
safe-refactor-code 是一个代码重构技能，目标是在小型、可验证的切片中安全地重构代码，并在重构后更新仓库的连续性文件，让未来的智能体无需重读整个会话即可接手工作。它强调行为保持、逐片验证、死代码清理与文档同步，并尽量做到与具体 AI 智能体产品无关。
主要能力
- 图感知重构：借助 codegraph 索引分析调用方、影响半径和受影响文件。
- 连续性文档维护：同步 AGENTS.md、MEMORY.md、CHANGELOG.md 和 safe-refactor-code.md。
- 安全切片重构：一次处理一个子系统或关注点，用最窄的有效检查验证每一片。
- 死代码清理：重构后扫描明显的死代码、未使用导入、过期辅助函数和过时文档引用。
- 跨智能体兼容：使用通用术语，适配不同宿主环境的记忆系统与交接文件。
使用方式
技能定义了明确的工作流：
- 先读连续性文件：在写入 AGENTS.md 后，检查 AGENTS.md、.safe-code/safe-refactor-code.md、.safe-code/MEMORY.md、.safe-code/CHANGELOG.md。
- 有图上下文时先规划：依次使用 codegraph explore、codegraph sync、codegraph impact、codegraph callers|callees；若 codegraph 失败，记录失败并改用 rg、导入、清单、测试和直接源码阅读。
- 在安全切片中重构：优先一次一个子系统或关注点，除非用户要求，否则保持行为不变，用 lint、类型检查、测试、构建或定向探测验证每一片。
- 变更后审查：运行 codegraph sync 与 codegraph affected，直接阅读变更文件，移除意外未使用的导入或过期导出，运行最窄的有效验证命令。
- 完成前同步文档：更新 .safe-code/ 下的连续性文件以及仓库根目录的 AGENTS.md。
- 保持变更日志结构稳定：按 Keep-a-Changelog 模板或按日期分节记录可发布变更。
- 以卫生检查收尾：移除重构引入的未使用导入，高置信度时移除因重构而失效的辅助函数、导出或文件，更新文档中过期的文件/路径引用。
文档位置约定：AGENTS.md 位于仓库根目录；MEMORY.md、CHANGELOG.md、safe-refactor-code.md 位于 <repo-root>/.safe-code/。若 .safe-code/ 不存在则创建。
适用场景
典型触发请求包括：安全重构此仓库、重构后清理、同时更新 agents 和 changelog、修改此流程后移除死代码、重构时保持仓库记忆同步、让此重构对未来的智能体更安全。
限制
- 符号重命名没有图预览，需先列出 codegraph callers 与 codegraph impact，编辑后用 rg 确认旧名 0 命中。
- codegraph callers 为空只是候选，需经 rg、配置和动态引用检查后才可删除高置信度候选。
- 声称“更快”或“更轻”的重构需要相同条件下的基线测量，否则只能作为假设报告；“行数更少”不是性能证据。
- 在可能共享的检出中不得使用破坏性 git 操作。
- 若检测到超出当前重构范围的大面积死代码，应调用 codebase-pruner 技能进行全仓库死代码审计。
- 关于收费、价格、平台支持等具体信息，资料中暂未提供。