1k-coding-patterns

OneKeyのコーディングパターンとベストプラクティス

クイックリファレンス

トピック	ガイド	ポイント
Promiseの処理	promise-handling.md	必ずawaitまたはvoidを使用し、浮いたPromiseを残さないでください
Reactコンポーネント	react-components.md	名前付きインポートを使用し、関数コンポーネントを使い、FC型は使用しないでください
使用制限のあるパターン	restricted-patterns.md	禁止事項：toLocaleLowerCase、hd-coreの直接インポート
日付のフォーマット	date-formatting.md	ネイティブの日付フォーマットではなく、OneKeyのdateUtilsを使用してください
エラー処理	error-handling.md	RPC／ランタイムの境界を越えてエラーを保持してください

重要なルールの概要

Promiseの処理

// ❌ FORBIDDEN - floating promise
apiCall();

// ✅ CORRECT
await apiCall();
// or
void apiCall(); // intentionally not awaited

Reactコンポーネント

// ❌ FORBIDDEN
import React, { FC } from 'react';
const MyComponent: FC<Props> = () => {};

// ✅ CORRECT
import { useState, useCallback } from 'react';
function MyComponent({ prop }: { prop: string }) {}

使用制限のあるパターン

// ❌ FORBIDDEN
string.toLocaleLowerCase()
import { x } from '@onekeyfe/hd-core';
import { localDbInstance } from '...';

// ✅ CORRECT
string.toLowerCase()
const { x } = await CoreSDKLoader();
import { localDb } from '...';

関連スキル

• /1k-i18n - 国際化と翻訳
• /1k-cross-platform - プラットフォーム固有のコード
• /1k-code-quality - リントとコード品質
• /1k-performance - パフォーマンスの最適化
• /1k-state-management - Jotaiアトムのパターン
• /1k-architecture - プロジェクト構成とインポートのルール