본문으로 건너뛰기

EP12. 구조 기반 워크플로우 생성 스킬

🏛️ 스킬을 만드는 메타 엔진과 7단계 Meta Snowflake

지난 두 에피소드에서는 구조가 모호한 백지상태에서 ASR을 식별하고, ADR로 대안을 가려내며, Spec을 통해 점진적으로 결과물을 시공해 나가는 산출물 생성 파이프라인을 보았습니다.

이 범용적인 파이프라인은 '구조가 명확하지 않은 상황'을 철저히 전제합니다. 그런데 만약 "슬라이드 덱 발표 자료"나 "테크 블로그 시리즈"처럼 이미 검증되고 정형화된 고유의 빌드업 워크플로우가 있는 산출물이라면 어떨까요? ASR을 식별하고 ADR을 검토하는 일은 비효율적일 것입니다.

바로 이러한 특정 산출물 맞춤형 전용 스킬(document-authoring, presentation-authoring 등)들을 필요에 따라 설계하고 생성하는 존재가 바로 generating-skill-creation입니다. 최종 산출물이 아니라 그 산출물을 생성하는 절차 자체를 설계하고 박제하는 '메타-스킬'의 심장을 열어보겠습니다.


🧩 산출물을 해체하는 5대 프리즘

새로운 전용 생성 스킬을 설계하라는 명을 받으면, generating-skill-creation은 대상 산출물을 다섯 가지 핵심 차원으로 가차 없이 분해하여 분석합니다.

구성 요소역할블로그 시리즈 스킬 예시이미지 생성 스킬 예시
과업과 제약*(Assignment & Constraints)*범위, 품질 기준, 금기 사항, 성공 조건시리즈 주제, 예상 독자층, 에피소드 수해상도, 파일 형식, 색상 제한
맥락과 규칙*(Context & Rules)*도메인 특화 규칙, 세계관, 스타일 가이드블로그 플랫폼 특성, 톤앤매너브랜드 가이드라인, 색상 팔레트
개체*(Entities)*재사용 가능한 개별 구성 요소 단위각 에피소드 본문, 개요 문서아이콘, 로고, 캐릭터 에셋
공간과 배치*(Space & Placement)*물리적/시각적 위치, 레이아웃 영역시리즈 아크에서의 에피소드 순서캔버스 구성, 오브젝트 배치 규칙
구조와 흐름*(Structure & Flow)*계층적 콘텐츠 전개 및 위계 구조서론 → 본론 → 결론의 흐름레이어 순서, 시각적 계층 구조

❄️ 7단계 Meta Snowflake 파이프라인

스킬을 저작할 때 Cocrates는 일회성 프롬프트 뭉치를 툭 던지지 않습니다. 설계도가 완전히 확정되기 전까지는 실제 코드나 마크다운 파일을 생성하지 않는다는 Snowflake 엄격 통제 규칙 하에 총 7단계의 빌드 프로세스를 밟습니다.

[1. Kernel] ─→ [2. Components] ─→ [3. Frame] ─→ [4. Outline] ─→ [5. Spec] ─→ [6. Skill] ─→ [7. Verification]

1. Kernel (한 문장 정의)

스킬의 정체성과 미션을 단 한 문장으로 정의합니다. 이 뼈대가 흔들리면 다음 단계로 절대 이행하지 않습니다.

"이 스킬은 [대상 상황]에서 [산출물 유형]을 [검토 가능한 단계]를 거쳐 생성하도록 돕는다."

2. Components (차원 식별)

위에서 명시한 5대 프리즘(과업, 맥락, 개체, 공간, 구조)을 기반으로 스킬이 핸들링해야 할 요소들을 완벽하게 카탈로그화합니다.

3. Frame (워크플로우 설계)

새로운 스킬이 가지게 될 5단계 Snowflake 워크플로우와 중간 산출물 파일 구조, 그리고 유저의 승인 지점(Gate)을 설계합니다.

4. Outline (단계별 명세 확정)

각 워크플로우 단계에서 탄생할 중간 산출물 파일들의 Input, Creation activity, Completion criteria, Review questions, Approval criteria를 촘촘히 규정합니다. 중간 결과물이 채팅창에 휘발되지 않고 파일 시스템에 안착하게 만드는 핵심 안전장치입니다.

5. Spec (명세 조립)

최종 .SKILL.md에 들어갈 frontmatter 구조, 사용 시점, 구체적 절차, 대화 규칙, 금지 사항을 빠짐없이 텍스트로 확정 짓습니다.

6. Skill (스킬 파일 생성)

승인된 Spec을 유일한 근거로 삼아 최종 시스템 경로인 .opencode/skills/{skill-slug}/SKILL.md 파일을 시공합니다.

7. Verification (하네스 검증)

만들어진 파일이 Cocrates 생성 하네스 엔진의 명세 규칙을 완벽히 준수하며 정상 구동하는지 최종 테스트합니다.


🚫 메타 엔진의 금지 조항 (Constraints)

generating-skill-creation이 구동되는 동안, 에이전트는 아래의 철칙을 위반할 수 없습니다.

  • 적합한 생성 스킬이 없다는 이유로 임의로 최종 산출물부터 대충 구워내는 행위 금지.
  • 산출물의 다차원 구조 분석을 생략한 채 SKILL.md 템플릿만 영혼 없이 채우는 행위 금지.
  • 사용자의 검토 및 승인 지점이 누락된 독단적인 생성 스킬 설계 금지.
  • 중간 산출물을 파일로 격리하지 않고 채팅 로그에만 방치하는 행위 금지.

📝 세 줄 요약

  1. generating-skill-creation은 결과물이 아닌 '요리법' 자체를 시스템에 영구 추가하는 메타-스킬입니다.
  2. 산출물을 과업, 맥락, 개체, 공간, 구조의 5대 차원으로 해체하여 정교한 전용 워크플로우를 유도합니다.
  3. 이렇게 탄생한 전용 스킬은 이후 동일한 유형의 생성 요청 시 시스템에 자동 로드되어 무한히 재사용되고 사용자와 함께 진화합니다.

🎬 다음 편 예고

우리는 드디어 Cocrates Harness가 자랑하는 아키텍처 기반의 모든 핵심 구조적 활동(Learning 파이프라인 → Artifact Generation 파이프라인 → Meta Skill 저작 엔진)을 전부 마스터했습니다!

Cocrates의 모든 설계 비밀을 완벽하게 이해한 지금, 이 강력한 프레임워크를 아끼고 발전시키기 위해 우리가 가져야 할 올바른 사용자의 다짐과 에이전트 하네스의 지속 가능한 진화 방식은 무엇일까요? 대단원의 막을 내리는 마지막 에피소드에서 확인하시죠!

"시스템에 스킬을 박제하는 순간, 당신의 노하우는 AI의 유전자에 영원히 각인됩니다."


이 시리즈는 Cocrates Harness 프레임워크를 소개합니다. Cocrates는 소크라테스식 대화로 사용자가 주도권을 잡고 성장하도록 설계된 에이전트 하네스입니다.