스킬·플러그인·어댑터 확장하기

목적

이 lesson은 기여자·확장 개발자가 Open Design에서 다음 판단을 안전하게 하기 위한 절차입니다.

언제 쓰나

스킬·플러그인·어댑터 확장하기가 현재 목표일 때 사용합니다. 다른 목표라면 Workflow Map에서 다른 흐름을 먼저 선택하세요.

준비물

• Repo 문서 또는 설치 경로를 볼 수 있어야 합니다.
• 필요한 경우 Docker, Node 24, pnpm 10.33.x, agent CLI 또는 API 키를 준비합니다.
• 이 패키지는 live 실행을 하지 않았으므로 현장 값은 실제 환경에서 다시 읽습니다.

단계별 확인

1. 1 스킬 구조 읽기: SKILL.md frontmatter와 references/assets 구성을 확인합니다.
   docs/skills-protocol.md 확인
2. 2 디자인 시스템 추가: DESIGN.md resolver와 catalog 흐름을 봅니다.
   docs/design-systems.md 확인
3. 3 새 agent 연결 판단: ACP/stdout/JSONL 등 adapter interface를 확인합니다.
   docs/agent-adapters.md interface 확인
4. 4 예제와 검증 연결: 예시 output과 QA/테스트 문서로 기여 범위를 좁힙니다.
   docs/testing 및 CONTRIBUTING.md 확인

구체 증거

흔한 실수

• 기여 전에는 기능명보다 protocol/metadata가 현재 registry에 어떻게 읽히는지 먼저 확인합니다.
• 새 기능을 바로 코드로 넣기 전에 skill metadata, design-system resolver, adapter interface 중 어느 레이어인지 먼저 나눕니다.

검증 / readback

다음 질문에 답할 수 있으면 이 lesson의 기본 이해는 통과입니다.

• 이 흐름의 첫 입력은 무엇인가?
• 성공을 어떤 파일, 화면, 명령 결과, 문서 근거로 확인하는가?
• 다음 단계로 가기 전에 멈춰야 하는 조건은 무엇인가?

근거

• docs/skills-protocol.md 확인
• docs/design-systems.md 확인
• docs/agent-adapters.md interface 확인
• docs/testing 및 CONTRIBUTING.md 확인

다음 판단

확장 범위가 정해지면 해당 docs/spec와 테스트 경로를 읽고 작은 예제부터 검증합니다.

검증 경계

이 lesson은 repo/docs와 포함된 screenshot 근거의 정적 매뉴얼입니다. 실제 서버 실행, 현재 UI label, agent 인증 성공, 생성 품질은 현장 검증이 필요합니다.