mcpField
L
lang-typescript

lang-typescript

github.com/ravnhq開発1670 回インストール21 週間前に更新
リポジトリ

lang-typescript について

lang-typescriptは、TypeScriptのコーディング指針を適用するスキルです。厳格な型付けを重視し、具体的な変更の作成と検証を進めます。

主な機能

  1. 01strictモードとnullチェック
  2. 02型アサーションより判別可能なユニオン
  3. 03unknownと型ガードの優先
  4. 04対象範囲に基づくスキル選択
  5. 05制約に沿った出力検証

活用シーン

  1. 01危険なanyの使用の置き換え
  2. 02モジュールへのTypeScript指針の適用
  3. 03タスクとスキル範囲の照合
  4. 04明示的な条件に沿った出力の改善

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ravnhq/ai-toolkit --skill lang-typescript

インストール後、Claude Code で/lang-typescriptを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

rules/
_sections.md
export-named-only.md
prefer-async-await.md
type-discriminated-unions.md
type-no-any.md
type-no-assertions.md

詳細

原則

  • strict モードを有効にします。暗黙の any と厳密な null チェックを使用します
  • 型アサーションよりも判別可能なユニオンを優先します
  • any より unknown を使用し、型ガードで型を絞り込みます

ルール

詳しいパターンについては、ルールのインデックスを参照してください。

例

該当する例

ユーザー:「このモジュール内の安全でない any の使用を、判別可能なユニオンに置き換えてください。」

期待される動作:lang-typescript のガイダンスを使用し、そのワークフローに従って、実行可能な出力を返します。

該当しない例

ユーザー:「新しいバックエンド向けに、REST ルートの命名規則を設計してください。」

期待される動作:lang-typescript を優先せず、より関連性の高いスキルを選ぶか、スキルを使用せずに進めます。

トラブルシューティング

スキルが起動しない
  • エラー:期待どおりにスキルが選択されません。
  • 原因:リクエストの表現が、説明にある起動条件に明確に一致していません。
  • 解決策:説明にある分野やタスクのキーワードを明示して言い換え、再試行してください。
ガイダンスが別のスキルと競合する
  • エラー:1 つのタスクで複数のスキルの指示が競合します。
  • 原因:読み込まれたスキルの適用範囲が重複しています。
  • 解決策:現在の手順でどのスキルを優先するかを明示し、そのワークフローを先に適用してください。
出力が抽象的すぎる
  • エラー:結果に具体的で実行可能な詳細が不足しています。
  • 原因:タスクの入力に、コンテキスト、制約、または対象の形式が含まれていません。
  • 解決策:具体的な制約(環境、範囲、形式、成功条件)を追加して再実行してください。

ワークフロー

  1. リクエストが lang-typescript の適用範囲と起動条件に明確に一致するか確認します。
  2. スキルのルールと参照先のガイダンスを適用し、具体的な結果を作成します。
  3. 制約に照らして出力の品質を検証し、不足があれば、明示的な前提を置いて一度だけ改善します。

コメント