lang-typescript について
lang-typescriptは、TypeScriptのコーディング指針を適用するスキルです。厳格な型付けを重視し、具体的な変更の作成と検証を進めます。
主な機能
- 01strictモードとnullチェック
- 02型アサーションより判別可能なユニオン
- 03unknownと型ガードの優先
- 04対象範囲に基づくスキル選択
- 05制約に沿った出力検証
活用シーン
- 01危険なanyの使用の置き換え
- 02モジュールへのTypeScript指針の適用
- 03タスクとスキル範囲の照合
- 04明示的な条件に沿った出力の改善
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ ravnhq/ ai-toolkit --skill lang-typescriptインストール後、Claude Code で/lang-typescriptを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
rules/_sections.mdexport-named-only.mdprefer-async-await.mdtype-discriminated-unions.mdtype-no-any.mdtype-no-assertions.md詳細
原則
- strict モードを有効にします。暗黙の any と厳密な null チェックを使用します
- 型アサーションよりも判別可能なユニオンを優先します
anyよりunknownを使用し、型ガードで型を絞り込みます
ルール
詳しいパターンについては、ルールのインデックスを参照してください。
例
該当する例
ユーザー:「このモジュール内の安全でない any の使用を、判別可能なユニオンに置き換えてください。」
期待される動作:lang-typescript のガイダンスを使用し、そのワークフローに従って、実行可能な出力を返します。
該当しない例
ユーザー:「新しいバックエンド向けに、REST ルートの命名規則を設計してください。」
期待される動作:lang-typescript を優先せず、より関連性の高いスキルを選ぶか、スキルを使用せずに進めます。
トラブルシューティング
スキルが起動しない
- エラー:期待どおりにスキルが選択されません。
- 原因:リクエストの表現が、説明にある起動条件に明確に一致していません。
- 解決策:説明にある分野やタスクのキーワードを明示して言い換え、再試行してください。
ガイダンスが別のスキルと競合する
- エラー:1 つのタスクで複数のスキルの指示が競合します。
- 原因:読み込まれたスキルの適用範囲が重複しています。
- 解決策:現在の手順でどのスキルを優先するかを明示し、そのワークフローを先に適用してください。
出力が抽象的すぎる
- エラー:結果に具体的で実行可能な詳細が不足しています。
- 原因:タスクの入力に、コンテキスト、制約、または対象の形式が含まれていません。
- 解決策:具体的な制約(環境、範囲、形式、成功条件)を追加して再実行してください。
ワークフロー
- リクエストが
lang-typescriptの適用範囲と起動条件に明確に一致するか確認します。 - スキルのルールと参照先のガイダンスを適用し、具体的な結果を作成します。
- 制約に照らして出力の品質を検証し、不足があれば、明示的な前提を置いて一度だけ改善します。
コメント
Markdown 対応