compound
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinesecompound 스킬
Compound Skill
목적: 길드 운영 과정에서 검증된 인사이트를 즉시 문서화하여, 팀 지식을 복리로 성장시키는 검색 가능한 지식 베이스를 구축한다.
目的: 将公会运营过程中经过验证的洞察即时文档化,构建可检索的知识库,让团队知识实现复利式增长。
개요
概述
이 스킬은 인사이트가 확인되는 즉시 포착하여, YAML frontmatter 기반의 구조화된 문서로 저장한다. 카테고리별 단일 파일 아키텍처를 사용하며, 각 인사이트는 에 저장된다.
knowledge/solutions/[category]/[filename].md<critical_sequence name="insight-capture" enforce_order="strict">
该技能会在洞察被确认的瞬间进行捕获,并以基于YAML frontmatter的结构化文档形式存储。采用按类别划分的单文件架构,每条洞察将存储在路径下。
knowledge/solutions/[category]/[filename].md<critical_sequence name="insight-capture" enforce_order="strict">
7단계 프로세스
7步流程
<step number="1" required="true">
<step number="1" required="true">
Step 1: 트리거 감지
Step 1: 触发检测
자동 감지 문구 (대화에서 인식):
- "이거 잘 됐다"
- "이 방식이 좋네"
- "다음에도 이렇게 하자"
- "이건 기록해두자"
- "이 포맷이 먹혔다"
- "고객이 좋아했어"
- "이 프레임워크가 통했다"
- "이게 효과가 있었어"
- "이렇게 하니까 됐어"
OR 수동: 커맨드
/compoundNon-trivial만 (재사용 가치 있는 인사이트):
- 팀이 반복할 수 있는 패턴
- 다른 상황에도 적용 가능한 교훈
- 시행착오 끝에 발견한 방법
- 파트너/고객이 검증한 접근법
- 조직 운영에 구조적 개선을 가져온 발견
스킵 기준:
- 이 상황에서만 통하는 일회성 방법
- 단순 사실 기록 (수치, 날짜 등)
- 이미 문서화된 내용의 반복
- 아직 검증되지 않은 가설 </step>
自动检测语句(对话中识别):
- "这个做得不错"
- "这种方式很好"
- "以后就这么做"
- "这个要记录下来"
- "这个格式生效了"
- "客户很喜欢"
- "这个框架成功了"
- "这个很有效果"
- "这么做就成了"
或手动触发: 命令
/compound仅捕获非琐碎内容(具备复用价值的洞察):
- 团队可重复使用的模式
- 可应用于其他场景的经验教训
- 历经试错后发现的方法
- 经合作伙伴/客户验证的方法
- 为组织运营带来结构性改进的发现
跳过标准:
- 仅适用于当前场景的一次性方法
- 单纯的事实记录(数值、日期等)
- 已文档化内容的重复
- 尚未验证的假设 </step>
Step 2: 컨텍스트 수집
Step 2: 上下文收集
대화 이력에서 추출:
필수 정보:
- domain: guild / contents / community / business / knowledge
- insight_type: 인사이트 유형 (schema.yaml enum 참조)
- component: 도메인 내 하위 컴포넌트 (schema.yaml enum 참조)
- context: 어떤 상황에서 나온 인사이트인가 (1-3문장)
- key_learning: 핵심 교훈 한 문장 (다른 상황에도 일반화 가능하게)
- impact: critical / high / medium / low
- tags: 검색 키워드 (소문자, 하이픈 구분)
추가 수집 항목:
- 배경: 어떤 프로젝트/활동 중이었는가
- 시도한 것들: 효과 없었던 접근들
- 효과 있었던 것: 실제로 작동한 방법
- 작동 이유: 왜 효과적이었는가
- 재현 조건: 언제 이 방법을 쓸 수 있는가
BLOCKING 요건: domain, insight_type, 핵심 인사이트가 불분명한 경우 사용자에게 질문하고 응답을 기다린다:
문서화를 위해 몇 가지 확인이 필요합니다:
1. 어떤 도메인인가요? (guild/contents/community/business/knowledge)
2. 인사이트 유형은? (예: content_pattern, consulting_pattern, process_improvement...)
3. 핵심 교훈을 한 문장으로 정리하면?
[응답 후 계속 진행]从对话历史中提取:
必填信息:
- domain: guild / contents / community / business / knowledge
- insight_type: 洞察类型(参考schema.yaml枚举值)
- component: 领域内的子组件(参考schema.yaml枚举值)
- context: 该洞察出自何种场景(1-3句话)
- key_learning: 核心经验教训(一句话,需具备场景普适性)
- impact: critical / high / medium / low
- tags: 搜索关键词(小写,连字符分隔)
额外收集项:
- 背景: 当时正在开展哪个项目/活动
- 尝试过的方法: 无效的尝试
- 有效的方法: 实际奏效的方式
- 奏效原因: 为何该方法有效
- 复用条件: 何时可以使用该方法
阻塞要求: 若domain、insight_type或核心洞察不明确,需向用户提问并等待回复:
为完成文档化,需要确认以下几点:
1. 所属领域是?(guild/contents/community/business/knowledge)
2. 洞察类型是?(例如: content_pattern, consulting_pattern, process_improvement...)
3. 请用一句话总结核心经验教训?
[回复后继续]Step 3: 기존 문서 검색
Step 3: 现有文档检索
knowledge/solutions/bash
undefined在中检索相似洞察:
knowledge/solutions/bash
undefineddomain, tags, insight_type 기준으로 병렬 검색
基于domain、tags、insight_type进行并行检索
Grep: pattern="domain: [domain]" path=knowledge/solutions/ output_mode=files_with_matches
Grep: pattern="tags:.*[keyword]" path=knowledge/solutions/ output_mode=files_with_matches -i=true
Grep: pattern="insight_type: [type]" path=knowledge/solutions/ output_mode=files_with_matches
**유사 문서 발견 시** 사용자에게 선택지 제시 후 대기:
유사 문서 발견: knowledge/solutions/[path]
어떻게 할까요?
- 새 문서 생성 + 교차 참조 추가 (권장)
- 기존 문서 업데이트 (동일한 인사이트의 보완인 경우)
- 기타
선택 (1-3): _
사용자 응답 대기 후 선택한 액션 실행.
**유사 문서 없으면** Step 4로 바로 진행.
</step>
<step number="4" required="true" depends_on="2">Grep: pattern="domain: [domain]" path=knowledge/solutions/ output_mode=files_with_matches
Grep: pattern="tags:.*[keyword]" path=knowledge/solutions/ output_mode=files_with_matches -i=true
Grep: pattern="insight_type: [type]" path=knowledge/solutions/ output_mode=files_with_matches
**发现相似文档时**,向用户提供选项并等待回复:
发现相似文档: knowledge/solutions/[path]
请问如何处理?
- 创建新文档 + 添加交叉引用(推荐)
- 更新现有文档(为同一洞察的补充内容时)
- 其他
选择(1-3): _
等待用户回复后执行所选操作。
**未发现相似文档时**,直接进入Step 4。
</step>
<step number="4" required="true" depends_on="2">Step 4: 파일명 생성
Step 4: 文件名生成
형식:
YYYYMMDD-[sanitized-insight-slug].mdSanitization 규칙:
- 소문자
- 공백 → 하이픈
- 특수문자 제거 (하이픈 제외)
- 80자 미만으로 truncate
예시:
20260224-linkedin-hook-pattern.md20260224-workshop-icebreaker-framework.md20260224-weekly-sync-standup-format.md20260224-upstage-consulting-onboarding.md- </step>
20260224-meetup-networking-structure.md
格式:
YYYYMMDD-[sanitized-insight-slug].md清理规则:
- 小写
- 空格替换为连字符
- 移除特殊字符(连字符除外)
- 截断至80字符以内
示例:
20260224-linkedin-hook-pattern.md20260224-workshop-icebreaker-framework.md20260224-weekly-sync-standup-format.md20260224-upstage-consulting-onboarding.md- </step>
20260224-meetup-networking-structure.md
Step 5: YAML 검증 (BLOCKING)
Step 5: YAML验证(阻塞)
schema.yaml 기반으로 모든 필수 필드 검증.
<validation_gate name="yaml-schema" blocking="true">
검증 항목:
- : schema.yaml의 enum 값 중 하나
domain - : YYYY-MM-DD 형식
date - : schema.yaml의 enum 값 중 하나
insight_type - : 해당 domain에 매핑된 enum 값 중 하나 (
component확인)domain_component_mapping - : 20-300자, 구체적 상황 서술
context - : 10-200자, 일반화 가능한 교훈
key_learning - : critical / high / medium / low
impact - : 1-8개, 소문자 하이픈 구분
tags
검증 실패 시 Step 6 차단:
YAML 검증 실패
오류:
- domain: 허용된 값이 아님: "marketing" → guild, contents, community, business, knowledge 중 하나
- component: domain 'guild'에는 허용되지 않는 컴포넌트: "linkedin" → operations, culture, hiring, sync, decision-making, season-planning 중 하나
- tags: 대문자 포함 → 소문자로 변환 필요
수정된 값을 제공해주세요.GATE 강제: 모든 검증 통과 전까지 Step 6 진행 금지.
</validation_gate>
</step>
<step number="6" required="true" depends_on="5">基于schema.yaml验证所有必填字段。
<validation_gate name="yaml-schema" blocking="true">
验证项:
- : 必须是schema.yaml枚举值之一
domain - : 格式为YYYY-MM-DD
date - : 必须是schema.yaml枚举值之一
insight_type - : 必须是对应domain映射的枚举值之一(参考
component)domain_component_mapping - : 20-300字符,需具体描述场景
context - : 10-200字符,需具备普适性的经验教训
key_learning - : critical / high / medium / low
impact - : 1-8个,小写连字符分隔
tags
验证失败时将阻止进入Step 6:
YAML验证失败
错误:
- domain: 非允许值: "marketing" → 需为guild, contents, community, business, knowledge之一
- component: domain 'guild'不允许该组件: "linkedin" → 需为operations, culture, hiring, sync, decision-making, season-planning之一
- tags: 包含大写字母 → 需要转换为小写
请提供修正后的值。强制网关: 所有验证通过前,禁止进入Step 6。
</validation_gate>
</step>
<step number="6" required="true" depends_on="5">Step 6: 문서 작성
Step 6: 文档撰写
카테고리 디렉토리 결정: schema.yaml의 으로 insight_type → 저장 경로 매핑.
category_mapping문서 생성:
bash
INSIGHT_TYPE="[검증된 YAML에서]"
CATEGORY_DIR="[category_mapping에서 매핑]"
FILENAME="[Step 4에서 생성]"
DOC_PATH="${CATEGORY_DIR}${FILENAME}"确定类别目录: 通过schema.yaml的将insight_type映射到存储路径。
category_mapping文档生成:
bash
INSIGHT_TYPE="[从验证后的YAML中获取]"
CATEGORY_DIR="[从category_mapping中映射]"
FILENAME="[Step 4生成的文件名]"
DOC_PATH="${CATEGORY_DIR}${FILENAME}"디렉토리 없으면 생성
目录不存在则创建
mkdir -p "${CATEGORY_DIR}"
mkdir -p "${CATEGORY_DIR}"
assets/resolution-template.md 기반으로 문서 작성
基于assets/resolution-template.md撰写文档
(Step 2에서 수집한 컨텍스트 + Step 5에서 검증한 YAML frontmatter)
(包含Step 2收集的上下文 + Step 5验证通过的YAML frontmatter)
**결과:**
- 카테고리 디렉토리에 단일 파일 생성
- Enum 검증으로 일관된 분류 보장
</step>
<step number="7" required="false" depends_on="6">
**结果:**
- 在类别目录下生成单个文件
- 通过枚举验证确保分类一致性
</step>
<step number="7" required="false" depends_on="6">Step 7: 교차 참조 & 패턴 감지
Step 7: 交叉引用 & 模式检测
Step 3에서 유사 문서 발견된 경우:
bash
undefined若Step 3发现相似文档:
bash
undefined기존 문서에 Related 섹션 추가
向现有文档添加Related章节
새 문서에도 기존 문서 링크 추가
向新文档添加现有文档链接
**패턴 후보 감지:**
동일 카테고리에 유사 인사이트 3개 이상 존재하면:
패턴 문서 후보 감지: [카테고리]에 유사 인사이트 X개
→ patterns/ 문서로 종합하시겠습니까?
**Critical Pattern 승격 조건 (자동 승격 금지, 사용자 결정):**
- impact가 `critical`인 경우
- 여러 도메인에 횡단 적용 가능한 경우
- 팀 전체가 반드시 알아야 하는 경우
이 경우 Decision Menu에서 "2. 크리티컬 패턴에 추가" 옵션에 주석 추가:
💡 이 인사이트는 크리티컬 패턴 승격을 고려해볼 만합니다
</step>
</critical_sequence>
---
<decision_gate name="post-documentation" wait_for_user="true">
**模式候选检测:**
当同一类别中存在3个及以上相似洞察时:
检测到模式文档候选: [类别]下有X个相似洞察
→ 是否要将其整合到patterns/文档中?
**关键模式升级条件(禁止自动升级,需用户决策):**
- impact为`critical`时
- 可跨多个领域应用时
- 团队全体必须知晓时
此时在决策菜单的“2. 添加至关键模式”选项中添加注释:
💡 该洞察可考虑升级为关键模式
</step>
</critical_sequence>
---
<decision_gate name="post-documentation" wait_for_user="true">Decision Menu After Capture
捕获后的决策菜单
문서화 성공 후 선택지 제시 및 사용자 응답 대기:
인사이트가 기록되었습니다.
파일 생성:
- knowledge/solutions/[category]/[filename].md
다음 작업:
1. 계속 진행 (권장)
2. 크리티컬 패턴에 추가 - critical-patterns.md에 승격
3. 관련 문서 연결 - 유사 인사이트와 교차 참조
4. 기존 스킬에 추가 - .claude/skills/에 연결
5. 문서 확인 - 생성된 내용 보기
선택: _각 옵션 처리:
Option 1: 계속 진행
- 현재 작업/워크플로우로 복귀
- 문서화 완료
Option 2: 크리티컬 패턴에 추가
사용자가 선택하는 경우:
- 팀 전체에 반복 적용되는 패턴
- 절대 잊어서는 안 되는 교훈
- 비직관적이지만 필수적인 규칙
액션:
- 문서에서 패턴 추출
- assets/critical-pattern-template.md 형식으로 구조화
- 에 추가 (순번 유지)
knowledge/solutions/patterns/critical-patterns.md - 해당 문서에 교차 참조 추가
- 확인: "크리티컬 패턴에 추가되었습니다. 이후 learnings-researcher가 항상 이 패턴을 확인합니다."
Option 3: 관련 문서 연결
- 프롬프트: "어떤 문서와 연결할까요? (파일명 또는 주제 설명)"
- 에서 대상 문서 검색
knowledge/solutions/ - 양방향 교차 참조 추가
- 확인: "교차 참조가 추가되었습니다"
Option 4: 기존 스킬에 추가
- 프롬프트: "어떤 스킬에 추가할까요?"
- 의 적절한 파일에 링크와 설명 추가
.claude/skills/[skill-name]/ - 확인: "[skill-name] 스킬에 추가되었습니다"
Option 5: 문서 확인
- 생성된 문서 내용 표시
- Decision Menu 다시 제시
</decision_gate>
<integration_protocol>
文档化成功后,向用户提供选项并等待回复:
洞察已记录完成。
生成的文件:
- knowledge/solutions/[category]/[filename].md
后续操作:
1. 继续(推荐)
2. 添加至关键模式 - 升级到critical-patterns.md
3. 关联相关文档 - 与相似洞察添加交叉引用
4. 添加至现有Skill - 关联到.claude/skills/
5. 查看文档 - 查看生成的内容
选择: _各选项处理方式:
选项1: 继续
- 返回当前工作/工作流
- 文档化完成
选项2: 添加至关键模式
当用户选择时:
- 适用于可在团队全体复用的模式
- 绝对不可遗忘的经验教训
- 反直觉但必需的规则
操作:
- 从文档中提取模式
- 按照assets/critical-pattern-template.md格式结构化
- 添加到(保持序号)
knowledge/solutions/patterns/critical-patterns.md - 向对应文档添加交叉引用
- 确认提示: "已添加至关键模式。后续learnings-researcher将始终检查该模式。"
选项3: 关联相关文档
- 提示: "要关联哪个文档?(文件名或主题描述)"
- 在中检索目标文档
knowledge/solutions/ - 添加双向交叉引用
- 确认提示: "已添加交叉引用"
选项4: 添加至现有Skill
- 提示: "要添加到哪个Skill?"
- 在的对应文件中添加链接和说明
.claude/skills/[skill-name]/ - 确认提示: "已添加到[skill-name] Skill"
选项5: 查看文档
- 显示生成的文档内容
- 重新展示决策菜单
</decision_gate>
<integration_protocol>
통합 지점
集成点
호출 트리거:
- 커맨드 (주 인터페이스)
/compound - 대화 중 확인 문구 자동 감지
- 워크플로우 완료 후 수동 호출
호출하는 스킬/에이전트:
- 없음 (terminal 스킬 - 다른 스킬에 위임하지 않음)
Handoff 조건:
호출 전 대화 이력에 충분한 컨텍스트가 있어야 함.
</integration_protocol>
<success_criteria>
调用触发:
- 命令(主界面)
/compound - 对话中自动检测确认语句
- 工作流完成后手动调用
调用的Skill/Agent:
- 无(终端Skill - 不委托给其他Skill)
交接条件:
调用前对话历史需包含足够的上下文。
</integration_protocol>
<success_criteria>
성공 기준
成功标准
다음 모든 조건이 충족될 때 문서화 성공:
- YAML frontmatter 검증 통과 (모든 필수 필드, 올바른 형식, 유효한 enum 값)
- 에 파일 생성됨
knowledge/solutions/[category]/[filename].md - domain-component 매핑이 schema.yaml과 일치
- Context, What Worked, Why This Works 섹션이 구체적으로 작성됨
- 유사 문서 발견 시 교차 참조 추가됨
- 사용자에게 Decision Menu 제시 및 액션 확인됨
</success_criteria>
当满足以下所有条件时,文档化成功:
- YAML frontmatter验证通过(所有必填字段、格式正确、枚举值有效)
- 文件已生成在
knowledge/solutions/[category]/[filename].md - domain-component映射与schema.yaml一致
- Context、What Worked、Why This Works章节内容具体
- 发现相似文档时已添加交叉引用
- 已向用户展示决策菜单并确认操作
</success_criteria>
에러 처리
错误处理
컨텍스트 부족:
- 사용자에게 누락된 정보 질문
- 필수 정보 확보 전 진행 금지
YAML 검증 실패:
- 구체적인 오류 항목 표시
- 수정된 값으로 재시도
- 통과할 때까지 차단
유사 인사이트 모호함:
- 여러 후보 모두 표시
- 사용자 선택: 새 문서 / 기존 업데이트 / 별도 연결
카테고리 매핑 불확실:
- 가장 근접한 카테고리 제안
- 사용자 확인 후 진행
上下文不足:
- 向用户询问缺失的信息
- 未获取必填信息前禁止继续
YAML验证失败:
- 显示具体错误项
- 使用修正后的值重试
- 验证通过前持续阻塞
相似洞察模糊:
- 展示所有候选文档
- 由用户选择: 新建文档 / 更新现有文档 / 单独关联
类别映射不明确:
- 推荐最接近的类别
- 经用户确认后继续
실행 가이드라인
执行准则
반드시 해야 하는 것:
- YAML frontmatter 검증 (Step 5 validation gate는 blocking)
- domain-component 매핑 유효성 확인
- 파일 작성 전 로 디렉토리 생성
mkdir -p - 컨텍스트 누락 시 사용자에게 묻고 대기
- key_learning은 다른 상황에도 적용 가능하게 일반화
절대 하지 말아야 하는 것:
- YAML 검증 건너뛰기 (validation gate는 blocking)
- 모호한 설명으로 문서화 (검색 불가)
- 가설이나 미검증 내용 문서화
- critical pattern 자동 승격 (사용자 결정 필요)
必须执行:
- YAML frontmatter验证(Step 5的验证网关为阻塞式)
- 确认domain-component映射有效性
- 撰写文件前用创建目录
mkdir -p - 上下文缺失时向用户提问并等待
- key_learning需具备场景普适性
绝对禁止:
- 跳过YAML验证(验证网关为阻塞式)
- 用模糊描述撰写文档(无法检索)
- 文档化假设或未验证内容
- 自动升级关键模式(需用户决策)
예시 시나리오
示例场景
사용자: "업스테이지 워크샵에서 아이스브레이커로 'AI 사용 경험 공유'를 먼저 했더니 참여도가 확 올라갔어. 다음에도 이렇게 하자."
스킬 활성화:
- 트리거 감지: "다음에도 이렇게 하자" → 자동 활성화
- 컨텍스트 수집:
- domain: business
- insight_type: consulting_pattern
- component: consulting
- context: "업스테이지 AI 워크샵에서 기술 실습 전 아이스브레이커로 'AI 사용 경험 공유' 세션을 진행했을 때 참여도와 분위기가 크게 개선됨"
- key_learning: "B2B 워크샵에서 실습 전 개인 경험 공유 아이스브레이커가 참여자의 심리적 안전감과 참여도를 높인다"
- impact: high
- tags: [workshop, icebreaker, consulting, engagement, upstage]
- 기존 문서 검색: knowledge/solutions/consulting-patterns/ 검색
- 파일명 생성:
20260224-workshop-icebreaker-experience-sharing.md - YAML 검증: ✅ 통과
- 문서 작성:
knowledge/solutions/consulting-patterns/20260224-workshop-icebreaker-experience-sharing.md - 교차 참조: 없음 (유사 문서 없음)
출력:
인사이트가 기록되었습니다.
파일 생성:
- knowledge/solutions/consulting-patterns/20260224-workshop-icebreaker-experience-sharing.md
다음 작업:
1. 계속 진행 (권장)
2. 크리티컬 패턴에 추가 - critical-patterns.md에 승격
3. 관련 문서 연결 - 유사 인사이트와 교차 참조
4. 기존 스킬에 추가 - .claude/skills/에 연결
5. 문서 확인 - 생성된 내용 보기用户: "在Upstage工作坊中,先以'分享AI使用经验'作为破冰环节,参与度大幅提升。以后就这么做。"
Skill激活:
- 触发检测: "以后就这么做" → 自动激活
- 上下文收集:
- domain: business
- insight_type: consulting_pattern
- component: consulting
- context: "在Upstage AI工作坊中,技术实操前开展'分享AI使用经验'破冰环节,参与度和氛围大幅改善"
- key_learning: "B2B工作坊中,实操前的个人经验分享破冰环节可提升参与者的心理安全感与参与度"
- impact: high
- tags: [workshop, icebreaker, consulting, engagement, upstage]
- 现有文档检索: 检索knowledge/solutions/consulting-patterns/
- 文件名生成:
20260224-workshop-icebreaker-experience-sharing.md - YAML验证: ✅ 通过
- 文档撰写: 生成文件到
knowledge/solutions/consulting-patterns/20260224-workshop-icebreaker-experience-sharing.md - 交叉引用: 无(未发现相似文档)
输出:
洞察已记录完成。
生成的文件:
- knowledge/solutions/consulting-patterns/20260224-workshop-icebreaker-experience-sharing.md
后续操作:
1. 继续(推荐)
2. 添加至关键模式 - 升级到critical-patterns.md
3. 关联相关文档 - 与相似洞察添加交叉引用
4. 添加至现有Skill - 关联到.claude/skills/
5. 查看文档 - 查看生成的内容