用途:针对 Dify 前端代码库中高复杂度的 React 组件进行重构。触发条件为 pnpm analyze-component --json 显示 complexity > 50 或 lineCount > 300。
主要能力:提供复杂度分析(complexity 0-100、maxComplexity、lineCount)与重构提示生成,并给出六类重构模式:抽取自定义 Hook、拆分子组件、简化条件逻辑、抽取 API/数据逻辑、抽取弹窗管理、抽取表单逻辑。还包含 Dify 特定约定,如 Context Provider 拆分、工作流节点组件结构、配置组件与工具/插件组件组织方式。
使用方式:在 web/ 目录下运行命令。生成重构提示:pnpm refactor-component <path>;输出 JSON:pnpm refactor-component <path> --json;重构后生成测试提示:pnpm analyze-component <path>;输出测试分析 JSON:pnpm analyze-component <path> --json。重构流程为生成提示、分析细节、制定计划、增量执行(每次抽取后运行 pnpm lint:fix、pnpm type-check、pnpm test 并手动验证)、最后复跑命令验证。目标指标为 complexity < 50、lineCount < 300、maxComplexity < 30。
适用场景:Dify 前端组件复杂度治理,尤其是配置、工作流节点、工具/插件等模块。
限制:该技能用于组件分解,不涉及查询/变更设计;不要引入已废弃的 useInvalid / useReset;重构时不要添加薄透传的 useQuery 包装,仅在真正编排多个查询/变更或共享派生状态时抽取自定义 Hook。避免过度工程、破坏既有模式与过早抽象。相关技能为 frontend-testing,测试规范见 web/docs/test.md。