# auto-agent-demo

**Repository Path**: myuwei/auto

## Basic Information

- **Project Name**: auto-agent-demo
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-18
- **Last Updated**: 2026-05-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HTML 幻灯片多智能体开发系统

> 已验证可行的多 Agent 协作方案，作为 auto-agent-demo 重启时的架构参考。

## 项目定位

本项目研究 Claude Code 的多 Agent 协作能力，通过 HTML 幻灯片开发场景验证了一套完整的"主 Agent 调度 + 子 Agent 执行"的工作流。

## 架构概览

```
主智能体（编排者）- 只调度不干活
├── dg-planner      - 计划与基础设施工程师
├── dg-slide-dev    - 开发工程师
├── dg-slide-tester-layout    - 布局测试工程师
├── dg-slide-tester-beauty    - 美观测试工程师
└── dg-slide-tester-animation - 动画测试工程师
```

## 核心设计原则

1. **主 Agent 只调度不干活** — 不直接编辑代码，避免上下文膨胀
2. **子 Agent 职责单一** — 每个 Agent 只负责一个维度，便于验证和测试
3. **测试报告只提取判定** — 主 Agent 用 Grep 提取 PASS/FAIL，不读完整报告
4. **Agent ID 复用** — 修正循环中 resume 同一个 Agent，保证闭环

## 工作流程

```
Phase 1: 计划
  └── dg-planner → 产出 dev-plan.md、page-design-guide.md、index.html

Phase 2: 批量开发循环（每批 N 页）
  ├── dg-slide-dev → 开发本批页面
  ├── 3 个测试 Agent 并发测试（布局/美观/动画）
  └── 修正循环（≤3 轮）：resume 同一个 dev + 测试 Agent

Phase 3: 收尾
  └── 统计报告
```

## 文件结构

```
auto/
├── README.md                          # 本文件
├── CLAUDE.md                          # Claude Code 项目配置
├── 主智能体提示词.md                    # 主 Agent 完整提示词
├── agents/
│   ├── dg-planner.md                  # 计划 Agent 配置
│   ├── dg-slide-dev.md                # 开发 Agent 配置
│   ├── dg-slide-tester-layout.md      # 布局测试 Agent 配置
│   ├── dg-slide-tester-beauty.md      # 美观测试 Agent 配置
│   └── dg-slide-tester-animation.md   # 动画测试 Agent 配置
└── 笔记-非最新仅参考-多智能体协同-长时工作设计.md
```

## Agent 配置说明

| Agent | 职责 | 工具 |
|-------|------|------|
| dg-planner | 读取素材、制定开发计划、搭建基础设施 | Read, Write, Bash, Glob, Grep |
| dg-slide-dev | 按设计指南开发页面、修正测试问题 | Read, Edit, Write, Bash, Glob, Grep |
| dg-slide-tester-layout | 测试页面布局合理性 | Read, Bash, Glob, Grep |
| dg-slide-tester-beauty | 测试页面视觉美观度 | Read, Bash, Glob, Grep |
| dg-slide-tester-animation | 测试页面动画效果 | Read, Bash, Glob, Grep |

## 关键机制

### Agent ID 收集

修正循环必须 resume 同一个子 Agent。通过文件系统探测获取 Agent ID：

```bash
find ~/.claude/projects/ -name "agent-*.meta.json" -type f -printf '%T@ %p\n' | sort -rn | head -1
```

### 批量开发

- 默认 BATCH_SIZE=1（单页），用户可指定
- 开发 N 页时，测试也是 3 个 Agent 各测 N 页
- 测试并发上限始终为 3（layout/beauty/animation 各一个）

### 修正循环

- 最多 3 轮修正
- 每轮 resume 同一个 dev Agent 和对应的测试 Agent
- 3 轮后仍 FAIL 标记为 ⚠️ 低质量通过

## 使用场景

适用于需要批量产出高质量 HTML 内容的场景：
- 演示文稿/PPT 转 HTML 幻灯片
- 产品介绍页
- 教学课件
- 数据可视化报告

## 相关项目

| 项目 | 路径 | 说明 |
|------|------|------|
| auto-agent-demo | `../auto-agent-demo` | 实战项目（v3.0 重启） |
| auto-agent-demo2（本项目） | `.` | 参考项目 |

## 验证结果

本架构已在以下条件下验证通过：
- 17 页 HTML 幻灯片开发
- 三维质量测试（布局/美观/动画）
- 批量开发 + 修正循环完整闭环

---

*最后更新: 2026-05-18*