Communitygithub.com

oukeming64-tech/marketing-agent-skill

환경 인식형 오픈소스 에이전트 스킬로, 마케팅 글쓰기, 이미지 및 비디오 워크플로우를 지원합니다.

marketing-agent-skill란 무엇인가요?

이 스킬은 AI 에이전트(예: Claude Code, Cursor, Codex 등)가 마케팅 작업을 수행할 때, 현재 환경을 자동으로 인식하고 최적의 도구와 워크플로우를 선택하도록 돕는 오픈소스 패키지입니다. 스킬은 글쓰기, 브랜드 보이스 구축, 이미지 생성, 비디오 제작, 워크플로우 진화 등 여러 하위 스킬로 구성되어 있으며, 각 스킬은 독립적인 계약(SKILL.md)에 따라 작동합니다. 주요 특징으로는 먼저 환경(네트워크, 설치된 도구, 권한 등)을 진단한 후, 사전 승인된 온라인 서비스, 기존 설치 도구, 또는 후보 도구 목록에서 최소 실행 가능한 경로를 선택합니다. 또한 회사 사실, 브랜드 보이스, 승인 정책 등 규칙 파일을 우선 참조하여 사실에 기반한 표현을 보장합니다. 이 스킬은 마케팅 팀이 기술적 세부 사항(예: 소프트웨어 설치, 모델 선택)에 신경 쓰지 않고 비즈니스 입력과 최종 승인에 집중할 수 있도록 설계되었으며, AI 에이전트가 모든 기술적 결정(도구 라우팅, 환경 진단, 품질 검증)을 처리합니다. 최종 결과물은 실제 파일로 제공되며, 게시 전 별도 승인이 필요합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add oukeming64-tech/marketing-agent-skill

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

마케팅 에이전트 스킬

현재 구현 경계

현재 버전은 0.5.1입니다.

  • 독립형 카피라이팅: skills/copywriting/SKILL.md로 이동합니다.
  • 회사 보이스 및 리더십 스타일 추출: skills/brand-voice-builder/SKILL.md로 이동합니다.
  • 이미지 작업: skills/image-creation/SKILL.md로 이동합니다.
  • 비디오 작업: skills/video-promo/SKILL.md로 이동합니다.
  • 통합형 워크플로우 진화: skills/workflow-evolution/SKILL.md로 이동합니다.
  • 비디오용 스크립트, 나레이션 및 자막: 카피라이팅과 비디오 스킬을 동시에 사용합니다.
  • 프로모션 웹페이지: 현재 이 에이전트 범위를 벗어나므로 라우팅, 패키징, 검수 대상이 아닙니다. 웹페이지 카피는 순수 텍스트 작업으로 처리할 수 있습니다.

후보 도구, 개발 머신 기능, 명령어 존재 또는 과거 성공을 현재 환경에서 이미 사용 가능한 것으로 서술해서는 안 됩니다.

모든 작업 전 필독

작업을 판단하고 납품을 약속하기 전에 다음을 완전히 읽으십시오:

  1. rules/operating-boundary.md
  2. rules/company-facts.md
  3. rules/approval-policy.md

플랫폼 가져오기에 따라 상대 경로가 변경될 경우, 현재 스킬 패키지 내에서 파일 이름으로 찾으십시오. 검색 결과에서 임시로 다른 규칙을 다운로드하여 이 패키지의 규칙을 대체해서는 안 됩니다.

담당자

  • 마케팅 부서 담당자: 비즈니스 입력 및 판단 담당: 홍보 대상, 대상, 채널, 목표, 공개 가능한 사실, 자료 권리 및 금지 콘텐츠를 제공하거나 확인합니다. 방향성과 최종 버전을 승인합니다. 마케팅 부서 담당자는 소프트웨어, 모델, 플러그인 또는 설치 방식을 미리 선택할 필요가 없습니다.
  • 마스터 에이전트: 사전 조사 담당: 제공된 자료를 읽고, 먼저 현재 환경을 감지한 후, 역량 요구 사항을 파악하고 현재 역량과 도구 후보 목록에서 최소 실행 가능한 경로를 선택합니다. 실행, 검증, 기록, 정직하게 다운그레이드합니다.
  • 전문 하위 스킬: 영역 방법론 담당: 카피라이팅, 스타일, 이미지, 비디오는 각각의 계약에 따라 작동하며, 사실, 권한, 게시 경계를 넘지 않습니다.
  • 워크플로우 진화 스킬: 방법 상속 담당: 반복적으로 발생하는 효과적인 개선 사항을 기록하고, 실험을 격리하며 검증합니다. 임계값을 통과하고 담당자가 승인한 버전만 조직 오버레이로 다음 사용자에게 전달합니다.
  • IT/플랫폼 관리자: 새로운 역량 정책 담당: 허용된 서비스, 계정, 네트워크, 설치 범위, 데이터 업로드, 비용 및 롤백을 관리합니다. 후보 ID, 소스 도메인 또는 설치 범위별로 사전 승인할 수 있습니다.
  • 콘텐츠 책임자: 검수 및 게시 담당: 사실, 브랜드, 규정 준수, 저작자 표시 및 비즈니스 효과를 최종적으로 판단합니다. 방향성 확인은 게시 승인과 동일하지 않습니다.

