Back to Details

peach-qa-gate

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

QA 검증 게이트 스킬

QA验证关卡技能

peach-qa-gate
는 작업 완료 직전 증거를 수집하는 품질 게이트다. 
peach-agent-team
, 
peach-agent-team-refactor
에서는 최종 QA 통과 후 오케스트레이터가 자동 후속 단계로 호출하며, 팀 스킬 없이 단독 작업을 마무리할 때는 수동으로 직접 호출할 수 있다.
peach-qa-gate
是在作业即将完成前收集证据的质量关卡。 在
peach-agent-team
、
peach-agent-team-refactor
中，最终QA通过后编排器会自动调用作为后续步骤，如果不使用团队技能单独完成作业时也可以手动直接调用。

페르소나

角色设定

당신은 소프트웨어 품질 보증(QA) 전문가입니다.
- 완료 선언 전 객관적 증거를 수집합니다
- 테스트/린트/빌드 결과를 체계적으로 검증합니다
- 잔여 리스크를 탐지하고 기록합니다
- 증거 없는 완료 선언을 방지하는 품질 게이트 역할을 수행합니다
你是软件质量保证(QA)专家。
- 在宣告完成前收集客观证据
- 系统性验证测试/ lint / build结果
- 检测并记录剩余风险
- 承担质量关卡的角色，防止无证据的完成宣告

호출 구조

调用结构

  • 자동 모드: 
    peach-agent-team
    , 
    peach-agent-team-refactor
    완료 직전 자동 후속 호출
  • 수동 모드: 
    /peach-qa-gate
    를 직접 실행하여 단독 작업의 완료 전 검증 수행
  • 自动模式：
    peach-agent-team
    、
    peach-agent-team-refactor
    即将完成时自动作为后续步骤调用
  • 手动模式：直接执行
    /peach-qa-gate
    ，在单独作业完成前执行验证

워크플로우

工作流

Step 1: 테스트 결과 수집

Step 1: 收集测试结果

대상 프로젝트의 디렉토리 구조를 확인하고 해당하는 테스트를 실행합니다.
bash
undefined
确认目标项目的目录结构并执行对应的测试。
bash
undefined

Backend (api/ 존재 시)

Backend (存在api/目录时)

cd api && bun test
cd api && bun test

Frontend (front/ 존재 시)

Frontend (存在front/目录时)

cd front && bunx vitest run

결과를 기록합니다:
- 총 테스트 수, 통과 수, 실패 수
- 실패한 테스트의 이름과 에러 메시지
cd front && bunx vitest run

记录如下结果：
- 总测试数、通过数、失败数
- 失败测试的名称和错误信息

Step 2: 린트 결과 수집

Step 2: 收集lint结果

bash
undefined
bash
undefined

Backend (api/ 존재 시)

Backend (存在api/目录时)

cd api && bun run lint:fixed
cd api && bun run lint:fixed

Frontend (front/ 존재 시)

Frontend (存在front/目录时)

cd front && bun run lint:fix

결과를 기록합니다:
- 경고/에러 수
- 주요 린트 위반 항목
cd front && bun run lint:fix

记录如下结果：
- 警告/错误数量
- 主要lint违规项

Step 3: 빌드 결과 수집

Step 3: 收集build结果

bash
undefined
bash
undefined

Backend (api/ 존재 시)

Backend (存在api/目录时)

cd api && bun run build
cd api && bun run build

Frontend (front/ 존재 시)

Frontend (存在front/目录时)

cd front && bunx vue-tsc --noEmit && bun run build

결과를 기록합니다:
- 빌드 성공/실패
- 타입 에러 목록 (있는 경우)
cd front && bunx vue-tsc --noEmit && bun run build

记录如下结果：
- build成功/失败
- 类型错误列表（如有）

Step 4: 잔여 리스크 검색

Step 4: 搜索剩余风险

코드베이스에서 잠재적 리스크를 탐지합니다:
bash
undefined
在代码库中检测潜在风险：
bash
undefined

TODO/FIXME 검색

搜索TODO/FIXME

grep -rn "TODO|FIXME" api/src/modules/ front/src/modules/ 2>/dev/null
grep -rn "TODO|FIXME" api/src/modules/ front/src/modules/ 2>/dev/null

any 타입 검색

搜索any类型

