Skip to content

Commit c9b05b1

Browse files
authored
docs(agents): update setup-typescript skill for TypeScript 7.0 GA (#510)
* docs(agents): update setup-typescript skill for TypeScript 7.0 GA TypeScript 7.0 has been officially released (npm latest tag now points to 7.0.2), so the RC-specific `@rc` tag install and version-conditional phrasing ("TypeScript 7 では", "TypeScript 6 以前は") are no longer needed. * docs(agents): drop version number from setup-typescript description Hardcoding "TypeScript 7" would go stale once TypeScript 8 ships, since this skill always installs the latest version.
1 parent ab4baec commit c9b05b1

3 files changed

Lines changed: 5 additions & 9 deletions

File tree

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

Lines changed: 3 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: personal-setup-typescript
3-
description: プロジェクトに TypeScript 環境をセットアップします。typescript(TypeScript 7 RC のネイティブコンパイラ)のインストール、適切な @tsconfig/bases の選定と tsconfig.json への反映、package.json への typecheck スクリプト追加、CI への typecheck ジョブ追加を行います。TypeScript のセットアップを求められたときに使用してください。
3+
description: プロジェクトに TypeScript 環境をセットアップします。typescript(ネイティブコンパイラ)のインストール、適切な @tsconfig/bases の選定と tsconfig.json への反映、package.json への typecheck スクリプト追加、CI への typecheck ジョブ追加を行います。TypeScript のセットアップを求められたときに使用してください。
44
---
55

66
# TypeScript セットアップ
@@ -27,13 +27,9 @@ Deno は独自の TypeScript ツールチェイン(`deno check`)を持ち、
2727

2828
## 2. typescript のインストール
2929

30-
`typescript` `rc` タグ(TypeScript 7 RC)で devDependencies としてインストールする。
30+
`typescript` の最新バージョンを devDependencies としてインストールする。
3131

32-
```
33-
typescript@rc
34-
```
35-
36-
TypeScript 7 RC 以降、[typescript-go](https://github.com/microsoft/typescript-go) 由来のネイティブコンパイラが標準の `typescript` パッケージに統合されており、CLI コマンド名は `tsc` である(`tsgo`/`@typescript/native-preview` は nightly 版向けのパッケージ名であり、RC 以降の通常導線では使わない)。
32+
`typescript` パッケージの `tsc` コマンドの実体は [typescript-go](https://github.com/microsoft/typescript-go) 由来のネイティブコンパイラであり、コマンド名自体は従来と変わらず `tsc` のままである(`tsgo`/`@typescript/native-preview` は nightly 版向けのパッケージ名であり、通常導線では使わない)。
3733

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

home/.agents/skills/personal-setup-typescript/patterns/split-tsconfig.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@
4848
}
4949
```
5050

51-
TypeScript 7 では `types` の既定値が `[]` であり、`@types` パッケージは明示的に列挙しない限り読み込まれない(TypeScript 6 以前は `node_modules/@types` 配下の全パッケージを自動で読み込んでいた)
51+
`types` の既定値は `[]` であり、`@types` パッケージは明示的に列挙しない限り読み込まれない。
5252
そのため、他のサブ設定ファイルのために `@types/node` をインストールしても、この設定(ブラウザ向け)に意図せず混入することはない。
5353
ただし、この設定でブラウザ向けのアンビエント型(例: `vite/client`)が必要な場合は、選定したベースが `types` を含んでいなければ(`@tsconfig/vite-react``"types": ["vite/client"]` のように含むベースもある)、この設定側にも `types` を明示する必要がある。
5454

home/.agents/skills/personal-setup-typescript/references/types-node.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
対象の tsconfig ファイルが Node.js の API(`process``Buffer``fs` など)に触れる場合、`@types/node` を devDependencies としてインストールし、その tsconfig ファイルの `compilerOptions.types``"node"` を追加する。
44
どのベースを選んだかではなく、実際にそのファイルが Node.js 上で動くかどうかで判断する。
55

6-
TypeScript 7 では `types` の既定値が `[]` になり`node_modules/@types` 配下のパッケージは自動読み込みされなくなった(TypeScript 6 以前は自動で全パッケージを読み込んでいた)。そのため `@types/node` のインストールだけでは不十分で、`compilerOptions.types` への明示的な追加が必須になる。
6+
`types` の既定値は `[]` であり`node_modules/@types` 配下のパッケージは自動読み込みされない。そのため `@types/node` のインストールだけでは不十分で、`compilerOptions.types` への明示的な追加が必須になる。
77

88
- `@tsconfig/bases` の Node.js バージョン別ベースや Node.js LTS 向けベースは `lib``module` などは設定するが `types` は含まないため、必ずこのインストールと `types` への追加が必要になる。
99
- Next.js、Remix、Nuxt のように SSR やサーバー処理を伴うフレームワーク固有のベースも、Node.js 上で動く部分があるため通常は必要になる(例: 公式の `create-next-app` は TypeScript プロジェクトで常に `@types/node` を追加している)。ベースが `types` を自前で設定している場合は、その配列に `"node"` を追加する。

0 commit comments

Comments
 (0)