TheStreamCode/agentic-rd-skill

Agentic R&D 워크플로우

이 독립형 스킬 패키지를 사용하여 현재 워크스페이스 내에서 마크다운 우선의 멀티에이전트 연구 워크플로우를 자동화하세요.

이는 Agent Laboratory 패턴을 일반화한 것으로, 독립적인 증거 검토, 협력적 계획 수립, 작업 실행 또는 조사, 결과 분석, 품질 검토 및 최종 보고서 작성을 포함합니다. 과학적 연구에 국한되지 않으며, 제품, 비즈니스, 기술, 전략, 법률, 규정 준수, 보안, UX, 시장 및 운영 사용 사례에 동일한 실험실 워크플로우를 적용할 수 있습니다.

파일 시스템 접근이 가능한 스킬 호환 코딩 에이전트를 위해 설계되었습니다. 환경이 지원하는 경우 실제 병렬 서브에이전트를 선호하며, 실제 서브에이전트를 사용할 수 없는 경우에만 격리된 시뮬레이션 패스를 사용하세요.

패키지 내용

• SKILL.md: 활성화 규칙 및 핵심 운영 지침.
• references/generalized-lab-model.md: 범용 Agent Laboratory 모델 및 사용 사례 매핑.
• references/workflow.md: 전체 단계 시퀀스 및 승인 게이트.
• references/agent-roles.md: 전문가 역할 선택 가이드.
• references/quality-rules.md: 증거, 불확실성, 검토 및 안전 표준.
• references/implementation-notes.md: 설치, 스캐폴드, 서브에이전트 및 파일 처리 참고 사항.
• references/example-run.md: 예상 파일 트레일과 출력 품질을 보여주는 간결한 엔드투엔드 예제.
• assets/templates/: 모든 워크플로우 파일을 위한 마크다운 템플릿.
• scripts/init-rd-workflow.mjs: 선택적 스캐폴드 스크립트.
• scripts/validate-skill.mjs: 공개 스킬 패키지의 저장소 유효성 검사.

첫 번째 작업

1. 현재 워크스페이스에서 project-brief.md를 찾습니다.
2. 존재하는 경우 다른 워크플로우 단계보다 먼저 완전히 읽습니다.
3. 존재하지 않고 사용자가 충분한 컨텍스트를 제공한 경우 assets/templates/project-brief.md를 사용하여 생성합니다.
4. 필수 컨텍스트가 누락된 경우, 최소한의 차단 질문만 합니다.
5. Brief가 존재한 후에는 일반 워크플로우 단계 사이에 허가를 요청하지 않고 계속 진행합니다.

scripts/init-rd-workflow.mjs를 실행하여 project-brief.md와 필요한 work/ 파일을 스캐폴드합니다. 이 스크립트는 work/06-final-output.md를 생성해서는 안 됩니다.

필수 출력

활성 워크스페이스에 다음 구조를 생성하고 사용하세요:

work/
├── 00-lab-notes.md
├── 01-orchestration-plan.md
├── 02-specialist-outputs/
├── 03-team-collaboration.md
├── 04-cross-review-notes.md
├── 05-stage-gate-review.md
└── 06-final-output.md

각 워크플로우 단계는 특정 출력 경로에 매핑됩니다. 번호가 매겨진 실험실 단계(증거 검토, 계획 수립, 실행, 결과 분석)는 별도의 파일이 아닙니다. 각 전문가별로 하나의 파일로 work/02-specialist-outputs/ 내에 구체화됩니다.

단계	출력 경로
실험실 설정	work/00-lab-notes.md
오케스트레이션	work/01-orchestration-plan.md
증거 검토, 계획, 실행, 결과 (전문가당 하나의 파일)	work/02-specialist-outputs/NN-<역할>.md
팀 협업 (오케스트레이터가 통합)	work/03-team-collaboration.md
교차 검토	work/04-cross-review-notes.md
단계 게이트 검토	work/05-stage-gate-review.md
최종 종합	work/06-final-output.md

work/05-stage-gate-review.md가 승인됨(Approved)이라고 말할 때까지 work/06-final-output.md를 생성하거나 작성하지 마십시오.

워크플로우

1. 정식 단계 시퀀스를 위해 references/workflow.md를 읽습니다.
2. 사용자의 사용 사례를 실험실 단계에 매핑하려면 references/generalized-lab-model.md를 읽습니다.
3. 전문가를 선택하기 전에 references/agent-roles.md를 읽습니다.
4. 교차 검토, 단계 게이트 검토 및 최종 종합 전에 references/quality-rules.md를 읽습니다.
5. 스크립트 사용, 서브에이전트 동작 및 파일 처리 세부 정보는 references/implementation-notes.md를 사용합니다.
6. 생성된 워크플로우 파일에는 assets/templates/의 템플릿을 사용합니다.
7. 예상 출력 품질에 대해 확신이 없을 때는 references/example-run.md에서 작업된 엔드투엔드 예제를 참조하세요.

Brief에 맞게 규모 조정

워크플로우의 규모를 Brief에 맞게 조정하십시오. 작은 질문에 전체 다중 웨이브 실험실을 실행하지 마십시오.