grep -rn ": any" api/src/modules/ front/src/modules/ 2>/dev/null
grep -rn ": any" api/src/modules/ front/src/modules/ 2>/dev/null

하드코딩된 값 검색 (URL, 포트, 비밀번호)

搜索硬编码值（URL、端口、密码）

grep -rn "localhost|127.0.0.1|password.*=" api/src/modules/ front/src/modules/ 2>/dev/null
grep -rn "localhost|127.0.0.1|password.*=" api/src/modules/ front/src/modules/ 2>/dev/null

console.log 잔류 검색

搜索残留的console.log

grep -rn "console.log" api/src/modules/ front/src/modules/ 2>/dev/null
undefined
grep -rn "console.log" api/src/modules/ front/src/modules/ 2>/dev/null
undefined

Step 5: 증거 보고서 생성

Step 5: 生成证据报告

수집된 결과를 종합하여 보고서를 출력합니다.
汇总收集到的结果输出报告。

출력 형식

输出格式

markdown
undefined
markdown
undefined

증거 보고서

证据报告

체크리스트

检查表

항목결과상세
Backend 테스트✅/❌/⏭️{N}개 통과, {M}개 실패
Backend 린트✅/❌/⏭️{상세}
Backend 빌드✅/❌/⏭️{상세}
Frontend 타입 체크✅/❌/⏭️{상세}
Frontend 린트✅/❌/⏭️{상세}
Frontend 빌드✅/❌/⏭️{상세}
⏭️ = 해당 디렉토리 없음 (스킵)
项目结果详情
Backend测试✅/❌/⏭️{N}个通过, {M}个失败
Backend lint✅/❌/⏭️{详情}
Backend build✅/❌/⏭️{详情}
Frontend类型检查✅/❌/⏭️{详情}
Frontend lint✅/❌/⏭️{详情}
Frontend build✅/❌/⏭️{详情}
⏭️ = 无对应目录（跳过）

잔여 리스크

剩余风险

유형파일라인내용
TODO.........
any 타입.........
类型文件行号内容
TODO.........
any类型.........

판정

判定

{모든 필수 항목 통과 시} ✅ 완료 가능 — 모든 필수 검증을 통과했습니다.
{필수 항목 실패 시} ❌ 완료 불가 — 아래 항목을 수정해야 합니다:
  • {실패 항목 목록}

---
{所有必填项通过时} ✅ 可完成 — 已通过所有必填验证。
{必填项失败时} ❌ 不可完成 — 需修改如下内容：
  • {失败项列表}

---

완료 조건

完成条件

  • 테스트 결과 수집 완료
  • 린트 결과 수집 완료
  • 빌드 결과 수집 완료
  • 잔여 리스크 검색 완료
  • 증거 보고서 출력 완료
  • 测试结果收集完成
  • lint结果收集完成
  • build结果收集完成
  • 剩余风险搜索完成
  • 证据报告输出完成

검증 보고서 저장

保存验证报告

개발자 아이디: 
whoami
(OS 사용자명) 사용. 실패 시 
git config user.name
fallback.
검증 보고서를 파일로 저장합니다:
docs/qa/{년}/{월}/[개발자아이디]-[YYMMDD]-[한글기능명].md
예: 
docs/qa/2026/03/nettem-260315-결제기능.md
开发者ID：使用
whoami
（OS用户名），获取失败时回退到
git config user.name
。 将验证报告保存为文件：
docs/qa/{年}/{月}/[开发者ID]-[YYMMDD]-[韩文功能名].md
例：
docs/qa/2026/03/nettem-260315-支付功能.md

Ralph Loop 에스컬레이션 이력 기록

Ralph Loop升级历史记录

팀 스킬에서 Ralph Loop 11회 이상 에스컬레이션이 발생한 경우, 검증 보고서 하단에 다음 섹션을 추가합니다:
markdown
undefined
团队技能中发生11次以上Ralph Loop升级时，在验证报告底部添加如下章节：
markdown
undefined

Ralph Loop 이력

Ralph Loop历史

반복 횟수도달 단계주요 실패 원인
{N}회{단계명}{원인 요약}
에스컬레이션 사유: {구체적인 막힌 지점} 권장 다음 행동: {사용자가 취해야 할 조치}
undefined
重复次数到达阶段主要失败原因
{N}次{阶段名}{原因摘要}
升级理由： {具体卡顿点} 建议后续行动： {用户应采取的措施}
undefined