도구 및 역량 라우팅

실행 순서는 고정되어 있습니다:

  1. 승인된 온라인 역량 우선. 네트워크, 서비스 허용 목록, 계정/할당량 및 자료 업로드 권한이 모두 충족된 경우에만 온라인 생성, 변환, 디지털 휴먼 또는 미디어 서비스를 호출합니다.
  2. 설치된 역량 재사용. 현재 장치에 이미 존재하고, 버전이 호환되며, 짧은 예제를 통해 검증된 도구를 우선 재사용하며, 반복 설치하지 않습니다.
  3. 후보 목록에서 최적 획득. 여전히 핵심 역량이 부족하고 네트워크 및 설치 정책이 허용하는 경우, references/tool-candidates.json을 읽고 시스템, 아키텍처, 작업, 라이선스, 소스 및 리소스 요구 사항에 따라 edit/tool-acquisition-plan.md을 생성합니다. 명시적 승인을 받거나 사전 승인 정책에 해당하는 경우에만 공식 소스 또는 신뢰할 수 있는 시스템 패키지 관리자에서 획득 및 설치합니다.
  4. 오프라인 시 대체 목록 생성. 현재 장치가 네트워크에 연결되지 않은 경우 다운로드 가능하다고 주장하지 않습니다. 설치된 도구를 재사용합니다. 여전히 역량이 부족하고 추후 설치가 허용되는 경우, 정확한 오프라인 전송 목록을 출력하여 네트워크 연결 장치가 동일한 공식 소스에서 다운로드, 검증 및 수동으로 전송하도록 합니다.
  5. 수동 핸드오프 보장. 설치가 금지되었거나, 소스/라이선스가 불분명하거나, 호환 가능한 후보가 없거나, 실제 미리보기 체인이 불완전한 경우, 수행 가능한 부분을 완료하고 W1/I1/V1 등의 수동 핸드오프 패키지로 전달합니다.

후보 목록은 공개적이고 감사 가능한 선택 범위일 뿐이며, 설치 권한, 외부 업로드 권한, 유료 권한 또는 제품 보증을 의미하지 않습니다. 스킬 패키지는 도구 바이너리, 모델 가중치, 계정, 키 또는 회사 자료를 포함하지 않습니다.

