AGENT SKILL

content-guide

스타트업 콘텐츠 제작 가이드 — 유형별(blog/sns/pr/email) 구조 템플릿과 .planning/business/brand-voice.md 스키마·5문항 인터뷰 규격을 제공한다. Use when: /content-draft 실행, 블로그·SNS·보도자료·뉴스레터 초안 작성, 브랜드 보이스 정의·갱신, content draft, brand voice, press release, newsletter, copywriting 작업 시. 콘텐츠 '전략'(채널 선택·캘린더·퍼널)은 growth-hacking-guide, 표시광고법·광고성 정보 규제의 법적 판정은 legal 플러그인 /compliance-check로 위임 — 이 스킬은 작성 규격만 다룬다. Startup content production guide providing structure templates per type (blog/sns/pr/email) plus the .planning/business/brand-voice.md schema and 5-question interview spec. Use when: running /content-draft, drafting blog posts, SNS copy, press releases, or newsletters, or defining/updating a brand voice; strategy goes to growth-hacking-guide, legal rulings to /compliance-check.

License 许可
Apache-2.0
最近更新
2026-10-29
Stars
★ 1
Forks
0

01 前言 Front Matter

name
content-guide
metadata
{ "version": "1.0.0", "category": "marketing" }
description
스타트업 콘텐츠 제작 가이드 — 유형별(blog/sns/pr/email) 구조 템플릿과 .planning/business/brand-voice.md 스키마·5문항 인터뷰 규격을 제공한다. Use when: /content-draft 실행, 블로그·SNS·보도자료·뉴스레터 초안 작성, 브랜드 보이스 정의·갱신, content draft, brand voice, press release, newsletter, copywriting 작업 시. 콘텐츠 '전략'(채널 선택·캘린더·퍼널)은 growth-hacking-guide, 표시광고법·광고성 정보 규제의 법적 판정은 legal 플러그인 /compliance-check로 위임 — 이 스킬은 작성 규격만 다룬다. Startup content production guide providing structure templates per type (blog/sns/pr/email) plus the .planning/business/brand-voice.md schema and 5-question interview spec. Use when: running /content-draft, drafting blog posts, SNS copy, press releases, or newsletters, or defining/updating a brand voice; strategy goes to growth-hacking-guide, legal rulings to /compliance-check.

02 资源文件 4

03 SKILL.md 正文

Content Guide — 콘텐츠 제작 가이드

콘텐츠의 톤 일관성은 세션 기억이 아니라 파일이 보장한다('상태는 파일에'). 이 스킬은 그 기준 파일인 brand-voice.md의 스키마와, 유형별 콘텐츠 구조 템플릿을 정의한다.

When to Apply

  • /content-draft가 brand-voice.md를 물화(최초 인터뷰)하거나 참조해 초안을 쓸 때
  • growth-marketer가 블로그·SNS·보도자료·이메일 콘텐츠를 작성·검수할 때
  • 브랜드 보이스를 새로 정의하거나 갱신(--revoice)할 때
  • 콘텐츠 초안의 브랜드·리스크 셀프 체크 기준이 필요할 때

brand-voice.md — 물화 규칙과 스키마

물화 규칙

규칙 내용
위치 고정 .planning/business/brand-voice.md — 모든 콘텐츠 생성이 이 경로를 Read
인터뷰는 최초 1회 파일이 있으면 인터뷰 없이 참조만. 갱신은 --revoice 또는 직접 편집
기본값 승계 lean-canvas.md(UVP·세그먼트), market-research.md(세그먼트·차별점)가 있으면 인터뷰 기본값으로 제안
근거 자산 공백 허용 근거 자산이 "없음"이면 그대로 기록 — 이후 초안에서 수치·사례 창작이 금지되고 [근거 필요] 표기가 강제된다

5문항 인터뷰 규격

# 질문 기록 섹션
1 어떤 문체·성격으로 말하는 브랜드인가? (해요체/합니다체 + 형용사 2~3개) ## 톤
2 절대 쓰면 안 되는 단어·표현은? (과장·비방·내부 용어) ## 금지 표현
3 주 독자는 누구이고 사전 지식 수준은? ## 타깃 독자
4 모든 콘텐츠가 반복해야 할 핵심 메시지 1~3개는? ## 핵심 메시지
5 주장을 뒷받침할 근거 자산은? (수치·고객 사례·수상·인증) ## 근거 자산

파일 스키마

# 브랜드 보이스: [제품/회사명]

## 톤
- 문체: 합니다체 (보도자료·이메일), 해요체 (SNS)
- 성격: 전문적이되 과장 없는, 개발자에게 솔직한

