build-fix

ビルド修正スキル

リファクタリングはせず、コードの変更を最小限に抑えて、ビルドやコンパイルのエラーをすばやく修正します。ビルドを成功させます。

使用するタイミング

このスキルは、次の場合に有効になります。

• ユーザーが「ビルドを修正して」「ビルドが壊れている」と言ったとき
• TypeScript のコンパイルが失敗したとき
• ビルドコマンドや型チェッカーがエラーを報告したとき
• ユーザーがエラーの「最小限の修正」を依頼したとき

機能

build-fixer エージェント（Sonnet モデル）に処理を委任し、次を実行します。

1. エラーを収集

   • プロジェクトの型チェックコマンド（例：tsc --noEmit、mypy、cargo check、go vet）を実行します
   • または、プロジェクトのビルドコマンドを実行してビルドエラーを取得します
   • エラーを種類と重大度ごとに分類します

2. 方針に沿って修正

   • 不足している型注釈を追加します
   • 必要な箇所に null チェックを追加します
   • インポート／エクスポート文を修正します
   • モジュール解決の問題を解決します
   • ビルドを妨げているリンターエラーを修正します

3. 差分を最小限に抑える方針

   • 関係のないコードのリファクタリングは行いません
   • アーキテクチャの変更は行いません
   • パフォーマンスの最適化は行いません
   • ビルドを成功させるために必要な変更のみ行います

4. 検証

   • 修正のたびにプロジェクトの型チェックコマンドを実行します
   • 新たなエラーが発生していないことを確認します
   • ビルドが成功したら終了します

エージェントへの委任

Task(
  subagent_type="oh-my-claudecode:build-fixer",
  model="sonnet",
  prompt="BUILD FIX TASK

Fix all build and TypeScript errors with minimal changes.

Requirements:
- Run tsc/build to collect errors
- Fix errors one at a time
- Verify each fix doesn't introduce new errors
- NO refactoring, NO architectural changes
- Stop when build passes

Output: Build error resolution report with:
- List of errors fixed
- Lines changed per fix
- Final build status"
)

停止条件

build-fixer エージェントは、次の場合に停止します。

• 型チェックコマンドが終了コード 0 を返した
• ビルドコマンドが正常に完了した
• 新たなエラーが発生していない

出力形式

BUILD FIX REPORT
================

Errors Fixed: 12
Files Modified: 8
Lines Changed: 47

Fixes Applied:
1. src/utils/validation.ts:15 - Added return type annotation
2. src/components/Header.tsx:42 - Added null check for props.user
3. src/api/client.ts:89 - Fixed import path for axios
...

Final Build Status: ✓ PASSING
Verification: [type check command] (exit code 0)

ベストプラクティス

• 修正は一度に1つ — 検証やデバッグが容易になります
• 変更は最小限に — 修正中にリファクタリングしないでください
• 理由を記録する — 自明でない修正にはコメントを付けてください
• 修正後にテストする — テストが引き続き成功することを確認してください

他のスキルとの併用

包括的な修正を行うには、他のスキルと組み合わせます。

Ultrawork との併用：

/ultrawork fix all build errors

異なるファイルに対して、複数の build-fixer エージェントを並行して起動します。

Ralph との併用：

/ralph fix the build

複数回の反復が必要な場合でも、ビルドが成功するまで試行を続けます。

Pipeline との併用：

/pipeline debug "build is failing"

explore → architect → build-fixer のワークフローを使用します。