• 사소한 Brief: 오케스트레이터가 서브에이전트 없이 단일 인라인 패스를 수행할 수 있습니다. work/00-lab-notes.md에 증거, 가정 및 위험을 기록하고, 짧은 work/05-stage-gate-review.md 자체 점검 후 work/06-final-output.md를 작성합니다. 이 수준에서는 중간 전문가, 협업 및 교차 검토 파일은 선택 사항입니다. 단계 게이트 규칙은 여전히 유효합니다: 05-stage-gate-review.md가 승인됨(Approved)이라고 말할 때까지 06-final-output.md를 작성하지 마십시오.
• 소규모 또는 좁은 Brief: 한두 명의 전문가를 사용하고 단일 웨이브를 실행하며, 협업은 별도의 교환 대신 오케스트레이터의 노트에 포함시킵니다. 교차 검토, 단계 게이트 검토 및 최종 종합을 각각 하나의 빠른 패스로 유지합니다.
• 중간 규모 Brief: 가벼운 팀 협업 단계를 통해 한두 웨이브에 걸쳐 몇 명의 전문가를 사용합니다.
• 대규모 또는 규제된 Brief: 전체 단계 시퀀스, 여러 웨이브, 명시적 팀 협업 및 관련 검토 역할을 사용합니다.

규모에 관계없이 필수 최소 사항을 항상 유지하십시오: 증거/컨텍스트 검토, 계획 수립, 실행 또는 조사, 결과 분석, 위험/가정 커버리지, 최종 종합 전 단계 게이트 품질 게이트. 다른 모든 것은 선택 사항이며 결과물을 실질적으로 변경할 때만 추가됩니다. 확장 세부 사항은 references/generalized-lab-model.md를 참조하십시오.

실행 규칙

• Brief를 잘 다루는 최소한의 전문가 역할을 선택하십시오.
• 항상 증거/컨텍스트 검토, 계획 수립, 실행 또는 조사, 결과 분석 및 위험/가정 커버리지를 포함하십시오.
• 실제 병렬 서브에이전트를 선호하십시오. 이는 선택적 개선이 아니라 이 스킬의 기본 실행 모델입니다.
• 각 단계에서 결과를 기다리기 전에 모든 독립적인 전문가를 시작하십시오. 병렬 서브에이전트를 사용할 수 있을 때 독립적인 전문가를 하나씩 실행하지 마십시오.
• 그렇지 않은 경우 전문가를 격리된 패스로 시뮬레이션하십시오. 각 패스는 자체 파일을 작성하기 전에 Brief, 오케스트레이션 계획 및 할당된 범위만 읽어야 합니다.
• 전문가 분석, 교차 검토, 단계 게이트 검토 및 최종 종합을 하나의 응답으로 축소하지 마십시오.
• 독립적인 전문가 작업은 병렬화하되, 종속성 게이트는 순차적으로 유지하십시오: 검토 전 계획, 계획 전 실행, 실행 전 결과 분석, 검토 전 최종 보고서.
• 출처를 사용할 수 있는 경우 사실적 주장에 대해 인용 또는 출처 노트를 요구하십시오.
• 지원되지 않는 주장은 가정 또는 추론으로 표시하십시오.
• 불확실성과 규제된 검토 경계를 유지하십시오.

협업 팀 프로토콜

• 서브에이전트를 단절된 보고서 작성자가 아닌 협업 팀으로 취급하십시오.
• 마스터 오케스트레이터는 work/01-orchestration-plan.md에서 팀 역할, 소유권, 종속성 및 협업 규칙을 정의합니다.
• 각 서브에이전트는 자체 전문가 출력 파일만 작성하고, 자신의 질문, 종속성, 불일치 및 인계 노트를 오케스트레이터에게 반환합니다(공유 파일을 편집하지 않고 결과에 포함하여).
• 오케스트레이터는 반환된 노트를 work/03-team-collaboration.md로 통합합니다. 여러 서브에이전트가 동시에 동일한 파일을 작성하도록 하지 마십시오.
• 팀은 교차 검토 전에 공유 가정을 조정해야 합니다.
• 교차 검토는 전문가 출력과 팀 협업 기록을 모두 평가합니다.
• 최종 종합은 해결된 동의, 해결되지 않은 불일치 및 중요한 소수 의견을 반영해야 합니다.

중지 조건

다음 경우에만 중지하고 사용자에게 질문하십시오:

• 주제 또는 목표를 식별할 수 없는 경우.
• 원하는 출력을 추론할 수 없는 경우.
• 주요 제약 조건이 충돌하는 경우.
• 필수 외부 데이터, 자격 증명, 비공개 시스템, 유료 도구 또는 사용할 수 없는 네트워크 접근이 작업을 차단하는 경우.
• 법률, 의료, 재무, 규정 준수, 보안 또는 안전에 중요한 조언을 안전한 정보 경계 내에서 유지할 수 없는 경우.

완료

워크플로우가 완료되면 생성된 파일과 단계 게이트가 최종 종합을 승인했는지 여부를 사용자에게 알려주십시오. 완료 메시지를 간결하게 유지하십시오.