File contents Build Fix
要約 : ビルドエラーを自動分類し、反復的な修正戦略で段階的に解決。
🔍 エラー分析 (REQ-BF-001)
WHEN ビルドエラー発生DO カテゴリ分類と優先度付け
カテゴリ
例
優先度
Type Error
TS2322, TS2339
🔴 高
Import Error
Module not found
🔴 高
Syntax Error
Unexpected token
🔴 高
Lint Error
ESLint errors
🟡 中
Config Error
tsconfig, webpack
🟡 中
Dependency
Version mismatch
🟢 低
分析出力
🔍 Build Error Analysis
━━━━━━━━━━━━━━━━━━━━━━
Total: 8 errors
By Category:
🔴 Type Error: 4 (High)
🔴 Import Error: 2 (High)
🟡 Lint Error: 2 (Medium)
Root Cause:
1. src/user.ts:45 - Missing 'email' property
→ Causes 2 downstream errors
Fix Order:
1. src/user.ts:45 (root cause)
2. Remaining may resolve automatically
🔄 修正ループ (REQ-BF-002)
WHILE ビルドエラーが存在 (最大10回)DO 以下のループを実行
1. エラーリスト取得
↓
2. Root Cause特定(影響範囲最大のエラー)
↓
3. 修正適用(1エラーに集中)
↓
4. ビルド再実行
↓
5. 結果確認
↓
エラーあり → 1へ戻る
優先順位
Root Cause First - 連鎖エラーの根本原因
Import/Module First - コンパイル阻害要因
Type Errors - 下流エラーの原因
Syntax Errors - 局所的だが致命的
Lint Errors - 最後に対応
📋 TypeScriptエラーリファレンス
コード
説明
解決策
TS2322
Type not assignable
型の修正/アサーション
TS2339
Property not exist
プロパティ追加/型定義修正
TS2345
Argument mismatch
引数の型修正
TS2304
Cannot find name
import追加/定義追加
TS2307
Module not found
パス修正/インストール
TS2531
Possibly null
nullチェック追加
📊 Fix Report (REQ-BF-003)
WHEN 修正完了DO レポート生成
🔧 Build Fix Report
━━━━━━━━━━━━━━━━━━━━━━━━
Iterations: 2
Errors Fixed: 8
Changes:
• src/user.ts (+5 -2)
• tsconfig.json (+1 -0)
Progress:
Iteration 1: 8 → 4 errors
Iteration 2: 4 → 0 errors
Status: ✅ Build successful
Remaining Warnings: 3
トレーサビリティ
REQ-BF-001: Build Error Analysis
REQ-BF-002: Iterative Fix Strategy
REQ-BF-003: Fix Report
1 --- 2 name: build-fix 3 description: Build Fix 4 license: MIT 5 --- 6 7 # Build Fix 8 9 > **要約**: ビルドエラーを自動分類し、反復的な修正戦略で段階的に解決。 10 11 ## 🔍 エラー分析 (REQ-BF-001) 12 13 **WHEN** ビルドエラー発生 14 **DO** カテゴリ分類と優先度付け 15 16 | カテゴリ | 例 | 優先度 | 17 |---------|-----|--------| 18 | **Type Error** | TS2322, TS2339 | 🔴 高 | 19 | **Import Error** | Module not found | 🔴 高 | 20 | **Syntax Error** | Unexpected token | 🔴 高 | 21 | **Lint Error** | ESLint errors | 🟡 中 | 22 | **Config Error** | tsconfig, webpack | 🟡 中 | 23 | **Dependency** | Version mismatch | 🟢 低 | 24 25 ### 分析出力 26 27 ``` 28 🔍 Build Error Analysis 29 ━━━━━━━━━━━━━━━━━━━━━━ 30 Total: 8 errors 31 32 By Category: 33 🔴 Type Error: 4 (High) 34 🔴 Import Error: 2 (High) 35 🟡 Lint Error: 2 (Medium) 36 37 Root Cause: 38 1. src/user.ts:45 - Missing 'email' property 39 → Causes 2 downstream errors 40 41 Fix Order: 42 1. src/user.ts:45 (root cause) 43 2. Remaining may resolve automatically 44 ``` 45 46 --- 47 48 ## 🔄 修正ループ (REQ-BF-002) 49 50 **WHILE** ビルドエラーが存在 (最大10回) 51 **DO** 以下のループを実行 52 53 ``` 54 1. エラーリスト取得 55 ↓ 56 2. Root Cause特定(影響範囲最大のエラー) 57 ↓ 58 3. 修正適用(1エラーに集中) 59 ↓ 60 4. ビルド再実行 61 ↓ 62 5. 結果確認 63 ↓ 64 エラーあり → 1へ戻る 65 ``` 66 67 ### 優先順位 68 69 1. **Root Cause First** - 連鎖エラーの根本原因 70 2. **Import/Module First** - コンパイル阻害要因 71 3. **Type Errors** - 下流エラーの原因 72 4. **Syntax Errors** - 局所的だが致命的 73 5. **Lint Errors** - 最後に対応 74 75 --- 76 77 ## 📋 TypeScriptエラーリファレンス 78 79 | コード | 説明 | 解決策 | 80 |--------|------|--------| 81 | TS2322 | Type not assignable | 型の修正/アサーション | 82 | TS2339 | Property not exist | プロパティ追加/型定義修正 | 83 | TS2345 | Argument mismatch | 引数の型修正 | 84 | TS2304 | Cannot find name | import追加/定義追加 | 85 | TS2307 | Module not found | パス修正/インストール | 86 | TS2531 | Possibly null | nullチェック追加 | 87 88 --- 89 90 ## 📊 Fix Report (REQ-BF-003) 91 92 **WHEN** 修正完了 93 **DO** レポート生成 94 95 ``` 96 🔧 Build Fix Report 97 ━━━━━━━━━━━━━━━━━━━━━━━━ 98 Iterations: 2 99 Errors Fixed: 8 100 101 Changes: 102 • src/user.ts (+5 -2) 103 • tsconfig.json (+1 -0) 104 105 Progress: 106 Iteration 1: 8 → 4 errors 107 Iteration 2: 4 → 0 errors 108 109 Status: ✅ Build successful 110 Remaining Warnings: 3 111 ``` 112 113 --- 114 115 ## トレーサビリティ 116 117 - REQ-BF-001: Build Error Analysis 118 - REQ-BF-002: Iterative Fix Strategy 119 - REQ-BF-003: Fix Report
nahisaho/musubix/tree/main/.github/skills/build-fix commit b80acf2fe7
Frequently asked questions How do I install the Build Fix skill? Run npx skillmds@latest add nahisaho/build-fix in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Build Fix skill do? Build Fix It is listed under Coding & Dev Tools on SkillMD.
Is Build Fix safe to use? This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Build Fix? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Build Fix free to use? Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.
Who published Build Fix? nahisaho (@nahisaho) published this skill. Their other Agent Skills are listed on their SkillMD profile.