## 금지 표현
- "최고", "유일한", "혁신적인" (근거 없는 절대 표현)
- "간단하게", "쉽게" (독자의 난이도 경험을 단정)
- 경쟁사 실명 비방

## 타깃 독자
- 주 독자: [세그먼트 — 예: 5~50인 스타트업의 백엔드 개발자]
- 사전 지식: [예: 검색 인프라 운영 경험 있음, 마케팅 용어에는 낯섦]

## 핵심 메시지
1. [예: 검색 인프라 운영 시간을 주 10시간 → 1시간으로 줄인다]
2. [예: 설정 3줄로 시작한다]

## 근거 자산
| 자산 | 내용 | 출처/검증 |
|------|------|-----------|
| 베타 지표 | 파일럿 3개 팀 평균 운영 시간 87% 감소 | 내부 계측 (2026-05) |
| 고객 사례 | A사 도입 후기 인용 허락 확보 | 인터뷰 녹취 |

유형별 구조 템플릿 개요

상세 구조·분량·작성 팁·골격 예시는 references/에 위임한다. 초안 작성 전 해당 유형 파일을 읽는다.

유형 핵심 구조 (한 줄) 상세
blog 후킹 제목 → 문제 공감 리드 → 소제목 본문(근거) → CTA references/blog-template.md
sns 첫 줄 훅 → 본문 1메시지 → CTA/해시태그 (플랫폼별 분량 상이) references/sns-template.md
pr 역피라미드: 헤드라인 → 리드(5W1H) → 본문·인용문 → 보일러플레이트 references/pr-template.md
email 제목줄+프리헤더 → 본문 1주제 → CTA 1개 + (광고성이면) 법정 표기 references/email-template.md

공통 품질 체크리스트

초안 완성 후 셀프 체크. 하나라도 실패하면 산출 전에 교정한다.

# 체크 판정 방법
1 금지 표현 잔존 0건 brand-voice.md ## 금지 표현 항목을 Grep
2 무근거 수치·주장 0건 ## 근거 자산에 없는 수치는 [근거 필요] 표기 유지
3 핵심 메시지 1개 이상 포함 ## 핵심 메시지와 대조
4 톤·문체 일치 ## 톤의 문체 규칙과 대조 (유형별 예외는 톤 섹션에 명시된 대로)
5 표시광고법 리스크 표현 점검 아래 리스크 표현 표 대조 → 감지 시 1줄 안내

표시광고법 리스크 표현 (감지용 요약)

감지 시 결과 보고에 1줄 안내만 남긴다: legal 플러그인 /compliance-check --regulation ecommerce 검토 권장. 적법/위법 판정은 이 스킬의 범위 밖이다 — 문서 수준 협업 규약으로 안내까지만.

유형 리스크 표현 예 낮은 리스크 대안
절대적 표현 최고, 유일, 1위, 업계 최초 근거·조사기관·시점 병기 시에만 사용
보장성 표현 100% 보장, 무조건, 확실히 조건·범위를 명시한 서술
비교 단정 OO보다 2배 빠름 (근거 없음) 자체 벤치마크 조건 병기 또는 삭제
효능 단정 매출이 오릅니다, 반드시 개선 고객 사례 인용 ("A사는 ~했다")
부당 유인 지금만, 곧 마감 (사실 아님) 실제 기한·수량이 있을 때만

이메일의 광고성 정보 표기 의무((광고) 표기·수신거부 안내 등)는 references/email-template.md §법정 표기에서 다룬다.

References

파일 내용
references/blog-template.md 블로그 구조(TOFU/MOFU/BOFU별)·제목 공식·SEO 기본·골격 예시
references/sns-template.md 플랫폼별(LinkedIn/X/Instagram/Threads) 분량·훅 공식·골격 예시
references/pr-template.md 보도자료 역피라미드 구조·인용문 규칙·배포 체크리스트·골격 예시
references/email-template.md 이메일 유형별 구조·제목줄 규칙·CTA 원칙·광고성 정보 법정 표기·골격 예시

04 同仓库更多 Skills

Dokkabei97
Dokkabei97/dokkabei-harness

sync-claude-md

커밋·푸시·PR/MR 직전에 이번 변경이 프로젝트 CLAUDE.md 를 낡게 만드는지 검토하고, 필요할 때만 갱신 diff 를 제안한다 — 아키텍처·디렉터리 구조, 새 통합/MCP, 컨벤션, 빌드·CI·도구, 주요 의존성 변화가 대상. 해당 없으면 한 줄로 끝낸다. Reviews whether pending changes make the project CLAUDE.md stale (architecture, integrations, conventions, build/CI/tooling, major dependencies) and proposes a minimal update diff only when needed. Use when: "CLAUDE.md 갱신 필요해?", "CLAUDE.md 동기화", 커밋/푸시/MR 전에 구조·도구가 바뀐 변경을 정리할 때, sync CLAUDE.md, check CLAUDE.md before commit or PR.

