peach-team

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Peach Agent Team

Overview

概述

PeachSolution 아키텍처에서 신규 기능 개발을 조율하는 통합 팀 스킬입니다.

기존

team-backend

team-ui

team-fullstack

를 하나로 통합하며, 역할별 페르소나와 체크리스트를 이 문서 안에 포함합니다.

这是在PeachSolution架构中协调新功能开发的集成团队技能。

它整合了原有的

team-backend

、

team-ui

、

team-fullstack

，并在本文档中包含了各角色的人设和检查清单。

Modes

模式

mode	용도	포함 역할
`backend`	기존 UI에 API + Store 연결	backend-dev, backend-qa, store-dev, frontend-qa
`ui`	Store 기반 UI만 구현	ui-dev, frontend-qa
`fullstack`	DB 스키마 기반 전체 생성	backend-dev, backend-qa, store-dev, ui-dev, frontend-qa

mode	用途	包含角色
`backend`	为现有UI连接API + Store	backend-dev, backend-qa, store-dev, frontend-qa
`ui`	仅基于Store实现UI	ui-dev, frontend-qa
`fullstack`	基于DB Schema实现整体生成	backend-dev, backend-qa, store-dev, ui-dev, frontend-qa

Preconditions

前置条件

DB 스키마가 필요한 모드(
```
backend
```
,
```
fullstack
```
)에서는
```
api/db/schema/[도메인]/[테이블].sql
```
이 존재해야 합니다.

ui

모드에서는

front/src/modules/[모듈명]/store/[모듈명].store.ts

가 존재해야 합니다.

Store가 없으면 먼저
```
peach-gen-store
```
, UI가 없으면
```
peach-gen-ui
```
를 기준으로 생성합니다.
기존 기능 수정 맥락에서 실행하는 경우
```
docs/기능별설명/{카테고리명}/{기능명}/
```
가 있으면 개요 → 로직 → 명세 → TDD 순으로 먼저 읽고 컨텍스트를 주입합니다.

需要DB Schema的模式（
```
backend
```
、
```
fullstack
```
）下，必须存在
```
api/db/schema/[领域]/[表].sql
```
文件。

ui

模式下，必须存在

front/src/modules/[模块名]/store/[模块名].store.ts

文件。

如果没有Store，则先基于
```
peach-gen-store
```
生成；如果没有UI，则先基于
```
peach-gen-ui
```
生成。
在修改现有功能的场景下执行时，若存在
```
docs/功能说明/{分类名}/{功能名}/
```
目录，则按概述→逻辑→规格→TDD的顺序先行读取并注入上下文。

Inputs

输入参数

bash

/peach-team [모듈명] mode=backend|ui|fullstack [옵션]

bash

/peach-team [模块名] mode=backend|ui|fullstack [选项]

공통 옵션

通用选项

model=sonnet|opus|haiku (서브에이전트 모델 override, 기본값: sonnet)

model=sonnet|opus|haiku (覆盖子Agent模型，默认值: sonnet)

figma=[URL]

ui=crud|page|two-depth|infinite-scroll|select-list

file=Y

excel=Y

storeTdd=Y

undefined

undefined

Orchestration

编排流程

0. 입력 검증

0. 输入验证

에이전트 팀 기능 활성화 확인

确认Agent团队功能启用

아래 명령으로

~/.claude/settings.json

에 에이전트 팀 플래그가 설정되어 있는지 확인합니다:

bash

cat ~/.claude/settings.json | grep -i "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS"

설정이 없거나

"1"

이 아니면 즉시 중단하고 다음 안내를 출력합니다:

⚠️  에이전트 팀 기능이 비활성화되어 있습니다.

~/.claude/settings.json에 아래 내용을 추가한 후 Claude Code를 재시작하세요:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

설정 가이드: https://github.com/peachSolution/peach-harness/blob/main/docs/06-에이전트팀-설정.md
공식 문서: https://code.claude.com/docs/ko/agent-teams

mode와 모듈명이 모두 지정되어야 다음 단계로 진행합니다. 누락된 경우 반드시 개발자에게 질문합니다.

mode 미지정 시:

mode를 선택해주세요:
1. backend — 기존 UI에 API + Store 연결
2. ui — Store 기반 UI만 구현
3. fullstack — DB 스키마 기반 전체 생성

모듈명 미지정 시:

모듈명을 입력해주세요 (예: notice-board, product-manage):

model 옵션:

미지정: 기본값 sonnet으로 모든 서브에이전트 실행
지정 시: 모든 서브에이전트를 해당 모델로 override
허용 값: sonnet, opus, haiku

通过以下命令检查

~/.claude/settings.json

中是否已设置Agent团队标志：

bash

cat ~/.claude/settings.json | grep -i "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS"

如果未设置或值不为

"1"

，则立即终止并输出以下提示：

⚠️  Agent团队功能未启用。

请在~/.claude/settings.json中添加以下内容后重启Claude Code：

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

设置指南: https://github.com/peachSolution/peach-harness/blob/main/docs/06-에이전트팀-설정.md
官方文档: https://code.claude.com/docs/ko/agent-teams

必须同时指定mode和模块名才能进入下一步。若有缺失，必须向开发者询问。

未指定mode时:

请选择mode:
1. backend — 为现有UI连接API + Store
2. ui — 仅基于Store实现UI
3. fullstack — 基于DB Schema实现整体生成

未指定模块名时:

请输入模块名（示例: notice-board, product-manage）:

model选项:

未指定: 默认使用sonnet模型运行所有子Agent
指定时: 所有子Agent均使用该模型覆盖默认设置
允许值: sonnet, opus, haiku

1. 환경 확인

1. 环境检查

bash

undefined

bash

undefined

스키마 / 타입 / 가이드 코드 확인

检查Schema / 类型 / 参考代码

ls api/db/schema/ head -5 api/src/modules/test-data/dao/test-data.dao.ts head -3 api/src/modules/test-data/controller/test-data.controller.ts ls front/src/modules/test-data/

DAO 라이브러리 감지

检测DAO库

from 'bunqldb' → 재할당 방식

from 'bunqldb' → 重分配方式

from 'sql-template-strings' → append 방식

from 'sql-template-strings' → append方式

modules 분리 구조 감지

检测模块分离结构

ls -d api/src/modules*/ ls -d front/src/modules*/

_common 구성 감지

检测_common构成

ls api/src/modules/_common/ ls api/src/modules/_common/constants/ 2>/dev/null

스킬 references 경로 감지

检测技能引用路径

SKILL_BASE=$(dirname "$(find ~/.claude ~/.agents -path "*/peach-gen-backend/references" -type d 2>/dev/null | head -1)" 2>/dev/null)

undefined

SKILL_BASE=$(dirname "$(find ~/.claude ~/.agents -path "*/peach-gen-backend/references" -type d 2>/dev/null | head -1)" 2>/dev/null)

undefined

1.5. 도메인 분석 (Analyze)

1.5. 领域分析 (Analyze)

오케스트레이터가 대상 도메인의 스키마를 읽고, test-data 대비 차이점을 파악한 뒤 서브에이전트 프롬프트에 컨텍스트로 주입합니다.

bash

undefined

编排器读取目标领域的Schema，对比test-data找出差异，然后将上下文注入子Agent的提示词中。

bash

undefined

대상 스키마 읽기

读取目标Schema

cat api/db/schema/[도메인]/[테이블].sql


**분석 항목**:
1. 스키마 비교: test-data 대비 필드 수, 타입 복잡도, 관계성
2. 비즈니스 로직 판단: 단순 CRUD vs 상태 전이/계산 필드/조건부 검증
3. 적응 결정: Must Follow → 그대로 / May Adapt → 도메인 맞춤 항목 식별

**분석 결과를 서브에이전트에게 전달**:
- 각 에이전트 생성 시 프롬프트에 "이 도메인의 특성: [분석 결과]"를 포함
- 모듈 생성 경로: `api/src/[감지된 modules 경로]/[모듈명]/`
- front 대응 경로: `front/src/[감지된 modules 경로]/[모듈명]/`
- _common 상수 목록: `[감지된 상수 파일 목록]` (존재 시 하드코딩 금지 지시)
- file 옵션 추론: 스키마에 파일 관련 요구가 보이면 `file=Y` 제안
- references 경로 (역할별 분리 주입):
  - backend-dev: `${SKILL_BASE}/peach-gen-backend/references/`
  - store-dev: `${SKILL_BASE}/peach-gen-store/references/`
  - ui-dev: `${SKILL_BASE}/peach-gen-ui/references/`

