typescript-check

TypeScript 类型检查工作流

触发条件

• “类型检查”
• “type-check”
• “tsc”
• “检查类型”

工作流

步骤 0：Node 版本对齐（前置条件）

此技能通过 dependencies 强依赖 node-version-discipline。运行任何 tsc / type-check 命令前，请按照其 SOP 将 Node 版本与项目声明的版本对齐（该依赖会依次探查完整链路 .nvmrc → .node-version → .tool-versions → volta → engines.node → CI 配置；如果没有声明版本，则会询问用户，而不是猜测），否则结果不可信（可能错误地通过 / 未通过）。

以下每条命令前都添加 source ~/.nvm/nvm.sh && nvm use <version> >/dev/null 2>&1 && node -v && （单次调用——shell 状态不会持久保留）。如果 node-version-discipline 不可用，请先安装；不要降级处理。

步骤 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

步骤 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

步骤 3：提出修复方案

对于每个错误，请按以下格式提供修复方案：

### Error N: [brief description]

📍 Location: file:line

🔧 Fix:
[explain the fix approach]

Apply this fix? (wait for user confirmation)

重要：未经用户明确确认，绝不要应用任何修复。

步骤 4：批量修复

用户确认后，逐个或批量修复错误。每次修复后重新运行类型检查，直至解决所有错误。