Skill与智能体开发
★ 1
Dokkabei97
Dokkabei97/dokkabei-harness

spec-driven-dev

새 기능·프로젝트·큰 변경을 코드보다 스펙 먼저로 진행하는 게이트 워크플로(SPECIFY → PLAN → TASKS → IMPLEMENT) — 가정 명시, 측정 가능한 성공 기준, Always/Ask/Never 경계, 단계별 사람 검토로 범위 이탈과 재작업을 줄인다. Spec-before-code gated workflow for new features or significant changes: explicit assumptions, measurable success criteria, boundaries, and a human review between stages. Use when: "스펙 먼저", "기능 명세", "요구사항 정리", starting a new feature or project, a significant change with vague requirements. 단순 버그 수정·1~2줄 변경엔 불필요.

开发工程师Skill与智能体开发
★ 1
Dokkabei97
Dokkabei97/dokkabei-harness

shipping-guide

프로덕션 배포 전후 가이드 — 배포 전 체크리스트, 피처 플래그 수명주기, 단계적 롤아웃과 진행/보류/롤백 임계값, 롤백 계획 템플릿, 배포 후 모니터링. Production shipping guide: pre-launch checklist, feature-flag lifecycle, staged rollout with go/hold/rollback thresholds, rollback plan template, post-launch monitoring. Use when: "배포 준비", "릴리즈 전 점검", "롤아웃 계획", "롤백 계획", preparing a production deploy, staged rollout, feature flags.

★ 1
Dokkabei97
Dokkabei97/dokkabei-harness

retro

세션 회고·교훈 컴파운딩 — 이번 세션의 교정·실수·발견을 추출해 품질 기준(재현·일반화·판정 가능성)으로 거르고, 컨벤션 변화는 sync-claude-md 위임, 반복 실수는 tasks/lessons.md(#가드-훅-후보 태그), 스킬 지식 갱신은 수정 제안으로 나눈다. 모든 적용은 승인 후. Session retrospective that turns corrections, mistakes, and discoveries into vetted lessons routed to CLAUDE.md sync, tasks/lessons.md, or skill-edit proposals, with user approval before any write. Use when: "회고", "레트로", "교훈 정리", "같은 실수 반복", "재발 방지 규칙", retrospective, lessons learned, wrapping up a task, review, or loop. 여러 실행에 걸친 하네스 개선은 harness:evolve.

★ 1
Dokkabei97
Dokkabei97/dokkabei-harness

project-rules

현재 프로젝트의 스택(빌드 파일 버전, 마이그레이션 도구, ORM 유무, ES 사용, git 호스트)을 감지해 프로젝트 루트 AGENTS.md 의 마커 블록(스택 사실 + 항상 적용되는 스페셜리스트 핵심 ≤15줄 — Claude Code·Codex·Antigravity 공통)과 CLAUDE.md 의 `@AGENTS.md` 연결, Claude 전용 경로 한정 .claude/rules/<stack>-specialist.md(해당 버전에 실제로 맞는 상세 함정)를 diff 로 제안하고, 스택 플러그인을 런타임별로 프로젝트 범위에서 켜는 법을 안내한다. 이전 버전 출력(CLAUDE.md 블록·specialist-core.md)은 AGENTS.md 로 이전을 제안. --check 는 버전 불일치·사라진 ID·크기 한도·연결 누락을 점검. Detects the project's stack and proposes a cross-runtime AGENTS.md block (stack facts + always-on specialist core) linked from CLAUDE.md via @AGENTS.md, plus Claude-only path-scoped specialist rules; migrates the older CLAUDE.md-block layout; --check audits drift. Use when: "이 프로젝트 세팅", "프로젝트 규칙 생성", "AGENTS.md/CLAUDE.md 점검", project setup, generate project rules, audit AGENTS.md or CLAUDE.md drift.

开发工程师
★ 1
Dokkabei97
Dokkabei97/dokkabei-harness

post-merge

MR 머지 완료 후 Plane 이슈 종료와 Outline 문서 업데이트를 자동으로 처리하는 오케스트레이터 스킬입니다. issue-tracker와 document-latest 스킬을 연계 실행하여 머지 후 후속 작업을 일괄 처리합니다. Orchestrates post-merge follow-up after an MR is merged: chains the issue-tracker and document-latest skills to close the Plane issue and update Outline wiki docs in a single batch. Use when: an MR was just merged, closing tickets and syncing documentation after a merge, post-merge cleanup.

文档处理Skill与智能体开发
★ 1