# ai-coding-poc

**Repository Path**: basement-3/ai-coding-poc

## Basic Information

- **Project Name**: ai-coding-poc
- **Description**: ai-coding-poc
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-11
- **Last Updated**: 2026-06-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Coding Tools POC

## 项目背景

随着 AI 辅助编程工具的快速发展，国内主流厂商纷纷推出各自的 AI Coding 产品。为了客观评估各工具在实际项目中的表现，本项目以 [智能运维-统一运维网关（OpsGateway）架构设计文档](docs/prd/ops-gateway-prd.md) 为统一测试案例，对以下三款 AI Coding 工具进行横向对比评测。

## 评测工具

| 工具 | 所属厂商 | 分支 |
|------|----------|------|
| **Qoder（通义灵码）** | 阿里巴巴 | `feature/qoder-poc` |
| **Trae** | 字节跳动 | `feature/trae-poc` |
| **CodeBuddy** | 腾讯 | `feature/codebuddy-poc` |

## 测试案例

以 `docs/prd/ops-gateway-prd.md` 作为统一输入，要求各 AI Coding 工具基于该 PRD 文档完成 **统一运维网关（OpsGateway）** 的代码实现。

### 案例说明

- **项目类型**: Spring Cloud Gateway 微服务网关
- **技术栈**: Java + Spring Boot + Spring Cloud Gateway + WebFlux
- **核心模块**: 认证过滤器、授权过滤器、请求处理器、路由转发器、审计日志器
- **外部依赖**: 一事通 JWT 认证、权限服务、日志数据库

详见 [PRD 文档](docs/prd/ops-gateway-prd.md)。

## 评测维度

### 1. 计划完整度

评估 AI 工具在编码前对需求的理解和规划能力：

- 是否能正确识别并分解需求模块
- 是否制定了合理的实现步骤
- 对技术栈和架构的理解是否与 PRD 一致

### 2. 任务完成时间

从输入 PRD 到产出完整代码的总耗时：

- 首次生成时间
- 修正/迭代轮次
- 人工干预程度

### 3. 对话轮次与手工干预

评估在开发过程中与 AI 的交互成本及效率：

- 对话交互轮次 (Turns)
- 人工修改代码行数 (Manual Edits)
- 报错自愈轮次 (Self-Healing)

### 4. 代码质量

对生成代码的质量进行多维度评估：

- **编码规范**: 命名、注释、格式化是否符合 Java 规范
- **架构设计**: 模块划分是否清晰、是否符合 PRD 设计
- **错误处理**: 异常处理是否完善
- **安全性**: 是否有明显安全漏洞
- **可维护性**: 代码可读性、可扩展性

### 5. 功能完成度

对照 PRD 检查功能的实现程度：

- 认证过滤器 → JWT 验签、用户信息提取
- 授权过滤器 → 权限码校验、本地缓存
- 请求处理器 → Token 添加、用户上下文传递
- 路由转发器 → 静态路由配置
- 审计日志器 → 异步日志记录
- 配置管理 → YAML 配置

## 评测流程

```
PRD 文档输入 → AI 工具编码 → 代码产出 → 多维度评分 → 对比报告
```

1. 切换到对应工具的分支
2. 使用该工具基于 `docs/prd/ops-gateway-prd.md` 完成编码
3. 记录评测数据到分支内的 `EVALUATION.md`
4. 汇总到 `master` 分支的对比报告中

## 分支策略

```
master                    ← 项目文档 & 最终对比报告
  ├── feature/qoder-poc    ← 通义灵码 POC 代码 & 评测记录
  ├── feature/trae-poc     ← Trae POC 代码 & 评测记录
  └── feature/codebuddy-poc ← CodeBuddy POC 代码 & 评测记录
```

每个工具分支独立维护，互不干扰，便于独立评测和对比。

## 评测记录模板

每个工具分支需包含 `EVALUATION.md`，记录以下信息：

```markdown
# [工具名称] 评测记录

## 测试环境
- 工具版本:
- IDE/编辑器:
- 模型版本:
- 测试日期:

## 评测数据
- 计划完整度: [评分/5]
- 任务完成时间: [首次生成时间分钟 / 调试完成总时间分钟]
- 对话交互轮次: [次数]
- 人工修改行数: [行数]
- 报错自愈轮次: [次数]

## 代码质量
- 编码规范: [评分/5]
- 架构设计: [评分/5]
- 错误处理: [评分/5]
- 安全性: [评分/5]
- 可维护性: [评分/5]

## 功能完成度
- [ ] 认证过滤器
- [ ] 授权过滤器
- [ ] 请求处理器
- [ ] 路由转发器
- [ ] 审计日志器
- [ ] 配置管理

## 综合评价
[文字评价]
```

## 仓库信息

- **GitHub**: [GinsanZhang/ai-redacotr](https://github.com/GinsanZhang/ai-redacotr)
- **Gitee**: [basement-3/ai-coding-poc](https://gitee.com/basement-3/ai-coding-poc)