4. **구조 제안 (May Suggest)**:
   도메인 분석 결과 가이드코드(test-data)와 다른 구조가 더 적합하다고 판단되면:
   - 제안 내용과 이유를 사용자에게 먼저 제시
   - 사용자 확인 후 서브에이전트 프롬프트에 반영

   **제안 가능 범위:**
   - service 파일 분리 (예: 상태전이 전용 service)
   - DAO 구성 변경 (예: 복합 조회용 DAO 분리)
   - 트랜잭션 서비스 필요 여부
   - 모듈 내부 하위 디렉토리 (예: step1/step2 단계별 분리)

   **제안 불가 (Must Follow):**
   - 모듈 경계, 네이밍, 타입 원칙 등

cat api/db/schema/[领域]/[表].sql


**分析项**:
1. Schema对比: 与test-data的字段数量、类型复杂度、关联性对比
2. 业务逻辑判断: 简单CRUD vs 状态转移/计算字段/条件验证
3. 适配决策: Must Follow → 完全遵循 / May Adapt → 识别领域定制项

**向子Agent传递分析结果**:
- 创建各Agent时，在提示词中包含“该领域特性: [分析结果]”
- 模块生成路径: `api/src/[检测到的modules路径]/[模块名]/`
- 前端对应路径: `front/src/[检测到的modules路径]/[模块名]/`
- _common常量列表: `[检测到的常量文件列表]`（存在时禁止硬编码）
- file选项推导: 如果Schema中显示有文件相关需求，则建议`file=Y`
- 引用路径（按角色分别注入）:
  - backend-dev: `${SKILL_BASE}/peach-gen-backend/references/`
  - store-dev: `${SKILL_BASE}/peach-gen-store/references/`
  - ui-dev: `${SKILL_BASE}/peach-gen-ui/references/`

4. **结构建议 (May Suggest)**:
   如果领域分析结果认为参考代码(test-data)的结构不适合，则:
   - 先向用户提出建议内容及理由
   - 经用户确认后，反映到子Agent的提示词中

   **可建议范围:**
   - service文件分离（例如: 状态转移专用service）
   - DAO结构变更（例如: 复合查询用DAO分离）
   - 是否需要事务服务
   - 模块内部子目录（例如: step1/step2分步分离）

   **不可建议 (Must Follow):**
   - 模块边界、命名、类型原则等

2. 팀 구성 다이어그램

2. 团队构成流程图

mode=backend

backend-dev ──→ backend-qa
       │
       └──→ store-dev ──→ frontend-qa

mode=ui

ui-dev ──→ frontend-qa

mode=fullstack

backend-dev ──→ backend-qa
       │
       └──→ store-dev ──→ ui-dev ──→ frontend-qa

mode=backend

backend-dev ──→ backend-qa
       │
       └──→ store-dev ──→ frontend-qa

mode=ui

ui-dev ──→ frontend-qa

mode=fullstack

backend-dev ──→ backend-qa
       │
       └──→ store-dev ──→ ui-dev ──→ frontend-qa

3. 팀 생성 및 작업 등록

3. 团队创建及任务注册

TeamCreate: team_name="[모듈명]-[mode]-team"

TeamCreate: team_name="[模块名]-[mode]-team"

mode=backend 작업 등록

mode=backend任务注册

TaskCreate:

"Backend API 개발" (owner: backend-dev)
"Backend QA 검증" (blockedBy: Task1, owner: backend-qa)
"Frontend Store 개발" (blockedBy: Task1, owner: store-dev)
"Frontend QA 검증" (blockedBy: Task3, owner: frontend-qa)

TaskCreate:

"Backend API开发" (owner: backend-dev)
"Backend QA验证" (blockedBy: Task1, owner: backend-qa)
"Frontend Store开发" (blockedBy: Task1, owner: store-dev)
"Frontend QA验证" (blockedBy: Task3, owner: frontend-qa)

mode=ui 작업 등록

mode=ui任务注册

TaskCreate:

"UI 컴포넌트 생성" (owner: ui-dev)
"Frontend QA 검증" (blockedBy: Task1, owner: frontend-qa)

TaskCreate:

"UI组件创建" (owner: ui-dev)
"Frontend QA验证" (blockedBy: Task1, owner: frontend-qa)

mode=fullstack 작업 등록

mode=fullstack任务注册

TaskCreate:

"Backend API 개발" (owner: backend-dev)
"Backend QA 검증" (blockedBy: Task1, owner: backend-qa)
"Frontend Store 개발" (blockedBy: Task1, owner: store-dev)
"Frontend UI 개발" (blockedBy: Task3, owner: ui-dev)
"Frontend QA 검증" (blockedBy: Task4, owner: frontend-qa)

undefined

TaskCreate:

"Backend API开发" (owner: backend-dev)
"Backend QA验证" (blockedBy: Task1, owner: backend-qa)
"Frontend Store开发" (blockedBy: Task1, owner: store-dev)
"Frontend UI开发" (blockedBy: Task3, owner: ui-dev)
"Frontend QA验证" (blockedBy: Task4, owner: frontend-qa)

undefined

4. 역할별 지시

4. 角色专属指示

각 역할의 전체 정의(페르소나, Bounded Autonomy, 워크플로우)는

references/

에 있습니다. 서브에이전트 생성 시 해당 파일의 전체 내용을 프롬프트에 포함합니다.

model=

옵션이 지정된 경우, 각 에이전트 호출 시 model 파라미터로 전달하여 frontmatter 기본값을 override합니다.

역할	참조 파일	핵심 스킬
backend-dev	references/backend-dev-agent.md	peach-gen-backend
backend-qa	references/backend-qa-agent.md	검증 전용 (읽기전용, worktree)
store-dev	references/store-dev-agent.md	peach-gen-store
ui-dev	references/ui-dev-agent.md	peach-gen-ui + peach-gen-design
frontend-qa	references/frontend-qa-agent.md	검증 전용 (읽기전용, worktree)

各角色的完整定义（人设、Bounded Autonomy、工作流程）位于

references/

目录下。创建子Agent时，将对应文件的全部内容包含在提示词中。若指定了

model=

选项，则在调用各Agent时传递model参数以覆盖frontmatter默认值。

角色	参考文件	核心技能
backend-dev	references/backend-dev-agent.md	peach-gen-backend
backend-qa	references/backend-qa-agent.md	专用验证（只读、worktree）
store-dev	references/store-dev-agent.md	peach-gen-store
ui-dev	references/ui-dev-agent.md	peach-gen-ui + peach-gen-design
frontend-qa	references/frontend-qa-agent.md	专用验证（只读、worktree）

backend-dev

```
peach-gen-backend
```
기준으로 API 코드를 생성합니다.
Koa/Elysia 모드를 감지합니다.
DAO 라이브러리(bunqldb/sql-template-strings)를 감지합니다.
완료 기준:
```
bun test
```
,
```
bun run lint:fixed
```
,
```
bun run build
```
통과
산출물: API 파일 목록, 엔드포인트 스펙, 테스트 결과
상세:
```
references/backend-dev-agent.md
```
참조

基于
```
peach-gen-backend
```
生成API代码。
检测Koa/Elysia模式。
检测DAO库(bunqldb/sql-template-strings)。
完成标准: 通过
```
bun test
```
、
```
bun run lint:fixed
```
、
```
bun run build
```
交付物: API文件列表、端点规格、测试结果
详情: 参考
```
references/backend-dev-agent.md
```

backend-qa

QA 체크리스트 (7항목):

```
type/
```
,
```
dao/
```
,
```
service/
```
,
```
controller/
```
,
```
test/
```
파일 구조 존재
Service static 메서드 규칙 준수
FK 제약조건 없음
```
bun test
```
통과
```
bun run lint:fixed
```
통과
```
bun run build
```
성공
API 엔드포인트 스펙 일치

