القائمة
代码重构工作流程和模式。在进行组件拆分、hooks 提取、模块重组等重构任务时激活。提供标准流程（分析→规划→执行→验证）和常用重构模式。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
在进行任何创造性工作前必须使用——创建功能、构建组件、添加新功能或修改行为。在实现之前先探索用户意图、需求和设计。
TypeScript 和 React 开发的编码标准与最佳实践。在编写或审查代码时激活。提供命名、类型、组件设计、Hook 提取、状态管理等规范。
在用户确认要提交代码变更时使用——安全检查 diff 中的敏感数据后执行 git commit
在面对 2 个以上互不依赖、无共享状态的独立任务时使用
当有已编写的实现计划需要在独立会话中执行时使用，包含评审检查点
在实现完成、测试通过后，引导决定如何集成工作——提供合并、PR 或清理的结构化选项
| name | refactor-workflow |
| description | 代码重构工作流程和模式。在进行组件拆分、hooks 提取、模块重组等重构任务时激活。提供标准流程（分析→规划→执行→验证）和常用重构模式。 |
检测类型 → ANALYZE → PLAN → [用户确认] → EXECUTE → VERIFY → [/refactor-check]
| 阶段 | 输出 | 关键动作 |
|---|---|---|
| ANALYZE | 分析报告 | 代码异味 + 标准符合性检查 |
| PLAN | 重构计划 | 分解步骤、等待确认 |
| EXECUTE | 代码变更 | 小步修改、每步验证 |
| VERIFY | 验证报告 | eslint/build/test |
| 维度 | 文件模式 | 模块模式 |
|---|---|---|
| 输入 | 单个文件路径 | 目录路径 |
| 分析 | 单文件代码异味 | 目录结构 + 依赖 + 逐文件异味 |
| 步骤粒度 | 行级（<50行/步） | 文件级（1文件/步） |
| 输出 | 单文件优化 | 可能涉及文件拆分/移动/新建 |
| 原则 | 说明 |
|---|---|
| 等待确认 | 规划阶段必须等用户确认后才执行 |
| 小步修改 | 文件模式 <50 行，模块模式 1 文件 |
| 保持可用 | 每步后代码必须可编译 |
| 不改行为 | 纯重构不改变外部行为 |
| 不自动提交 | 重构完成后等待用户确认再提交 |
首先必须加载编码规范：
coding-standards skill，或读取 .agents/skills/coding-standards/ 下所有规范文件references/api.md、references/react.md、references/typescript.md然后根据模式执行分析：
重构完成后（代码未提交），运行：
/refactor-check
校验业务逻辑是否保持不变，参见 refactor-check skill。
文件级（需要拆分/提取）：
模块级（需要重组）：
重要：只检查变更文件，避免格式化整个代码库
# 获取变更文件
CHANGED_FILES=$(git diff --name-only --diff-filter=AM | grep -E '\.(ts|tsx)$' | tr '\n' ' ')
# 只对变更文件运行 eslint（不要直接运行 pnpm lint）
npx eslint $CHANGED_FILES --fix
# 完成后运行 build/test
pnpm build
pnpm test # 如有测试
不要直接运行
pnpm lint，它会格式化整个代码库，产生大量无关变更。