用途:在 Fusion Framework React 应用中开发功能、组件、Hook、服务或类型时使用。典型场景包括新增组件/页面、接入 API、配置 Fusion 模块、选择框架 Hook 或包、持久化应用设置、添加书签/分析/功能开关、为 AG Grid 添加图表或人员列、编写自定义模块,以及为组件、Hook、路由编写测试并模拟认证、上下文、功能开关或 HTTP。
主要能力:先检查项目约定(package.json、tsconfig.json、src/ 结构、ADR、格式化与 lint 配置、app.config.ts 与 app.manifest.ts),再规划实现并映射到典型目录(components、hooks、api、types、routes.ts、config.ts、App.tsx)。样式遵循 styled-components、EDS 与 @equinor/fusion-react-* 组件约定;数据获取通过 configureHttpClient 注册客户端,使用 useHttpClient 等 Hook,React Query 封装为薄 Hook;模块配置在 config.ts 的 AppModuleInitiator 中完成,路由使用 Fusion Router DSL。
使用方式:按步骤发现约定、规划、实现、样式、数据获取、模块配置、测试与验证。验证需运行 typecheck 与 lint,导出符号需有 TSDoc,测试使用 fusion-framework-testing,必要时用 fusion-framework-mocking。
限制:不用于问题编写、技能编写、后端服务变更、CI/CD 或部署配置、架构文档;不确定的框架行为应先使用 fusion-research。未经批准不新增依赖,不使用 any 类型,不直接操作 DOM,不在源码中存放密钥,使用约定式提交。