상세:
```
references/backend-qa-agent.md
```
참조

QA检查清单（7项）:

存在
```
type/
```
、
```
dao/
```
、
```
service/
```
、
```
controller/
```
、
```
test/
```
文件结构
遵循Service静态方法规则
无FK约束
通过
```
bun test
```
通过
```
bun run lint:fixed
```
```
bun run build
```
成功
API端点规格一致

详情: 参考
```
references/backend-qa-agent.md
```

store-dev

```
peach-gen-store
```
기준으로 Pinia Store를 생성합니다.
Backend 타입과 인터페이스를 맞춥니다.
완료 기준:
```
bunx vue-tsc --noEmit
```
상세:
```
references/store-dev-agent.md
```
참조

基于
```
peach-gen-store
```
生成Pinia Store。
与Backend类型和接口保持一致。
完成标准: 通过
```
bunx vue-tsc --noEmit
```
详情: 参考
```
references/store-dev-agent.md
```

ui-dev

```
peach-gen-ui
```
, 필요 시
```
peach-gen-design
```
을 사용합니다.
```
figma=[URL]
```
가 있으면 FigmaRemote MCP를 로드하여 디자인을 분석합니다.
UI 패턴(
```
ui=
```
)이 없으면 사용자에게 확인합니다.
대상 프로젝트에
```
_common/components/
```
가 존재하면 래퍼 컴포넌트를 우선 사용합니다.

완료 기준:

bunx vue-tsc --noEmit

bun run lint:fix

bun run build

상세:
```
references/ui-dev-agent.md
```
참조

使用
```
peach-gen-ui
```
，必要时使用
```
peach-gen-design
```
。
若存在
```
figma=[URL]
```
，则加载FigmaRemote MCP分析设计。
若未指定UI模式(
```
ui=
```
)，则向用户确认。
若目标项目存在
```
_common/components/
```
，则优先使用包装组件。

完成标准: 通过

bunx vue-tsc --noEmit

、

bun run lint:fix

、

bun run build

详情: 参考
```
references/ui-dev-agent.md
```

frontend-qa

QA 체크리스트 (8항목):

파일 구조 (pages/, modals/, store/, type/) 존재
Composition API (
```
<script setup>
```
) 패턴 준수
Pinia Option API Store 패턴 준수
```
listAction
```
,
```
resetAction
```
,
```
listMovePage
```
함수 구현
URL watch 패턴 적용 (
```
route → listParams
```
,
```
route → getList
```
)
```
bunx vue-tsc --noEmit
```
통과
```
bun run lint:fix
```
통과
```
bun run build
```
성공 + AI Slop 디자인 패턴 없음

상세:
```
references/frontend-qa-agent.md
```
참조

QA检查清单（8项）:

存在文件结构(pages/, modals/, store/, type/)
遵循Composition API(
```
<script setup>
```
)模式
遵循Pinia Option API Store模式
实现
```
listAction
```
、
```
resetAction
```
、
```
listMovePage
```
函数
应用URL watch模式(
```
route → listParams
```
,
```
route → getList
```
)
通过
```
bunx vue-tsc --noEmit
```
通过
```
bun run lint:fix
```
```
bun run build
```
成功 + 无AI Slop设计模式

详情: 参考
```
references/frontend-qa-agent.md
```

QA 판정 처리 (3단계)

QA判定处理（3阶段）

QA 에이전트(backend-qa, frontend-qa)는 APPROVED / CONDITIONAL / REJECTED 3단계로 판정합니다. 오케스트레이터가 Architect 역할을 수행하여 판정을 처리합니다.

QA Agent(backend-qa, frontend-qa)采用APPROVED / CONDITIONAL / REJECTED三个阶段进行判定。编排器承担Architect角色处理判定结果。

✅ APPROVED

QA → SendMessage → 오케스트레이터: "APPROVED" + 검증 결과
오케스트레이터 → /peach-qa-gate 자동 실행
→ 완료

QA → SendMessage → 编排器: "APPROVED" + 验证结果
编排器 → 自动执行/peach-qa-gate
→ 完成

