# TS Dev

> TypeScriptフロントエンド開発の標準手順。Use when Codex creates, changes, reviews, or sets up TypeScript frontend projects, including Vite/Vite Plus, React UI choices, .gitignore creation, Oxlint/Oxfmt rules, tsgo type checking, lint/format/test configuration, pre-commit hooks, GitHub Actions CI, Playwright UI/E2E tests, and vulnerable package update workflows.

- Skill: `k5-mot/ts-dev` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add k5-mot/ts-dev`
- Raw SKILL.md: https://api.skillmd.com/api/skills/k5-mot/ts-dev/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: k5-mot (https://skillmd.com/u/k5-mot)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/k5-mot/ts-dev

---


# TS Dev

TypeScriptフロントエンドを実装・修正・初期化するときは、このSkillをプロジェクト標準として使う。既存プロジェクトでは既存のUIライブラリ、ビルド設定、CI、テスト構成を優先し、不足している標準だけを足す。

## 工程別リファレンス

作業内容に応じて、必要なreferenceを先に読む。

- 新規作成、依存追加、UI基盤選定: [setup.md](references/setup.md)
- TypeScript向けフル版 `.gitignore` テンプレート: [full.gitignore](references/full.gitignore)
- Vite+ / `vp` の利用、検証、トラブルシュート: [vite-plus.md](references/vite-plus.md)
- 実装、JSDoc/TSDoc、コメント、公開ユーティリティ: [implementation.md](references/implementation.md)
- Oxlint/Oxfmt/tsgo設定、推奨lintルール、既存設定への反映: [lint-rules.md](references/lint-rules.md)
- pre-commit、テスト、Playwright、脆弱性更新、GitHub Actions: [verification.md](references/verification.md)

今後ルールを増やす場合は、詳細を工程別referenceへ追加し、`SKILL.md` には参照先と適用タイミングだけを書く。

## 常時適用

- 関数・コンポーネント・公開ユーティリティにはJSDoc/TSDocを書く。目的、引数、戻り値を説明し、例外や副作用がある場合も書く。
- コメントを書く場合は日本語で、コードの逐語説明ではなく理由や注意点を書く。
- public utilityの振る舞いを変えた場合は `docs/` に利用方法や変更点を残す。
- UI/E2Eテストは Playwright を使う。
- Git hookは `pre-commit` を使い、huskyは使わない。

## 反映手順

1. 該当工程のreferenceを読む。
2. 既存プロジェクトの設定と衝突する場合は、既存の意図を保ったうえで差分導入する。
3. Vite+ プロジェクトでは、必ず [vite-plus.md](references/vite-plus.md) の `vp` 前提を確認してからコマンドを選ぶ。
4. Oxlint/Oxfmt/tsgo設定を作成・変更する場合は、必ず [lint-rules.md](references/lint-rules.md) の推奨ルールとCLI実行経路を確認し、採用・見送りの理由が分かる形で設定へ反映する。
5. 変更後は [verification.md](references/verification.md) の軽量チェックを実行し、実行できないものは理由を残す。