mirror of
https://github.com/sweetwisdom/everything-claude-code-zh.git
synced 2026-03-22 14:40:14 +00:00
82 lines
2.0 KiB
Markdown
82 lines
2.0 KiB
Markdown
---
|
||
description: Fix Go build errors, go vet warnings, and linter issues incrementally. Invokes the go-build-resolver agent for minimal, surgical fixes.
|
||
---
|
||
|
||
# Go 建置與修復
|
||
|
||
此指令呼叫 **go-build-resolver** Agent，以最小變更增量修復 Go 建置錯誤。
|
||
|
||
## 此指令的功能
|
||
|
||
1. **執行診斷**：執行 `go build`、`go vet`、`staticcheck`
|
||
2. **解析錯誤**：依檔案分組並依嚴重性排序
|
||
3. **增量修復**：一次一個錯誤
|
||
4. **驗證每次修復**：每次變更後重新執行建置
|
||
5. **報告摘要**：顯示已修復和剩餘的問題
|
||
|
||
## 何時使用
|
||
|
||
在以下情況使用 `/go-build`：
|
||
- `go build ./...` 失敗並出現錯誤
|
||
- `go vet ./...` 報告問題
|
||
- `golangci-lint run` 顯示警告
|
||
- 模組相依性損壞
|
||
- 拉取破壞建置的變更後
|
||
|
||
## 執行的診斷指令
|
||
|
||
```bash
|
||
# 主要建置檢查
|
||
go build ./...
|
||
|
||
# 靜態分析
|
||
go vet ./...
|
||
|
||
# 擴展 linting（如果可用）
|
||
staticcheck ./...
|
||
golangci-lint run
|
||
|
||
# 模組問題
|
||
go mod verify
|
||
go mod tidy -v
|
||
```
|
||
|
||
## 常見修復的錯誤
|
||
|
||
| 錯誤 | 典型修復 |
|
||
|------|----------|
|
||
| `undefined: X` | 新增 import 或修正打字錯誤 |
|
||
| `cannot use X as Y` | 型別轉換或修正賦值 |
|
||
| `missing return` | 新增 return 陳述式 |
|
||
| `X does not implement Y` | 新增缺少的方法 |
|
||
| `import cycle` | 重組套件 |
|
||
| `declared but not used` | 移除或使用變數 |
|
||
| `cannot find package` | `go get` 或 `go mod tidy` |
|
||
|
||
## 修復策略
|
||
|
||
1. **建置錯誤優先** - 程式碼必須編譯
|
||
2. **Vet 警告次之** - 修復可疑構造
|
||
3. **Lint 警告第三** - 風格和最佳實務
|
||
4. **一次一個修復** - 驗證每次變更
|
||
5. **最小變更** - 不要重構，只修復
|
||
|
||
## 停止條件
|
||
|
||
Agent 會在以下情況停止並報告：
|
||
- 3 次嘗試後同樣錯誤仍存在
|
||
- 修復引入更多錯誤
|
||
- 需要架構變更
|
||
- 缺少外部相依性
|
||
|
||
## 相關指令
|
||
|
||
- `/go-test` - 建置成功後執行測試
|
||
- `/go-review` - 審查程式碼品質
|
||
- `/verify` - 完整驗證迴圈
|
||
|
||
## 相關
|
||
|
||
- Agent：`agents/go-build-resolver.md`
|
||
- 技能：`skills/golang-patterns/`
|