SuperAPI AI 工具集

1k-coding-patterns

编程与开发

查看项目

更新于 10-16 00:04

技能介绍

用途:为 OneKey 项目开发提供编码规范与最佳实践,在编写 React 组件、处理 Promise、错误处理或遵循代码约定时使用。

主要能力与要求: 通用开发:以测试驱动开发思路编写函数,每个可复用的底层函数或方法只做单一原子任务,同时避免不必要的抽象层。

Promise 处理(强制遵守):始终 await Promise;仅在有意不等待时使用 void 前缀;对浮动 Promise 零容忍,严格遵循 @typescript-eslint/no-floating-promises 规则;任何异步操作前先考虑错误场景并添加 try/catch;确认所有 Promise 链都有错误处理。

React 组件:避免默认导入 React,只用具名导入;优先函数组件而非类组件;用纯函数创建组件,避免导入 import type { FC } from 'react';遵循 Hooks 规则(依赖数组、只在顶层调用);使用 usePromiseResult 与 useAsyncCall 钩子并正确设置依赖数组。

受限模式(严格禁止):禁止使用 toLocaleLowerCase() 或 toLocaleUpperCase(),改用 toLowerCase() 与 toUpperCase();禁止直接从 '@onekeyfe/hd-core' 导入,始终使用 const {} = await CoreSDKLoader() 模式;禁止直接导入 localDbInstance,始终使用 localDb;禁止修改自动生成文件(translations.ts、locale JSON 文件);禁止在无书面理由时用 any 或 @ts-ignore 绕过 TypeScript 类型;禁止提交未通过 lint 或 TypeScript 编译的代码。

错误处理:对可能失败的异步操作使用 try/catch,提供合适的错误信息与回退方案,需要加载/错误状态时可用 useAsyncCall 钩子。

代码质量与注释:PR 前修复 ESLint 警告,运行 yarn run lint 检查并修复;所有注释必须用英文,包括行内注释、函数文档与代码说明,不使用中文注释。

限制:资料未提供该技能的安装方式、平台支持范围、收费信息及具体使用步骤,暂未提供。