build-fix

构建修复技能

以最小的代码改动快速修复构建和编译错误。在不重构的情况下让构建通过。

何时使用

此技能在以下情况激活：

• 用户说“修复构建”、“构建坏了”
• TypeScript 编译失败
• 构建命令或类型检查器报告错误
• 用户要求对错误进行“最小修复”

它能做什么

委托给 build-fixer Agent（Sonnet 模型）以：

1. 收集错误

   • 运行项目的类型检查命令（例如 tsc --noEmit、mypy、cargo check、go vet）
   • 或运行项目的构建命令以获取构建失败信息
   • 按类型和严重程度对错误分类

2. 策略性修复

   • 在缺失处添加类型注解
   • 在需要处添加空值检查
   • 修复 import/export 语句
   • 解决模块解析问题
   • 修复阻塞构建的 linter 错误

3. 最小差异策略

   • 不重构无关代码
   • 不做架构变更
   • 不做性能优化
   • 只做让构建通过所必需的事

4. 验证

   • 每次修复后运行项目的类型检查命令
   • 确保没有引入新错误
   • 构建通过时停止

Agent 委托

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 Agent 在以下情况停止：

• 类型检查命令以代码 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)

最佳实践

• 一次只修一处 - 更易于验证和调试
• 最小改动 - 修复时不要重构
• 记录原因 - 对不明显的修复添加注释
• 之后测试 - 确保测试仍然通过

与其他技能配合使用

与其他技能组合以实现全面修复：

与 Ultrawork 配合：

/ultrawork fix all build errors

为不同文件并行启动多个 build-fixer Agent。

与 Ralph 配合：

/ralph fix the build

持续尝试直到构建通过，即使需要多次迭代。

与 Pipeline 配合：

/pipeline debug "build is failing"

使用：explore → architect → build-fixer 工作流。