⚠️ CONDITIONAL

QA → SendMessage → 오케스트레이터: "CONDITIONAL" + 조건 내용 + 왜 REJECTED가 아닌지 근거
오케스트레이터 판단:
    "조건 수용" → dev 에이전트에 수정 지시 → QA 재검증
    "조건 무시" → 판단 근거 기록 후 APPROVED로 처리

규칙:

CONDITIONAL은 Ralph Loop가 아닙니다. 오케스트레이터 판단 전까지 완료 처리 금지.
QA는 조건 항목 최소 1개 + 왜 REJECTED가 아닌지 근거를 함께 보고해야 합니다.
오케스트레이터가 "무시"를 선택한 경우 근거를 최종 완료 보고에 포함합니다.

QA → SendMessage → 编排器: "CONDITIONAL" + 条件内容 + 未判定为REJECTED的理由
编排器判定:
    "接受条件" → 指示dev Agent修改 → QA重新验证
    "忽略条件" → 记录判定理由后按APPROVED处理

规则:

CONDITIONAL不属于Ralph Loop。在编排器判定前禁止完成处理。
QA必须同时上报至少1项条件 + 未判定为REJECTED的理由。
若编排器选择“忽略”，则需将理由包含在最终完成报告中。

❌ REJECTED → Ralph Loop 작동

❌ REJECTED → 触发Ralph Loop

REJECTED 시 단순 재시도가 아닌 Ralph Loop(Vercel Labs) 패턴으로 구조화된 피드백을 주입합니다.

判定为REJECTED时，不进行简单重试，而是采用Ralph Loop(Vercel Labs)模式注入结构化反馈。

에스컬레이션 단계

升级阶段

반복 횟수	단계	행동
1~3회	자율 수정	QA 피드백만으로 코드 수정
4회	가이드 재참조	test-data 기준골격 전체 재읽기 후 수정
5~7회	Codex 진단	`codex:codex-rescue` 로 실패 원인 독립 진단 + 가이드 재참조
8~10회	최소 수정	Must Follow 항목만 집중, 나머지 보류
11+	중단	사용자 에스컬레이션

重复次数	阶段	行动
1~3次	自主修正	仅通过QA反馈修改代码
4次	重新参考指南	重新读取test-data基准骨架后修改
5~7次	Codex诊断	使用 `codex:codex-rescue` 独立诊断失败原因 + 重新参考指南
8~10次	最小修正	仅聚焦Must Follow项，其余暂不处理
11+次	终止	升级至用户处理

Codex 투입 조건 (5~7회)

Codex投入条件（5~7次）

CODEX_AVAILABLE=true

시에만 투입 (settings.json에서

"codex@openai-codex": true

감지)

```
CODEX_AVAILABLE=false
```
: Codex 없이 기존 Ralph Loop 계속 (가이드 재참조)
Codex 무응답/타임아웃: 60초 대기 → 응답 없으면 스킵, 기존 피드백으로 진행
Codex 진단 결과 부실: 오케스트레이터가 무시하고 기존 피드백으로 진행

仅当

CODEX_AVAILABLE=true

时投入（检测settings.json中

"codex@openai-codex": true

）

```
CODEX_AVAILABLE=false
```
: 不使用Codex，继续原Ralph Loop（重新参考指南）
Codex无响应/超时: 等待60秒 → 仍无响应则跳过，按原有反馈继续
Codex诊断结果不合格: 编排器忽略该结果，按原有反馈继续

적용 방식

应用方式

Backend QA REJECTED → backend-dev 수정 → backend-qa 재검증 (SendMessage)
Store 문제 → store-dev 수정 → frontend-qa 재검증
UI 문제 → ui-dev 수정 → frontend-qa 재검증

Backend QA判定REJECTED → backend-dev修改 → backend-qa重新验证(SendMessage)
Store问题 → store-dev修改 → frontend-qa重新验证
UI问题 → ui-dev修改 → frontend-qa重新验证

에스컬레이션 보고

升级报告

undefined

undefined

Ralph Loop 에스컬레이션

Ralph Loop升级

