k5-mot TS Dev
TypeScriptフロントエンドを実装・修正・初期化するときは、このSkillをプロジェクト標準として使う。既存プロジェクトでは既存のUIライブラリ、ビルド設定、CI、テスト構成を優先し、不足している標準だけを足す。
工程別リファレンス
作業内容に応じて、必要なreferenceを先に読む。
- 新規作成、依存追加、UI基盤選定: setup.md
- TypeScript向けフル版
.gitignoreテンプレート: full.gitignore - Vite+ /
vpの利用、検証、トラブルシュート: vite-plus.md - 実装、JSDoc/TSDoc、コメント、公開ユーティリティ: implementation.md
- Oxlint/Oxfmt/tsgo設定、推奨lintルール、既存設定への反映: lint-rules.md
- pre-commit、テスト、Playwright、脆弱性更新、GitHub Actions: verification.md
今後ルールを増やす場合は、詳細を工程別referenceへ追加し、SKILL.md には参照先と適用タイミングだけを書く。
常時適用
- 関数・コンポーネント・公開ユーティリティにはJSDoc/TSDocを書く。目的、引数、戻り値を説明し、例外や副作用がある場合も書く。
- コメントを書く場合は日本語で、コードの逐語説明ではなく理由や注意点を書く。
- public utilityの振る舞いを変えた場合は
docs/に利用方法や変更点を残す。 - UI/E2Eテストは Playwright を使う。
- Git hookは
pre-commitを使い、huskyは使わない。
反映手順
- 該当工程のreferenceを読む。
- 既存プロジェクトの設定と衝突する場合は、既存の意図を保ったうえで差分導入する。
- Vite+ プロジェクトでは、必ず vite-plus.md の
vp前提を確認してからコマンドを選ぶ。 - Oxlint/Oxfmt/tsgo設定を作成・変更する場合は、必ず lint-rules.md の推奨ルールとCLI実行経路を確認し、採用・見送りの理由が分かる形で設定へ反映する。
- 変更後は verification.md の軽量チェックを実行し、実行できないものは理由を残す。