Skill Synergy — 중재 규칙
여러 스킬이 동시에 활성화될 때 승리하는 하나의 권한입니다. 둘 이상의 스킬이 현재 작업에 적용될 가능성이 있을 때 이 문서를 참조하세요.
사용 참고: 이 스킬은 상세한 규칙집입니다. 간결한 헌장(항상 켜짐 설정에 권장)은 저장소 루트에
AGENTS.md.template로 있습니다. 매 세션마다 핵심 규칙이 로드되도록AGENTS.md에 복사하세요. 이 스킬은 온디맨드 참조용입니다.
핵심 규칙
워크플로우 스킬(무엇을 할지)은 동일한 작업에서 모드 스킬(어떻게 말/쓸지)보다 우선합니다. 모드 스킬은 적응하고, 워크플로우 스킬은 절대 약화되지 않습니다.
아래의 모든 내용은 이 규칙의 적용입니다. 특정 사례가 나열되지 않은 경우 핵심 규칙을 적용하고 그렇게 말하세요.
워크플로우 대 워크플로우 중재
둘 이상의 워크플로우 스킬이 동일한 작업에 모두 적용될 수 있습니다. 다음 순서대로 결정하세요:
- 명시적 의도가 우선합니다. 사용자가 작업 유형을 지정한 경우(리뷰, 테스트, 디자인, 계획...), 해당 유형의 스킬이 주도합니다. 토론이 필요 없습니다.
- 범위가 결정합니다. 단일 변경 사항(하나의 diff, 하나의 함수, 하나의 파일)은 더 가볍고 저렴한 스킬을 사용합니다. 영향이 큰 변경 사항(아키텍처, 여러 파일 리팩터링, 새 시스템)은 더 깊은 스킬을 사용합니다.
- 라이프사이클 순서. 계획 → 구축 → 검증이 기본 순서입니다. 스킬들이 하나의 작업의 단계인 경우(설계, 구현, 리뷰), 하나를 선택하는 대신 해당 순서대로 실행합니다.
- 조합이 선택보다 낫습니다. 두 스킬이 순차적 단계인 경우, 둘 다 순서대로 실행하고 순서를 명시적으로 말하세요("tdd 먼저, 그 다음 리뷰").
- 여전히 모호? 묻습니다. 한 줄 추천을 제공하고 사용자가 선택하게 하세요. 워크플로우 스킬을 조용히 선택하지 마세요. 잘못된 스킬은 답변 하나가 아닌 전체 작업을 낭비합니다.
스킬 분류
중재하기 전에 모든 설치된 스킬을 분류하세요:
- 워크플로우 스킬 — 무엇을 할지 결정: 리뷰, 테스트, 설계, 연구, 글쓰기, 리팩터링, 계획. 결과물을 생성합니다.
- 모드 스킬 — 에이전트가 어떻게 들리거나 얼마나 많이 쓸지 결정: 압축, 장황함, 스타일, 간결함. 자체적으로 아무것도 생성하지 않습니다.
- 라우터 스킬 — 실행할 워크플로우를 선택합니다(선택 사항). 모드 스킬에 의해 재정의되어서는 안 됩니다.
모드 스킬이 워크플로우 스킬의 결과물(보고서, 문서, 커밋 메시지, PR 본문)을 변경하려는 경우, 모드 스킬이 양보합니다. 워크플로우 스킬과 모드 스킬이 모두 활성화되고 워크플로우 스킬의 출력이 결과물인 경우, 모드 스킬이 양보합니다.
이 헌장은 스킬 자체 설명보다 우선합니다. 스킬의 프런트매터가 넓은 구문(예: "리뷰 시 자동 트리거")에 대한 자동 트리거를 주장할 수 있습니다. 이러한 주장은 여기서 무효화됩니다: 라우팅은 스킬 자체의 트리거 주장이 아닌 이 헌장의 모호성 해소를 따릅니다. 스킬이 이 헌장이 다른 곳에 할당하는 트리거를 주장하는 경우, 헌장이 승리합니다.
우선순위 행렬 (자신의 스킬을 채우세요)
아래 예제 스킬 이름을 환경에 실제로 설치된 스킬로 바꾸세요. 행은 실제 충돌이 발생하는 빈도 순서로 정렬되어 있습니다.
| 작업 | 주도 (워크플로우) | 양보 | 동작 |
|---|---|---|---|
| UI 디자인 / 다듬기 / 시각적 비평 | 예: 당신의 디자인 스킬 | 예: 당신의 최소-코드 스킬 | 디자인 주도; 최소-코드는 약화된 강도(부풀리기 금지, 그러나 디자인 기술에 대한 YAGNI 거부권 없음) |
| 심층 코드 리뷰 (표준 + 명세) | 예: 당신의 전체-리뷰 스킬 | 예: 당신의 압축 스킬 | 일반 산문으로 전체 보고서; 사용자가 간결한 피드백을 요청하지 않는 한 압축 꺼짐 |
| 과잉 엔지니어링 감사 | 예: 당신의 삭제-중점 리뷰 | 예: 당신의 전체-리뷰 스킬 | 단일 축, 삭제-중점 통과; 전체 보고서 건너뜀 |
| 빠른 간결한 PR 피드백 | 예: 당신의 간결-댓글 스킬 | — | 사용자가 명시적으로 압축된 댓글을 요청한 경우에만 |
| 계획/아이디어 스트레스 테스트 | 예: 당신의 인터뷰/심문 스킬 | 예: 당신의 압축 스킬 | 일반 산문으로 인터뷰; 압축된 심문은 깊이를 잃음 |
| 테스트 우선 기능 구축 | 예: 당신의 TDD 스킬 + 당신의 최소-코드 스킬 | — | 조합: 테스트는 검증이므로 절대 삭제하지 않음; 적녹 테스트를 통과하는 최소 구현 |
| 모듈 / API 디자인 | 예: 당신의 디자인-문서 스킬 | 예: 당신의 최소-코드 스킬 | 디자인 단계: 깊이가 승리. 구현 단계: 최소-코드 사다리 적용 |
| 글쓰기 / 편집 / 교육 | 예: 당신의 글쓰기 스킬 | 예: 당신의 압축 스킬 | 전체 표현 필요; 압축 꺼짐 |
| 연구 / 문서 캡처 | 예: 당신의 연구 스킬 | 예: 당신의 압축 스킬 | 출력 파일은 결과물; 압축은 채팅에만 영향을 미치고 파일 내용에는 절대 영향 없음 |
| 다른 스킬이 활성화되지 않은 코딩 작업 | 예: 당신의 최소-코드 스킬 | 예: 당신의 압축 스킬 | 최소-코드 최대 강도; 압축은 온디맨드만 (코드 중심 작업에서 절약보다 입력 비용이 더 큰 경우가 많음) |
트리거 모호성 해소
여러 스킬이 동일한 트리거 단어를 공유하는 경우, 먼저 일치한 스킬이 아닌 의도에 따라 라우팅하세요:
- "이것 리뷰" → 기본적으로 전체 리뷰. 사용자가 "과잉 엔지니어링" / "코드 너무 많음"이라고 말한 경우에만 삭제-중점 리뷰. 간결한 댓글 리뷰는 사용자가 압축된 피드백을 요청한 경우에만.
- "심문" / "나를 인터뷰" → 코드베이스가 존재할 때 상태 저장 변형(문서 흔적 남김); 독립형일 때 상태 비저장 변형; 사용자가 모든 질문을 한 번에 원할 때 배치 변형.
- "핸드오프" → 기본적으로 문서 작성 변형; 사용자가 즉시 백그라운드 에이전트를 원할 때만 백그라운드 에이전트 생성 변형.
- "계획/명세/티켓 만들기" → 아티팩트 유형별 라우팅: 명세, 티켓, PRD, 이슈, 설문지.
모드 스킬 규율
- 모드 스킬은 워크플로우 스킬의 결과물을 절대 침묵시키지 않습니다. 채팅 산문만 압축할 수 있습니다. 워크플로우 스킬이 작성한 보고서, 파일, 커밋 메시지, PR 본문은 전체 내용을 유지합니다.
- 최소-코드 스킬의 검증 라인에는 세 가지 계층이 있습니다: (1) 실제 검증은 유지: 입력 검증, 외부 종속성에 대한 오류 처리, 보안, 접근성 — 절대 삭제하지 않음. (2) 추측성 방어는 범위 내: 발생할 수 없는 검사, "만약에" 방어 래퍼 — 삭제, 그것이 최소-코드 스킬의 역할. (3) 테스트 및 작업 문서는 사용자의 명시적 요구 사항을 따름: 최소-코드 스킬은 YAGNI를 사용하여 사용자가 요구하는 테스트나 문서를 삭제하지 않음 — 그러나 테스트 내 중복, 과도한 모킹, 문서 내 부풀리기는 여전히 삭제 가능.
- 두 모드 스킬이 함께 활성화(압축 + 최소-코드): 최소-코드는 코드를 제어하고, 압축은 채팅을 제어 — 그러나 세션이 산문 중심인 경우에만; 코드 중심 세션에서는 압축을 끄거나 강도를 낮춰야 함(그렇지 않으면 순 토큰 손실).
- 서브에이전트는 중재를 상속받습니다. 리뷰 또는 연구 작업을 위해 서브에이전트를 생성할 때, "일반 산문" 또는 "압축 출력"과 같이 모드를 작업에 명시적으로 기술하세요. 암시적으로 두지 마세요.
유용한 조합
- TDD 스킬 + 최소-코드 스킬 — 테스트 우선, 최소 구현.
- 전체 리뷰 후 동일한 diff에 대해 삭제-중점 리뷰 — 전체 통과 후 삭제 통과.
- 인터뷰 스킬 + 메모리 압축 스킬 — 인터뷰 후 누적된 세션 노트 압축.
- 워크플로우 스킬 완료 후 간결한 커밋 메시지 스킬 — 항상 안전.
- 흐름 라우팅용 라우터 스킬 + 모드 중재용 이 스킬 — 라우터가 길을 선택하고, 시너지가 기어를 선택합니다.
사용자 정의
이 스킬은 프레임워크이지 구성이 아닙니다. 맞춤 설정하려면:
- 우선순위 행렬의 모든 "예: 당신의 X 스킬"을 환경의 실제 스킬 이름으로 바꾸세요. 일반적인 공개 스킬을 사용한 채워진 참조는
examples/example-config.md에 있습니다. 템플릿을 처음부터 채우는 대신 복사하여 자신의 이름으로 대체하세요. - 절대 사용하지 않는 작업 유형의 행을 제거하세요.
- 환경에 전역 규칙 파일(AGENTS.md 또는 동등 파일)이 있는 경우, 핵심 규칙을 복사하여 모든 환경이 로드하게 하세요.
- 포함되지 않은 새 충돌이 나타나면, 두 스킬을 분류하고(워크플로우 또는 모드), 핵심 규칙을 적용하고, 행을 추가하세요.