用途：refactor 是一个智能重构命令技能，触发词包括 refactor、refactoring、cleanup、restructure、extract、simplify、modernize，目标是在理解代码库的前提下进行确定性的重构，而非盲目搜索替换。
主要能力与流程：命令先做意图门禁，解析并确认重构目标、期望结果、范围与成功标准，不明确时必须提问；随后并行探索代码库、构建依赖与影响区 codemap、评估测试覆盖并制定验证策略，再由 Plan 代理生成分步重构计划，最后逐步执行并持续验证。
使用方式：用法为 /refactor [--scope=<file|module|project>] [--strategy=<safe|aggressive>]。重构目标可以是文件路径、符号名、模式或描述；--scope 默认 module；--strategy 默认 safe。执行中会使用 LSP 工具做重命名与引用查找，用 AST-grep 预览与替换结构模式，并在每步后运行 lsp_diagnostics、测试命令和类型检查。
适用场景：适合重命名符号、提取或简化逻辑、现代化代码、清理与重组模块等；需要测试覆盖支撑，高风险或低覆盖时建议先补测试。
限制与平台兼容：该技能可能包含来自 OpenCode harness 的示例，在 Codex 中不能直接调用 call_omo_agent、task、background_output 或 team_* 等 OpenCode 专有工具，需翻译为 Codex 原生工具；Codex 每个会话只暴露一种子代理工具面，需按 multi_agent_v1 或 multi_agent_v2 的差异改写调用。角色行为必须写在自包含消息中，fork_context 默认 false，仅确需父历史时用 true；角色由 ~/.codex/agents/ 下的 explorer、librarian、plan、momus、metis、lazycodex-code-reviewer、lazycodex-qa-executor、lazycodex-gate-reviewer 提供。若工具面不暴露 agent_type，则省略并在消息中描述角色。其他平台支持、收费和具体效果暂未提供。