typescript-check

TypeScript 型チェックのワークフロー

トリガー

• "类型检查"
• "type-check"
• "tsc"
• "检查类型"

ワークフロー

Step 0: Node バージョンの調整（前提条件）

このスキルは dependencies を介して node-version-discipline に強く依存しています。tsc／型チェックのコマンドを実行する前に、プロジェクトで宣言されたバージョンに Node のバージョンを合わせてください（この依存関係は .nvmrc → .node-version → .tool-versions → volta → engines.node → CI 設定の順に全て確認し、宣言がない場合は推測せずにユーザーに確認します）。SOP に従ってバージョンを合わせないと、結果の信頼性が損なわれます（誤って成功／失敗と判定されます）。

以下の各コマンドの前に source ~/.nvm/nvm.sh && nvm use <version> >/dev/null 2>&1 && node -v && を付けてください（1 回の呼び出しで実行してください。シェルの状態は保持されません）。node-version-discipline を利用できない場合は、まずインストールしてください。機能を縮小して代用してはいけません。

Step 1: 適切なコマンドを検出する

次のコマンドを優先順位の高い順に試してください。

# Prefer project-configured scripts
if grep -q '"type-check"' package.json; then
    npm run type-check
elif grep -q '"check"' package.json; then
    npm run check
elif [ -f "tsconfig.json" ]; then
    npx tsc --noEmit
else
    echo "⚠️ No TypeScript configuration found"
fi

Step 2: 結果を報告する

チェックに合格した場合：

✅ TypeScript type check passed
- Node version (declared vX): ✅ aligned (note "user-specified" if no project declaration found)

チェックに失敗した場合：

❌ TypeScript type errors found:

file:xxx.ts:line:column - error description
file:yyy.tsx:line:column - error description

Total: N errors

Step 3: 修正案を提示する

エラーごとに、次の形式で修正案を提示してください。

### Error N: [brief description]

📍 Location: file:line

🔧 Fix:
[explain the fix approach]

Apply this fix? (wait for user confirmation)

重要：ユーザーの明示的な確認なしに修正を適用してはいけません。

Step 4: まとめて修正する

ユーザーの確認後、エラーを 1 つずつ、またはまとめて修正します。すべてのエラーが解消されるまで、修正のたびに型チェックを再実行してください。