mirror of https://github.com/luongnv89/claude-howto.git synced 2026-08-21 12:17:15 +02:00

Files

T

Luong NGUYEN b9a973bf32 docs: accuracy pass against Claude Code v2.1.220 (#155 )

Internal accuracy pass against v2.1.220 — no missing upstream features, but broken example code, disagreeing counts, and metadata drift.

Functional fixes: pre-commit.sh now exits 2 so it actually blocks; dependency-check.sh reads file_path from stdin JSON instead of $1; database-mcp.json uses ${DATABASE_URL}; broken fences repaired; three command templates had invalid skill names.

Factual corrections: /fork and /subtask unswapped and /subtask added; /fewer-permission-prompts; permissions.defaultMode; dontAsk/auto unreversed; 31 hook events verified name-by-name; subagent depth 3; skill precedence enterprise > project > personal; /output-style removed not deprecated; permissionDecision gained defer.

Follow-up review fixed defects the pass left behind: zh/vi headers claiming 31 events above 25-name lists, a surviving hardcoded DB credential in the MCP README examples, an unbalanced fence swallowing a metadata footer, and non-canonical tool names. All four translated CATALOG summary tables were recounted so their arithmetic holds.

Full detail in CHANGELOG.md under v2.1.220-r2.

2026-08-04 15:41:12 +07:00

2.1 KiB

Raw Blame History

API モジュール標準

このファイルは /src/api/ 配下のすべてに対し、ルートの CLAUDE.md を補完する。メモリファイルは連結されるものであり、上書きされるわけではない。ルートの CLAUDE.md は引き続き適用され、 Claude Code はこのサブツリー内のファイルを読むときに本ファイルをオンデマンドで読み込む。

API 固有の標準

リクエスト検証

スキーマ検証には Zod を使う
入力は必ず検証する
検証エラー時は 400 を返す
フィールド単位のエラー詳細を含める

認証

すべてのエンドポイントで JWT トークンを必須とする
トークンは Authorization ヘッダに付ける
トークンの有効期限は 24 時間
リフレッシュトークン機構を実装する

レスポンス形式

すべてのレスポンスは次の構造に従う:

{
  "success": true,
  "data": { /* actual data */ },
  "timestamp": "2025-11-06T10:30:00Z",
  "version": "1.0"
}

エラーレスポンス:

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "User message",
    "details": { /* field errors */ }
  },
  "timestamp": "2025-11-06T10:30:00Z"
}

ページネーション

カーソルベースページネーションを使う（オフセット方式は使わない）
hasMore の真偽値を含める
1 ページの最大サイズは 100 まで
デフォルトのページサイズ: 20

レート制限

認証済みユーザー: 1 時間あたり 1000 リクエスト
公開エンドポイント: 1 時間あたり 100 リクエスト
上限超過時は 429 を返す
retry-after ヘッダを付ける

キャッシュ

セッションキャッシュには Redis を使う
キャッシュ期間: デフォルト 5 分
書き込み操作時に無効化する
キャッシュキーにリソース種別のタグを付ける

Last Updated: April 9, 2026

2.1 KiB Raw Blame History