마스터 워크플로우

  1. 사실이 표현보다 우선. rules/company-facts.md를 읽습니다. 검증되지 않은 사실이 있을 때 고객, 데이터, 역량 또는 약속을 만들어 내지 않습니다.
  2. 먼저 현재 환경을 감지한 후 납품을 약속합니다. 이 작업에 필요한 시스템/아키텍처, 권한 읽기/쓰기, 플랫폼 역량, 기존 도구, 네트워크, 설치 정책, 업로드/비용 및 실제 미리보기 체인만 확인하고 edit/environment-report.md에 기록합니다.
  3. 작업 역량에서 도구를 역으로 추론합니다. 먼저 변환, 렌더링, 자막, 이미지 생성 등 어떤 역량이 필요한지 명확히 정의한 후 도구를 선택합니다. 도구를 설치하기 위해 작업을 역으로 확장해서는 안 됩니다.
  4. 먼저 방향성을 확인한 후 고비용 제작을 진행합니다. 이미지/비디오의 공식 생성, 편집, 대량 더빙 및 렌더링 전에 방향성 확인을 기다립니다. 일반적인 가역적 카피라이팅은 브리핑이 충분할 경우 직접 후보 원고를 생성할 수 있습니다.
  5. 실제 결과물이 등급을 결정합니다. 실제 미리보기 없이 완성본이라고 할 수 없으며, 열 수 있는 프로젝트 파일 없이 편집 가능한 드래프트라고 할 수 없습니다.
  6. 게시는 별도 확인이 필요합니다. 업로드, 전송, 클라우드 렌더링, 공개 링크, 저작자 표시 및 외부 게시는 반드시 재확인해야 합니다.
  7. 검증된 방법을 상속하고, 입증되지 않은 선호는 상속하지 않습니다. 작업이 공유 진화 워크스페이스에 명시적으로 바인딩되거나 작업 루트 디렉토리에 marketing-agent-evolution/이 있는 경우, 먼저 기본 스킬 버전 0.5.1을 사용하여 current.json, 전체 증명 해시 체인 및 버전 호환성을 검증한 후 resolve-task를 실행합니다. 로딩 순서는 고정되어 있습니다: 마스터 → 필요 시 도구 라우팅 → 교차 도메인 → 하위 도메인 → 주 도메인. 더 구체적인 오버레이는 자신의 책임 내에서만 메서드를 구체화할 수 있습니다. 관련 오버레이 검증 실패 또는 기본 버전 불일치 시 이 패키지의 기본 규칙을 사용하고, 재검증 후에야 수락을 요청합니다. 오버레이를 찾기 위해 권한 없는 디렉토리를 스캔해서는 안 됩니다.
  8. 후보는 자동으로 메인 워크플로우를 수정할 수 없으며, 현재 포인터도 자동으로 수정할 수 없습니다. 반복 수정, 성공적인 프로젝트 또는 외부 스킬은 먼저 후보로만 진입할 수 있습니다. 동일한 주제의 A/B 테스트, 미지의 작업, 원래 역량 회귀, 독립적 검토 및 명시적 승인 없이 현재 조직 버전에 기록되거나 사실, 승인, 완료 등급 또는 게시 경계를 덮어쓸 수 없습니다. current.json의 모든 변경 사항은 해시 체인 연결된 수락/롤백 승인 이벤트와 일치해야 합니다.

라우팅

카피라이팅 요청

사용자가 초고 작성, 수정, 다듬기, AI 톤 제거, 위챗 공식 계정, 보도자료, 제품 소개, 이벤트 원고, 연설문, 웹페이지 카피, 나레이션 또는 자막을 요청하는 경우:

  1. skills/copywriting/SKILL.md를 완전히 읽습니다.
  2. references/writing-quality-contract.md를 읽습니다.
  3. 작업 디렉토리에 이미 검증된 회사 보이스 또는 리더십 선호도 프로필이 있는 경우 해당 버전에 따라 실행합니다. 그렇지 않으면 리더십 스타일이 보정되었다고 주장해서는 안 됩니다.

회사 보이스 또는 리더십 스타일 추출

사용자가 과거 기사, 리더십 코멘트, 선정된 원고 또는 수정 전후 원고에서 스타일을 추출하도록 요청하는 경우:

  1. skills/brand-voice-builder/SKILL.md를 완전히 읽습니다.
  2. 먼저 권한 있는 워크스페이스를 스캔합니다. 승인된 웹페이지 역량이 있는 경우 공식 웹사이트, 위챗 공식 계정 등 공개 기사를 추가로 발견합니다.
  3. 샘플 인덱스를 구축하고 유보 세트를 격리한 후 회사 보이스 및 리더십 선호도 오버레이를 추출합니다.

이미지 요청

사용자가 이미지 생성, 삽화, 일러스트레이션, 메인 비주얼, 포스터 배경, 표지, 참조 이미지 수정, 프롬프트 역추출 또는 스타일 전이를 요청하는 경우:

  1. skills/image-creation/SKILL.md를 완전히 읽습니다.
  2. 먼저 최종 제출 프롬프트를 공개한 후, 현재 플랫폼 역량에 따라 생성, 편집, 역추출 또는 다운그레이드하여 납품합니다.

비디오 요청

사용자가 프로모션 비디오, 나레이션, 인터뷰 편집, 숏폼 비디오, 스토리보드, 나레이션, 자막, 모션 그래픽, 디지털 휴먼, CapCut 드래프트 또는 완성본을 요청하는 경우:

  1. skills/video-promo/SKILL.md를 완전히 읽습니다.
  2. references/video-tool-routing.md 및 references/tool-candidates.md를 읽습니다.
  3. 비디오 스킬에 따라 역량 확인, 도구 선택, 전략 확인, 제작 및 검수를 완료합니다.

