Smokefarmer/multi-agent-delivery-skill

다중 에이전트 전달

개요

이 스킬은 작업이 구조화된 계획, 병렬 구현, 명시적 검토, 그리고 완료 보고 전 실제 검증 단계를 필요로 할 정도로 큰 경우 사용합니다.

위임 오버헤드가 작업 자체보다 큰 단일 파일 수정과 같은 아주 작은 작업에는 이 스킬을 사용하지 마십시오.

워크플로

1. 변경 전 검사

• 편집을 제안하기 전에 관련 코드 경로를 읽습니다.
• 중요 경로의 즉각적인 차단 요소를 식별합니다.
• 차단 작업과 병렬로 실행할 수 있는 부수적 작업을 구분합니다.

2. 간단한 실행 계획 작성

• 중요한 작업의 경우 실질적인 편집 전에 간결한 계획을 작성합니다.
• 한 번에 정확히 한 단계만 진행 상태로 유지합니다.
• 범위가 변경되거나 분석에서 구현, 검증으로 전환될 때 계획을 업데이트합니다.

3. 작업을 비중복 조각으로 분할

• 메인 스레드는 통합, 충돌 해결, 최종 검증을 담당합니다.
• 탐색기(explorer)는 제한된 코드베이스 질문이나 핫스팟 발견에 사용합니다.
• 작업자(worker)는 명시적 파일 소유권을 가진 구체적인 구현 조각에 사용합니다.
• 각 작업자에게 비중복 쓰기 범위를 부여하고, 관련 없는 더티 워크트리 변경사항을 되돌리지 않도록 지시합니다.
• 다음 작업이 즉시 의존하는 긴급 중요 경로 작업은 로컬에서 처리합니다.

4. 명확한 소유권으로 위임

모든 작업자 프롬프트에는 다음이 포함되어야 합니다:

• 소유하는 정확한 파일이나 모듈
• 기대하는 구체적인 결과
• 다른 에이전트도 저장소를 편집 중이라는 경고
• 소유권 밖의 파일을 건드리지 말라는 지시
• 대상 검증 및 변경 파일 요약 요청

5. 구현 후 검토

• 코드 변경 후 통합된 결과에 대해 최소 한 번의 검토 패스를 실행합니다.
• 인증, 입력 처리, RPC, 결제 또는 트랜잭션 작업에 대해 보안 중심 검토를 추가합니다.
• 스마트 계약 변경에 대해 Rust/Anchor 검토를 추가합니다.
• 완료 보고 전에 심각도가 높은 검토 결과를 수정합니다.

6. 완료 전 검증

영향받은 계층에 대해 가장 강력한 실용적 검증을 실행합니다:

• 타입 검사
• 린트
• 테스트
• 해당되는 경우 계약 빌드/테스트

광범위한 정리 캠페인의 경우 먼저 조각별로 대상 검증을 실행한 다음, 영향받은 계층에 대해 전체 저장소 수준 패스를 실행합니다.

필수 검증이 여전히 실패 중인데 "완료"되었다고 보고하지 마십시오.

7. 결과를 명확하게 보고

최종 보고서에는 다음이 포함되어야 합니다:

• 상위 수준에서 무엇이 변경되었는지
• 어떤 검증이 통과했는지 (가능한 경우 개수 포함)
• 남아있는 기술 부채 또는 잔여 위험
• 실행되지 않은 항목 (있는 경우)

위임 규칙

• 쓰기 범위가 겹치지 않을 때만 병렬 에이전트를 선호합니다.
• 메인 스레드와 작업자 간에 작업을 중복하지 마십시오.
• wait_agent를 아껴 사용하고, 에이전트가 실행되는 동안 유용한 로컬 작업을 계속 수행하십시오.
• 더 이상 필요하지 않은 완료된 에이전트는 종료하십시오.

권장 패턴

일반적인 중요 작업의 경우:

1. 검사하고 간단한 계획을 작성합니다.
2. 핫스팟 분석이 필요하면 탐색기 1개를 생성합니다.
3. 비중복 조각에 대해 작업자 1-3개를 생성합니다.
4. 작업자가 실행되는 동안 로컬 통합 작업을 계속합니다.
5. 결과를 통합하고 로컬에서 충돌을 해결합니다.
6. 검토 패스를 실행합니다.
7. 전체 검증을 실행합니다.
8. 결과와 남은 기술 부채를 보고합니다.