모듈: [모듈명]
반복: N/10회
단계: [현재 단계]
미해결: [위반 항목]
권장: [수동 개입 사항]

undefined

模块: [模块名]
重复次数: N/10次
当前阶段: [当前阶段]
未解决项: [违规项]
建议: [手动介入事项]

undefined

Completion

完成流程

모든 QA APPROVED 후:

所有QA均判定为APPROVED后:

1. 증거 수집

1. 收集证据

오케스트레이터가

/peach-qa-gate

를 자동 실행 → 증거 보고서 생성

판정이 ❌이면 해당 항목 수정 후 재실행
판정이 ✅이면 다음 단계 진행

编排器自动执行

/peach-qa-gate

→ 生成证据报告

若判定为❌，则修改对应项后重新执行
若判定为✅，则进入下一步

2. 팀 정리

2. 清理团队

SendMessage(shutdown_request) → 모든 팀원에게
TeamDelete → 팀 정리

SendMessage(shutdown_request) → 发送给所有团队成员
TeamDelete → 清理团队

완료 보고 형식

完成报告格式

mode=backend

✅ Backend + Store 연결 팀 개발 완료

모듈: [모듈명]
mode: backend

결과:
✅ backend-dev: API 생성 완료
✅ backend-qa: TDD X개 통과
✅ store-dev: Store 생성 완료
✅ frontend-qa: vue-tsc + lint + build 통과
✅ qa-gate: 증거 보고서 생성 + 완료 가능 판정

생성된 파일:
Backend:
├── api/src/[modules 경로]/[모듈명]/type/
├── api/src/[modules 경로]/[모듈명]/dao/
├── api/src/[modules 경로]/[모듈명]/service/
├── api/src/[modules 경로]/[모듈명]/controller/
└── api/src/[modules 경로]/[모듈명]/test/

Frontend:
├── front/src/[modules 경로]/[모듈명]/type/[모듈명].type.ts
└── front/src/[modules 경로]/[모듈명]/store/[모듈명].store.ts

다음 단계:
→ bun start (Backend 실행)
→ bun run dev (Frontend 실행)
→ 브라우저에서 /[모듈명]/list 접속

✅ Backend + Store连接团队开发完成

模块: [模块名]
mode: backend

结果:
✅ backend-dev: API生成完成
✅ backend-qa: 通过X项TDD测试
✅ store-dev: Store生成完成
✅ frontend-qa: 通过vue-tsc + lint + build
✅ qa-gate: 生成证据报告 + 判定可完成

生成的文件:
Backend:
├── api/src/[modules路径]/[模块名]/type/
├── api/src/[modules路径]/[模块名]/dao/
├── api/src/[modules路径]/[模块名]/service/
├── api/src/[modules路径]/[模块名]/controller/
└── api/src/[modules路径]/[模块名]/test/

Frontend:
├── front/src/[modules路径]/[模块名]/type/[模块名].type.ts
└── front/src/[modules路径]/[模块名]/store/[模块名].store.ts

下一步:
→ bun start (启动Backend)
→ bun run dev (启动Frontend)
→ 在浏览器中访问/[模块名]/list

mode=ui

✅ UI Only 팀 개발 완료

모듈: [모듈명]
mode: ui
패턴: [ui=패턴]
피그마: [URL 또는 없음]

결과:
✅ ui-dev: UI 컴포넌트 생성 완료
✅ frontend-qa: vue-tsc + lint + build 통과

생성된 파일:
├── front/src/[modules 경로]/[모듈명]/pages/list.vue
├── front/src/[modules 경로]/[모듈명]/pages/list-search.vue
├── front/src/[modules 경로]/[모듈명]/pages/list-table.vue
├── front/src/[modules 경로]/[모듈명]/modals/insert.modal.vue
├── front/src/[modules 경로]/[모듈명]/modals/update.modal.vue
├── front/src/[modules 경로]/[모듈명]/modals/detail.modal.vue
├── front/src/[modules 경로]/[모듈명]/_[모듈명].routes.ts
└── front/src/[modules 경로]/[모듈명]/_[모듈명].validator.ts

