Agent Skills: TypeScript セットアップ

プロジェクトに TypeScript 環境をセットアップします。typescript(ネイティブコンパイラ)のインストール、適切な @tsconfig/bases の選定と tsconfig.json への反映、package.json への typecheck スクリプト追加、CI への typecheck ジョブ追加を行います。TypeScript のセットアップを求められたときに使用してください。

UncategorizedID: p-chan/dotfiles/personal-setup-typescript

Install this agent skill to your local

pnpm dlx add-skill https://github.com/p-chan/dotfiles/tree/HEAD/home/.agents/skills/personal-setup-typescript

Skill Files

Browse the full folder contents for personal-setup-typescript.

Download Skill

Loading file tree…

home/.agents/skills/personal-setup-typescript/SKILL.md

Skill Metadata

Name
personal-setup-typescript
Description
プロジェクトに TypeScript 環境をセットアップします。typescript(ネイティブコンパイラ)のインストール、適切な @tsconfig/bases の選定と tsconfig.json への反映、package.json への typecheck スクリプト追加、CI への typecheck ジョブ追加を行います。TypeScript のセットアップを求められたときに使用してください。

TypeScript セットアップ

対象

npm/yarn/pnpm/bun のいずれかを使うプロジェクトを対象とする。 Deno は独自の TypeScript ツールチェイン(deno check)を持ち、jsr:/npm:/https:// などの Deno 固有のモジュール指定子を tsc が解決できないため、このスキルの対象外とする。

ワークフロー

  1. パッケージマネージャー(とモノレポ構成)の検出
  2. typescript のインストール
  3. tsconfig を分割するか判断し、該当するパターンに従う
  4. CI への typecheck ジョブ追加

1. パッケージマネージャー(とモノレポ構成)の検出

プロジェクトの packageManager フィールドやロックファイルから npm/yarn/pnpm/bun を検出する。 以降のインストールはすべてこのパッケージマネージャーで行う。

package.jsonworkspaces フィールドや pnpm-workspace.yaml などがあればモノレポと判断し、パッケージ一覧を検出する。 モノレポの場合の追加の考慮事項は references/monorepo.md にまとめてあり、以降の手順とパターンは各パッケージに対して適用する。

2. typescript のインストール

typescript の最新バージョンを devDependencies としてインストールする。

typescript パッケージの tsc コマンドの実体は typescript-go 由来のネイティブコンパイラであり、コマンド名自体は従来と変わらず tsc のままである(tsgo/@typescript/native-preview は nightly 版向けのパッケージ名であり、通常導線では使わない)。

モノレポの場合はルートに1回だけインストールし、全パッケージで共有する(詳細は references/monorepo.md)。

3. tsconfig を分割するか判断

プロジェクト内に、アプリケーションのソースコード(例: src/)とは異なる実行環境で動く TypeScript ファイルがあるか確認する。 典型例は、ブラウザ向けにビルドされる src とは別に、Node.js 上で直接実行されるビルドツールの設定ファイル(vite.config.tsvitest.config.ts など)が存在するケースである。 たとえば Vite の公式テンプレートは、この理由で tsconfig を分割している。

モノレポの場合は、検出した各パッケージについてこの判断を行う。

判断できたら、該当するパターンに従う。

4. CI への typecheck ジョブ追加

references/ci.md に従う。