ts-google

Google TypeScript のベストプラクティス

Google の社内標準に基づく包括的な TypeScript スタイルガイドです。AI エージェントと LLM 向けに設計されています。8 つのカテゴリにわたる 45 のルールが含まれており、影響度の高い順に優先順位を付けて、自動リファクタリングとコード生成を支援します。

適用するタイミング

以下の場合に、これらのガイドラインを参照してください。

• 新しい TypeScript コードを記述するとき
• モジュールとインポートを整理するとき
• 型注釈とインターフェースを設計するとき
• クラスと関数を作成するとき
• スタイルの一貫性を確認するためにコードをレビューするとき
• 既存の TypeScript コードをリファクタリングするとき

優先度別のルールカテゴリ

優先度	カテゴリ	影響度	プレフィックス
1	モジュール構成	CRITICAL	module-
2	型安全性	CRITICAL	types-
3	クラス設計	HIGH	class-
4	関数のパターン	HIGH	func-
5	制御フロー	MEDIUM-HIGH	control-
6	エラー処理	MEDIUM	error-
7	命名とスタイル	MEDIUM	naming-
8	リテラルと型変換	LOW-MEDIUM	literal-

クイックリファレンス

1. モジュール構成（CRITICAL）

• module-named-exports - デフォルトエクスポートではなく、名前付きエクスポートを使用します
• module-no-mutable-exports - 可変なエクスポートを避けます
• module-es6-modules - ES6 モジュールのみを使用します
• module-no-namespaces - TypeScript の名前空間を避けます
• module-import-paths - プロジェクト内のインポートには相対パスを使用します
• module-import-type - 型のみのインポートには import type を使用します
• module-export-api-surface - エクスポートする API の範囲を最小限に抑えます

2. 型安全性（CRITICAL）

• types-no-any - any 型は決して使用しません
• types-prefer-interfaces - オブジェクトには型エイリアスよりインターフェースを優先します
• types-explicit-structural - 構造型には明示的に注釈を付けます
• types-nullable-patterns - null 許容型を適切に扱います
• types-array-syntax - 一貫した配列型の構文を使用します
• types-no-wrapper-types - ラッパーオブジェクト型は決して使用しません
• types-prefer-map-set - インデックスシグネチャより Map と Set を優先します
• types-no-empty-object - 空のオブジェクト型を避けます

3. クラス設計（HIGH）

• class-parameter-properties - コンストラクターでの代入にはパラメータプロパティを使用します
• class-readonly-properties - 再代入されないプロパティには readonly を付けます
• class-no-private-fields - private フィールドではなく、TypeScript の private を使用します
• class-no-static-containers - 静的メンバーのみを持つコンテナークラスを避けます
• class-constructor-parens - コンストラクターの呼び出しでは必ず括弧を使用します
• class-no-prototype-manipulation - プロトタイプを直接操作してはいけません

4. 関数パターン（高）

• func-declarations-over-expressions - 関数式より関数宣言を優先する
• func-arrow-concise-bodies - 適切な場合は簡潔なアロー関数の本体を使用する
• func-avoid-this-rebinding - this の再バインドを避ける
• func-rest-parameters - arguments よりレストパラメーターを使用する
• func-generator-syntax - 正しいジェネレーター関数の構文を使用する
• func-default-parameters - デフォルトパラメーターは控えめに使用する

5. 制御フロー（中～高）

• control-always-use-braces - 制御構文では常に波括弧を使用する
• control-triple-equals - 常に厳密等価演算子を使用する
• control-for-of-iteration - 配列には for-in より for-of を優先する
• control-switch-default - switch には常に default ケースを含める
• control-no-assignment-in-condition - 条件式での代入を避ける

6. エラー処理（中）

• error-throw-errors - 常に Error インスタンスをスローする
• error-catch-unknown - catch 節の変数の型を unknown にする
• error-empty-catch-comments - 空の catch ブロックには説明を記載する
• error-avoid-assertions - 型アサーションと非 null アサーションを避ける

7. 命名とスタイル（中）

• naming-identifier-styles - 正しい識別子の命名スタイルを使用する
• naming-descriptive-names - 内容がわかる名前を使用する
• naming-no-decorative-underscores - 装飾目的のアンダースコアを避ける
• naming-no-interface-prefix - インターフェース名に I 接頭辞を付けない
• naming-constants - 真の定数には CONSTANT_CASE を使用する

8. リテラルと型変換（低～中）

• literal-single-quotes - 文字列にはシングルクォートを使用する
• literal-number-formats - 正しい数値リテラル形式を使用する
• literal-explicit-coercion - 明示的な型変換を使用する
• literal-array-constructor - Array コンストラクターを避ける

使用方法

詳しい説明とコード例については、各リファレンスファイルをお読みください。

• セクションの定義 - カテゴリー構成と影響度
• ルールテンプレート - 新しいルールを追加するためのテンプレート

リファレンスファイル

ファイル	説明
AGENTS.md	すべてのルールをまとめた完全なガイド
references/_sections.md	カテゴリーの定義と順序
assets/templates/_template.md	新しいルール用のテンプレート
metadata.json	バージョンとリファレンス情報