다음 단계:
→ bun run dev (Frontend 실행)
→ 브라우저에서 /[모듈명]/list 접속

✅ UI Only团队开发完成

模块: [模块名]
mode: ui
模式: [ui=模式]
Figma: [URL或无]

结果:
✅ ui-dev: UI组件生成完成
✅ frontend-qa: 通过vue-tsc + lint + build

生成的文件:
├── front/src/[modules路径]/[模块名]/pages/list.vue
├── front/src/[modules路径]/[模块名]/pages/list-search.vue
├── front/src/[modules路径]/[模块名]/pages/list-table.vue
├── front/src/[modules路径]/[模块名]/modals/insert.modal.vue
├── front/src/[modules路径]/[模块名]/modals/update.modal.vue
├── front/src/[modules路径]/[模块名]/modals/detail.modal.vue
├── front/src/[modules路径]/[模块名]/_[模块名].routes.ts
└── front/src/[modules路径]/[模块名]/_[模块名].validator.ts

下一步:
→ bun run dev (启动Frontend)
→ 在浏览器中访问/[模块名]/list

mode=fullstack

🎉 풀스택 개발 완료!

모듈: [모듈명]
mode: fullstack

결과:
✅ backend-dev: API 생성 완료
✅ backend-qa: TDD X개 통과
✅ store-dev: Store 생성 완료
✅ ui-dev: UI 컴포넌트 생성 완료
✅ frontend-qa: vue-tsc + lint + build 통과

생성된 파일:
Backend:
├── api/src/[modules 경로]/[모듈명]/type/
├── api/src/[modules 경로]/[모듈명]/dao/
├── api/src/[modules 경로]/[모듈명]/service/
├── api/src/[modules 경로]/[모듈명]/controller/
└── api/src/[modules 경로]/[모듈명]/test/

Frontend:
├── front/src/[modules 경로]/[모듈명]/type/
├── front/src/[modules 경로]/[모듈명]/store/
├── front/src/[modules 경로]/[모듈명]/pages/
├── front/src/[modules 경로]/[모듈명]/modals/
├── front/src/[modules 경로]/[모듈명]/_[모듈명].routes.ts
└── front/src/[modules 경로]/[모듈명]/_[모듈명].validator.ts

다음 단계:
→ bun start (Backend 실행)
→ bun run dev (Frontend 실행)
→ 브라우저에서 /[모듈명]/list 접속

🎉 全栈开发完成!

模块: [模块名]
mode: fullstack

结果:
✅ backend-dev: API生成完成
✅ backend-qa: 通过X项TDD测试
✅ store-dev: Store生成完成
✅ ui-dev: UI组件生成完成
✅ frontend-qa: 通过vue-tsc + lint + build

生成的文件:
Backend:
├── api/src/[modules路径]/[模块名]/type/
├── api/src/[modules路径]/[模块名]/dao/
├── api/src/[modules路径]/[模块名]/service/
├── api/src/[modules路径]/[模块名]/controller/
└── api/src/[modules路径]/[模块名]/test/

Frontend:
├── front/src/[modules路径]/[模块名]/type/
├── front/src/[modules路径]/[模块名]/store/
├── front/src/[modules路径]/[模块名]/pages/
├── front/src/[modules路径]/[模块名]/modals/
├── front/src/[modules路径]/[模块名]/_[模块名].routes.ts
└── front/src/[modules路径]/[模块名]/_[模块名].validator.ts

下一步:
→ bun start (启动Backend)
→ bun run dev (启动Frontend)
→ 在浏览器中访问/[模块名]/list

Examples

示例

bash

undefined

bash

undefined

기존 UI에 API + Store 연결

为现有UI连接API + Store

/peach-team notice-board mode=backend

UI만 구현

仅实现UI

/peach-team member-list mode=ui ui=two-depth figma=https://figma.com/file/xxx

전체 풀스택 생성

生成完整全栈

/peach-team product-manage mode=fullstack ui=page file=Y

opus 모델로 서브에이전트 실행

使用opus模型运行子Agent

/peach-team product-manage mode=fullstack model=opus ui=page

undefined

/peach-team product-manage mode=fullstack model=opus ui=page

undefined