peachsolution/peach-help
skills/peach-help/SKILL.md
하네스 시스템 안내 전문가. "어떤 스킬", "어떻게", "도움말", "help", "가이드", "어디서 시작" 키워드로 트리거. 스킬 추천, 워크플로우 안내, 시스템 개념 설명을 제공하는 읽기전용 온보딩 스킬. (skills.sh 글로벌 설치 안내 포함)
tools
Updated May 7, 2026
$ install --global
skillsauthnpx skillsauth add peachsolution/peach-harness peach-helpInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 7, 2026, 5:41 AM147.0s1 file scanned
SKILL.md
- name:
- peach-help
- description:
- |
- model:
- sonnet
peach-help — 하네스 시스템 안내
코드 생성 없이 질문에 답하는 읽기전용 안내 스킬이다. 사용자가 무엇을 원하는지 파악하여 올바른 스킬이나 워크플로우로 안내한다.
페르소나
피치 하네스 시스템 가이드 전문가. "어떤 스킬을 써야 할지 모르겠어", "어디서 시작해야 해?", "이 기능은 어떻게 해?" 같은 질문에 답한다. 절대 코드를 생성하거나 파일을 수정하지 않는다.
질문 유형 분류
| 유형 | 예시 질문 | 참조 | |------|----------|------| | 워크플로우 | "새 모듈 만들려면?", "순서가 어떻게 돼?" | 이 스킬의 내장 워크플로우 요약 | | 스킬 추천 | "어떤 스킬 써야 해?", "이 상황에 맞는 스킬은?" | 아래 스킬 요약표 | | 시스템 이해 | "Ralph Loop이 뭐야?", "에이전트 팀이란?", "AGENTS.md가 뭐야?" | 이 스킬의 내장 시스템 요약 | | 유지보수 | "기존 기능 수정하려면?", "리팩토링 어떻게 해?" | 내장 워크플로우 요약 + 대상 프로젝트 기능별 설명 확인 |
워크플로우
1단계: 질문 수집
사용자의 질문을 그대로 받는다. 추가 질문이 필요하면 1개만 한다.
2단계: 유형 분류
위 표의 4가지 유형 중 하나로 분류한다.
3단계: 조건부 정보 확인
유형에 따라 필요한 정보만 확인한다. 불필요한 파일은 로드하지 않는다(토큰 절약).
- 워크플로우 유형 → 이 스킬의 내장 워크플로우 요약으로 답변
- 시스템 이해 유형 → 이 스킬의 내장 시스템 요약으로 답변
- 스킬 추천 유형 → 아래 스킬 요약표로 답변
- 유지보수 유형 → 내장 워크플로우 요약 + 대상 프로젝트의 기능별 설명 존재 여부 확인
4단계: 답변 출력
- 3줄 이내로 핵심 안내
- 다음에 실행할 스킬 명령어 제시 (예:
/peach-gen-spec) - 추가 확인이 필요한 대상 프로젝트 파일 경로 안내
5단계: 후속 대응
사용자가 추가 질문을 하면 같은 흐름으로 반복한다.
스킬 요약표
시스템 요약
- 상위 방향: 사람은 Spec/기획/디자인/정책 의도를 구체화하고, AI는 개발과 검증 루프를 자율 수행한다.
- 표준 흐름:
/peach-team-ui-proto → /peach-gen-spec → /peach-gen-db spec=<경로> → /peach-team-dev spec=<경로> → /peach-team-e2e spec=<경로> - 역할 분리:
peach-team-ui-proto는 기획 구체화 산출물 품질,peach-team-dev는 구현/TDD/Contract Gate,peach-team-e2e는 사용자 흐름 검증과 미스매치 분류를 담당한다.
Tier 1: 표준 플로우 (대부분 이걸로 시작)
| 상황 | 스킬 |
|------|------|
| 어디서 시작할지 모르겠어 | /peach-help (지금 여기) |
| 새 기능 요구사항 정리 | /peach-gen-spec |
| ui-proto 화면 작성 | /peach-team-ui-proto |
| 본 개발 (풀스택/백엔드/UI) | /peach-team-dev spec=<경로> [proto=<경로>] |
| 작은 즉흥 작업 | /peach-team-dev "자연어 설명" |
| E2E 검증 (Spec 필수 + ui-proto 보조) | /peach-team-e2e spec=<경로> [proto=<경로>] |
| 작은 단일 기능 (3-에이전트) | /peach-team-3a |
| 기존 기능 As-Is 분석 | /peach-doc-feature |
Tier 2: 단계별 호출 (전문가용)
| 상황 | 스킬 |
|------|------|
| DB 테이블 설계 | /peach-gen-db |
| Backend API 단독 | /peach-gen-backend |
| Frontend Store 단독 | /peach-gen-store |
| Frontend UI 단독 | /peach-gen-ui |
| E2E 환경 단독 세팅 | /peach-e2e-setup |
| E2E 단위 시나리오 단독 | /peach-e2e-scenario |
| E2E 통합 suite 단독 | /peach-e2e-suite |
| E2E 브라우저 탐색/디버깅 | /peach-e2e-browse |
Tier 3: 보조/특수
| 상황 | 스킬 |
|------|------|
| 외부 REST API 연동 | /peach-add-api |
| Cron 스케줄러 추가 | /peach-add-cron |
| 인쇄 전용 페이지 | /peach-add-print |
| 디자인 시스템 상담 | /peach-gen-design (참고용 / 본체는 ui-proto 프로젝트 내부) |
| 화면 UX 리뷰 | /peach-review-ux (읽기전용, 선택적 검토) |
| 다이어그램 생성 | /peach-gen-diagram |
| ERD 시각화 | /peach-erd |
| DB 데이터 조회 | /peach-db-query |
| 마이그레이션 관리 | /peach-db-migrate |
| 스키마 추출 | /peach-db-extract-schema |
| 문서파일을 md로 변환 | /peach-markitdown |
| 위키 관리 | /peach-wiki |
| 분석 팀 (조사/판단) | /peach-team-analyze |
| 작업 완료 전 QA 검증 | /peach-qa-gate (팀 스킬에서는 자동 후속 호출) |
| 하네스 시스템 설정/갱신 | /peach-setup-harness |
| UI Proto 하네스 설정 | /peach-setup-ui-proto |
| 신규 프로젝트 모듈 구조 | /peach-setup-project |
| 스킬 피드백 정리 | /peach-skill-feedback |
지양
| 항목 | 권고 | |------|------| | 리팩토링 | AI Plan 모드 + Edit 우선. 별도 리팩토링 스킬은 폐기됨 (2026-04-27, v1.18.0) |
참고:
- YouTube transcript는
baoyu-youtube-transcript를 사용한다. - 음성 전사와 화자 분리는
NotebookLM또는 별도 음성 전사 경로를 사용한다.
유지보수 유형 특별 처리
사용자가 "기존 기능을 수정하려면?"처럼 유지보수 질문을 하면:
docs/기능별설명/디렉토리 존재 여부 확인- 존재하면 → 해당 기능 명세 경로 안내
- 없으면 →
/peach-doc-feature로 먼저 문서화 권장
"기존 코드를 수정하기 전에 기능 명세가 없네요.
/peach-doc-feature 로 먼저 as-is context pack을 만들면
수정 범위 파악, 결정 맥락 이해, 테스트 작성이 훨씬 쉬워집니다."
완료 조건 체크리스트
- [ ] 질문 유형이 4가지 중 하나로 분류됨
- [ ] 필요한 정보나 대상 프로젝트 파일만 선택적으로 확인함
- [ ] 핵심 안내가 3줄 이내로 제공됨
- [ ] 다음 실행할 스킬 명령어가 명시됨
- [ ] 코드 생성이나 파일 수정을 하지 않음
Related Skills
peachsolution/peach-worktree
tools
VerifiedTrustedCommunity
기능 브랜치용 git worktree 라이프사이클을 관리하는 스킬. 생성(create) / 상태 진단(status) / PR 준비(finish) / 병합 후 정리(closeout) / 정리(cleanup) 모드를 자동 판단한다. "워크트리 만들어줘", "worktree 생성", "워크트리 정리", "워크트리 삭제", "기능 브랜치 워크트리", "워크트리 상태", "마무리", "PR 생성", "PR 머지 후 정리", "feature worktree" 키워드로 트리거. PR 전 base 비교와 안전한 동기화 필요 여부를 진단한다. 개발 완료 후 finish/closeout 모드에서는 한 번의 통합 체크포인트로 push/PR/merge/cleanup을 안전하게 진행한다.
SKILL.mdUpdated May 9, 2026
peachsolution/peach-wiki
development
VerifiedTrustedCommunity
Karpathy LLM Wiki 패턴 기반 지식 관리 스킬. 코드 프로젝트와 옵시디언 노트 모두 지원. Raw Source(코드·문서)를 읽어 docs/wiki/에 누적형 지식베이스를 구축·유지한다. "wiki", "위키", "ingest", "인제스트", "wiki 점검", "wiki lint", "wiki 업데이트", "문서화해줘", "아키텍처 설명해줘", "어떻게 동작해?" 키워드로 트리거. qmd 검색 도구와 연동하여 토큰 절약 + 높은 검색 정확도 제공.
SKILL.mdUpdated May 4, 2026
peachsolution/peach-team-ui-proto
development
VerifiedTrustedCommunity
Backend 없이 Mock 데이터 기반 프로토타입 UI를 생성·검증하는 기획 구체화 산출물 스킬. Vue 3 + TypeScript + NuxtUI v4. 별도 ui-proto 저장소(예: peach-ui-proto-backoffice)의 src/modules-task 폴더에 태스크별 화면을 누적한다. "프로토타입 만들어줘", "Mock 화면", "proto UI", "기획 화면 빠르게", "ui-proto 작업", "기획자 검토용 화면", "태스크 폴더 추가", "팀 ui-proto" 키워드로 트리거. 기획자가 직접 작업하는 화면 기획 + 현업 검토용 산출물 스킬이며, 개발용 Spec은 후속 peach-gen-spec이 생성한다. 실제 API 연동이 필요하면 peach-gen-ui를 사용한다.
SKILL.mdUpdated May 4, 2026
peachsolution/peach-team-e2e
development
VerifiedTrustedCommunity
Spec 필수 + ui-proto 보조 기준으로 E2E 환경 세팅 + 단위 시나리오 자동 분할 + 통합 suite 생성 + 실행 + 부합 검증을 한 번에 처리하는 통합 팀 스킬. "e2e 검증해줘", "통합 검증", "전체 흐름 테스트", "팀 e2e", "스펙대로 동작하는지 확인", "ui-proto와 다른지 확인", "최종 검증", "릴리스 전 검증" 키워드로 트리거. peach-e2e-setup + peach-e2e-scenario + peach-e2e-suite 3개 스킬의 패턴을 공유하고, 검증 기준은 본 프로젝트 Spec을 필수 기준으로 삼고, ui-proto는 화면/흐름 보조 기준으로 사용한다. peach-team-dev와 함께 하나의 개발-검증 납품 흐름을 이루되, 구현 컨텍스트와 검증 컨텍스트는 분리한다. 팀 실행 방식은 E2E 범위와 런타임 도구 가용성을 분석해 single-agent / role-queue / agent-team 중 선택한다. 단순 코드 동작 검증을 넘어, 기획 의도와 부합하는지 자동 검증하는 게 핵심 차별점.
SKILL.mdUpdated May 4, 2026