스크립트, 나레이션 또는 자막이 관련된 경우 카피라이팅 스킬도 동시에 읽습니다. 정적 첫 프레임, 참조 이미지 또는 이미지 프롬프트가 필요한 경우 이미지 스킬도 동시에 읽습니다.

워크플로우 최적화, 통합 또는 진화 요청

사용자가 외부 스킬 흡수, 성공적인 방법 고정, 프로세스 자체 업그레이드, 또는 동일한 수정에 대해 최소 두 번의 독립적인 증거가 있는 경우:

  1. skills/workflow-evolution/SKILL.md를 완전히 읽습니다.
  2. references/workflow-evolution-contract.md를 읽습니다.
  3. 먼저 현재 비즈니스 작업을 완료합니다. 그런 다음 증거를 후보로 기록하고, "한 번의 실험에서 하나의 변수만 변경" 원칙에 따라 격리된 버전을 구축합니다.
  4. 동일한 주제의 A/B 테스트, 미지의 작업, 원래 역량 회귀 및 독립적 검토를 통과한 경우에만 업그레이드 제안을 생성합니다. 담당자가 명시적으로 수락한 후에야 현재 조직 버전을 업데이트합니다.

한 번의 성공, 한 번의 선호 또는 일회성 수정은 후보로만 남을 수 있으며 직접 진화라고 할 수 없습니다. 이 에이전트의 기본 워크플로우 규칙을 변경하는 경우 두 명의 독립적인 검토자와 담당자의 명시적인 기본 워크플로우 변경 승인이 추가로 필요합니다.

일반 상호작용 프로토콜

  1. 대화, 첨부 파일, 권한 있는 디렉토리 및 확인된 공식 소스를 자동으로 읽습니다. 디렉토리 찾기, 도구 선택 및 설치 방법 판단을 마케팅 부서 담당자에게 되돌리지 않습니다.
  2. 실제 테스트됨, UI에서 확인됨, 미검증 및 명시적 금지를 구분합니다. 명령어 존재가 역량 사용 가능을 의미하지는 않습니다.
  3. 자동 획득 후에도 여전히 누락되어 결과를 변경할 수 있는 비즈니스 정보에 대해서만 질문하며, 원칙적으로 4개 질문을 초과하지 않습니다.
  4. 사람이 직접 판단할 수 있는 방향성, 실행 전략, 도구 선택 이유, 현재 제한 사항 및 예상 W/I/V 등급을 제공합니다.
  5. 새 도구가 필요한 경우 먼저 획득 계획을 생성합니다. 승인되지 않은 경우 계획 단계에서 중단하고 설치를 실행하지 않습니다.
  6. 실제 파일, 완료 등급, 검증 증거, 미실행 항목 및 명확한 핸드오프 담당자를 전달합니다.
  7. 최종 게시는 권한 있는 사람의 확인이 필요합니다.
  8. 재사용 가능한 개선 사항을 발견하면 권한 있는 공유 디렉토리에 후보로 기록할 수 있습니다. 후보 실험이 이번 납품을 차단하지 않도록 하며, "후보 기록됨"을 "진화 완료"로 표현하지 않습니다.

출력 규칙

모든 작업 산출물은 현재 비즈니스 작업 디렉토리에 기록하며, 이 스킬 자체에는 기록하지 않습니다:

  • 환경 보고서: edit/environment-report.md
  • 도구 획득/오프라인 전송 계획: edit/tool-acquisition-plan.md
  • 비디오 역량 보고서: edit/capability-report.md
  • 카피라이팅, 스타일, 이미지 및 비디오 프로세스 파일: 각각 작업 디렉토리의 edit/ 하위 디렉토리에 저장

조직 워크플로우 진화 기록은 별도의 공유 marketing-agent-evolution/ 워크스페이스에 기록하며, 단일 작업 디렉토리나 이 스킬 패키지를 직접 수정하지 않습니다. 해당 워크스페이스는 비식별화된 증거 스냅샷, 후보, 실험, 평가, 제안, 수락된 버전 및 롤백 기록을 저장합니다. 개인 채팅 메모리가 이를 대체할 수 없습니다.

파일을 쓸 수 없는 경우 대화에서 동일한 필드를 보고합니다.

관련 스킬