// ✅ 好的代码
// FetchUser retrieves user information from the database.
// Returns ErrUserNotFound if the user doesn't exist.
func FetchUser(ctx context.Context, userID string) (*User, error) {
    if userID == "" {
        return nil, fmt.Errorf("userID cannot be empty")
    }

    // Implementation...
    return user, nil
}

// ❌ 不好的代码
func fetch(id string) *User {
    // 缺少注释、错误处理、类型清晰度
    return db.Get(id)
}

// 单元测试示例
func TestFetchUser(t *testing.T) {
    ctx := context.Background()

    // 测试正常情况
    user, err := FetchUser(ctx, "user-123")
    if err != nil {
        t.Fatalf("FetchUser failed: %v", err)
    }
    if user.ID != "user-123" {
        t.Errorf("user.ID = %s, want user-123", user.ID)
    }

    // 测试错误情况
    _, err = FetchUser(ctx, "")
    if err == nil {
        t.Error("FetchUser should return error for empty userID")
    }
}

# 运行所有测试
go test ./...

# 运行特定包的测试
go test ./pkg/agent

# 带覆盖率
go test -cover ./...

# 详细输出
go test -v ./...

# 格式: <type>: <subject>

# Type 类型:
# feat: 新功能
# fix: Bug 修复
# docs: 文档更新
# refactor: 代码重构
# test: 测试相关
# chore: 构建/工具相关

# 示例:
git commit -m "feat: add support for Gemini provider"
git commit -m "fix: resolve memory leak in event bus"
git commit -m "docs: update quickstart guide"

# 推送到你的 Fork
git push origin feature/your-feature-name

# 在 GitHub 上创建 Pull Request
# 1. 访问你的 Fork 仓库
# 2. 点击 "Compare & pull request"
# 3. 填写 PR 描述

## 描述

简要说明这个 PR 做了什么

## 相关 Issue

Closes #123

## 改动类型

- [ ] Bug 修复
- [ ] 新功能
- [ ] 破坏性变更
- [ ] 文档更新

## 测试

描述如何测试这些改动

## 检查清单

- [ ] 代码遵循项目规范
- [ ] 添加了必要的测试
- [ ] 测试全部通过
- [ ] 更新了相关文档
- [ ] Commit 信息清晰