Agent Interaction Agent Skill
에이전트 간 상호작용 구조와 워크플로우 정의
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/majiayu000/claude-skill-registry --skill agent-interactionWhat comes with it
753 bytes besides the instructionThe instruction itself
13 sections, as written by the authorAgent Interaction Guide
에이전트 간 상호작용 구조와 워크플로우를 정의합니다.
팀 구성
┌─────────────────────────────────────────────────────────┐
│ Strategic Layer │
│ ┌─────────┐ ┌──────────────────┐ │
│ │ CTO │───▶│ Planning Advisor │ │
│ └────┬────┘ └────────┬─────────┘ │
│ │ │ (Codex 호출) │
│ ▼ ▼ │
│ ┌─────────────────────────────────────┐ │
│ │ .context/plan.md │ │
│ └─────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ Execution Layer │
│ │
│ ┌───────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ FE Lead │ │ Electron Lead │ │ Platform Lead │ │
│ └─────┬─────┘ └──────┬───────┘ └──────┬───────┘ │
│ │ │ │ │
│ └───────────────┼──────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────┐ │
│ │ UX Lead │ (UI 검토) │
│ └─────────────────┘ │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ Support Layer │
│ │
│ ┌──────────────┐ ┌─────────────┐ ┌──────────────┐ │
│ │ DevOps Lead │ │ Test Lead │ │ Tech Writer │ │
│ └──────────────┘ └─────────────┘ └──────────────┘ │
└─────────────────────────────────────────────────────────┘
워크플로우
Phase 1: 계획 수립
요청 접수
│
▼
┌─────────┐
│ CTO │ ─── .context/plan.md 작성
└────┬────┘
│
▼
┌──────────────────┐
│ Planning Advisor │ ─── 계획 검토
└────────┬─────────┘
│
┌────┴────┐
│ 위험도? │
└────┬────┘
│
┌─────┼─────┐
▼ ▼ ▼
저/중 고위험
│ │
│ ▼
│ Codex 검증
│ │
└──┬──┘
▼
피드백 반영
│
▼
계획 확정
Phase 2: 구현
계획에 명시된 담당 Lead가 작업 수행:
| 변경 영역 | 담당 Lead | 협업 대상 |
|-----------|-----------|-----------|
| React 컴포넌트 | FE Lead | UX Lead |
| Main process | Electron Lead | Platform Lead |
| IPC 채널 | Electron Lead | FE Lead |
| launchd 연동 | Platform Lead | Electron Lead |
| 스타일/디자인 | UX Lead | FE Lead |
| 빌드/패키징 | DevOps Lead | - |
| 테스트 | Test Lead | 해당 Lead |
| 문서 | Tech Writer | 해당 Lead |
Phase 3: 검증
구현 완료
│
▼
┌──────────────┐
│ Test Lead │ ─── 테스트 커버리지 및 품질 검토
└──────┬───────┘
│
▼
┌──────────────┐
│ DevOps Lead │ ─── bun run test && bun run build
└──────┬───────┘
│
▼
┌──────────────┐
│ UX Lead │ ─── UI 변경 시 시각적 검토
└──────┬───────┘
│
▼
┌──────────────┐
│ Tech Writer │ ─── 문서 업데이트 필요 시
└──────────────┘
공유 아티팩트
| 파일 | 용도 | 작성자 | 소비자 |
|------|------|--------|--------|
| .context/plan.md | 구현 계획 | CTO | 모든 Lead |
| .context/review.md | Planning Advisor 피드백 | Planning Advisor | CTO |
| CLAUDE.md | 프로젝트 가이드 | Tech Writer | 모든 에이전트 |
핸드오프 프로토콜
CTO → Planning Advisor
## 계획 검토 요청
plan.md 경로: .context/plan.md
주요 변경: [IPC 추가 / 시스템 연동 / UI 변경 / ...]
예상 위험도: [저 / 중 / 고]
Planning Advisor → CTO
## 계획 검토 결과
위험도: [저 / 중 / 고]
Codex 검증: [수행 / 생략]
### 이슈
1. ...
### 권고
1. ...
결론: [수정 필요 / 진행 가능]
CTO → Lead
## 작업 할당
담당: [FE Lead / Electron Lead / Platform Lead]
plan.md 섹션: [해당 섹션 참조]
성공 기준: [구체적 기준]
협업 필요: [다른 Lead와 협업 필요 시]
Lead → Lead (협업)
## 협업 요청
요청자: [FE Lead]
대상: [Electron Lead]
내용: IPC 채널 `jobs:newChannel` 추가 필요
스펙:
- 입력: { ... }
- 출력: { ... }
Lead → UX Lead (UI 검토)
## UI 검토 요청
변경 컴포넌트: [JobCard, LogViewer, ...]
스크린샷: [첨부 또는 dev server URL]
체크 포인트:
- 디자인 시스템 준수
- 레이아웃 깨짐
Lead → Tech Writer
## 문서 업데이트 요청
변경 내용: [새 IPC 채널 / 새 타입 / ...]
업데이트 대상: [CLAUDE.md / README.md]
IPC 변경 시 필수 협업
IPC 채널 추가/수정은 반드시 세 곳을 동시에 변경해야 함:
Electron Lead: src/main/ipc.ts (핸들러)
│
├──▶ src/preload/index.ts (contextBridge)
│
└──▶ FE Lead: src/renderer/global.d.ts (타입)
협업 순서:
- Electron Lead가 ipc.ts + preload/index.ts 수정
- FE Lead에게 global.d.ts 타입 정의 요청
- FE Lead가 렌더러에서 사용
에스컬레이션
Lead → CTO
다음 상황에서 CTO에게 에스컬레이션:
- 계획에 명시되지 않은 추가 변경 필요
- 다른 Lead와 의견 충돌
- 기술적 결정이 필요한 상황
Planning Advisor → CTO
다음 상황에서 계획 수정 요청:
- Codex가 심각한 이슈 발견
- 누락된 파일/변경사항 발견
- 실행 불가능한 계획
완료 조건
모든 작업은 다음을 만족해야 완료:
bun run test # 전체 통과
bun run build # 타입 에러 없음
추가로 plan.md에 명시된 성공 기준 충족.
Other skills for the same job
different authors, same section of the catalogue
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
Replace with description of the skill and when Claude should use it.
Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
This skill should be used when the user wants to "create a skill", "add a skill to plugin", "write a new skill", "improve skill description", "organize skill content", or needs guidance on skill structure, progressive disclosure, or skill development best practices for Claude Code plugins.
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
Use when creating new skills, editing existing skills, or verifying skills work before deployment
How to use it
Take majiayu000/agent-interaction from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.