day4-wrap-and-analyze
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseDay 4: Wrap & Analyze
Day 4:总结与分析
이 스킬이 호출되면 아래 STOP PROTOCOL을 반드시 따른다.
调用此技能时,必须遵循以下STOP PROTOCOL。
용어 정리
术语整理
이 스킬에서 사용하는 핵심 용어:
| 용어 | 설명 |
|---|---|
| session-wrap | 코딩 세션이 끝날 때 작업을 정리하고 문서화하는 스킬. "퇴근 전 책상 정리" |
| multi-agent | 여러 에이전트가 동시에 일하는 패턴. "회의에서 각 팀장에게 동시에 보고 받기" |
| 병렬(Parallel) | 여러 작업을 동시에 처리하는 것. "4명의 팀장에게 한꺼번에 보고를 받는 것" (반대: 순차 = 한 명씩 차례로) |
| 2-Phase Pipeline | 먼저 분석(Phase 1, 병렬) → 다음 검증(Phase 2, 순차). "전문가 의견 수집 후 팀장이 중복 체크" |
| frontmatter | 스킬 파일 맨 위에 |
| history-insight | 과거 세션 기록을 분석해 인사이트를 추출하는 스킬 |
| session-analyzer | 스킬이 의도대로 실행됐는지 검증하는 분석 도구 |
| 플러그인(Plugin) | 외부에서 설치한 스킬 모음. 스킬이 여러 개 묶여 있는 "스킬 패키지" |
本技能中使用的核心术语:
| 术语 | 说明 |
|---|---|
| session-wrap | 编码会话结束时,整理并记录工作的技能。相当于“下班前整理桌面” |
| multi-agent | 多个Agent同时工作的模式。相当于“会议中同时向各团队负责人汇报” |
| 并行(Parallel) | 同时处理多项任务。相当于“同时向4位团队负责人汇报”(反义词:顺序 = 依次向每个人汇报) |
| 2-Phase Pipeline | 先进行分析(第一阶段,并行)→ 再进行验证(第二阶段,顺序)。相当于“收集专家意见后,由负责人检查重复内容” |
| frontmatter | 写在技能文件最上方、用 |
| history-insight | 分析过往会话记录以提取洞察的技能 |
| session-analyzer | 验证技能是否按预期执行的分析工具 |
| 插件(Plugin) | 从外部安装的技能集合。是多个技能打包在一起的“技能包” |
STOP PROTOCOL — 절대 위반 금지
STOP PROTOCOL — 严禁违反
이 프로토콜은 이 스킬의 최우선 규칙이다. 아래 규칙을 위반하면 수업이 망가진다.
本协议是此技能的最高优先级规则。 违反以下规则会导致课程无法正常进行。
각 블록은 반드시 2턴에 걸쳐 진행한다
每个模块必须分2轮进行
┌─ Phase A (첫 번째 턴) ──────────────────────────────┐
│ 1. references/에서 해당 블록 파일의 EXPLAIN 섹션을 읽는다 │
│ 2. 기능을 설명한다 │
│ 3. references/에서 해당 블록 파일의 EXECUTE 섹션을 읽는다 │
│ 4. "지금 직접 실행해보세요"라고 안내한다 │
│ 5. ⛔ 여기서 반드시 STOP. 턴을 종료한다. │
│ │
│ ❌ 절대 하지 않는 것: 퀴즈 출제, QUIZ 섹션 읽기 │
│ ❌ 절대 하지 않는 것: AskUserQuestion 호출 │
│ ❌ 절대 하지 않는 것: "실행해봤나요?" 질문 │
└──────────────────────────────────────────────────────────┘
⬇️ 사용자가 돌아와서 "했어", "완료", "다음" 등을 입력한다
┌─ Phase B (두 번째 턴) ──────────────────────────────┐
│ 1. references/에서 해당 블록 파일의 QUIZ 섹션을 읽는다 │
│ 2. AskUserQuestion으로 퀴즈를 출제한다 │
│ 3. 정답/오답 피드백을 준다 │
│ 4. 다음 블록으로 이동할지 AskUserQuestion으로 묻는다 │
│ 5. ⛔ 다음 블록을 시작하면 다시 Phase A부터. │
└──────────────────────────────────────────────────────────┘┌─ Phase A (第一轮) ──────────────────────────────┐
│ 1. 读取references/中对应模块文件的EXPLAIN部分 │
│ 2. 说明功能 │
│ 3. 读取references/中对应模块文件的EXECUTE部分 │
│ 4. 提示“现在请亲自尝试执行” │
│ 5. ⛔ 在此处必须STOP,结束本轮。 │
│ │
│ ❌ 严禁操作:出题测验、读取QUIZ部分 │
│ ❌ 严禁操作:调用AskUserQuestion │
│ ❌ 严禁操作:询问“你执行了吗?” │
└──────────────────────────────────────────────────────────┘
⬇️ 用户返回“做完了”“完成”“下一步”等内容后
┌─ Phase B (第二轮) ──────────────────────────────┐
│ 1. 读取references/中对应模块文件的QUIZ部分 │
│ 2. 使用AskUserQuestion出题测验 │
│ 3. 给出正确/错误的反馈 │
│ 4. 使用AskUserQuestion询问是否进入下一个模块 │
│ 5. ⛔ 进入下一个模块后,重新从Phase A开始。 │
└──────────────────────────────────────────────────────────┘핵심 금지 사항 (절대 위반 금지)
核心禁止事项(严禁违反)
- Phase A에서 AskUserQuestion을 호출하지 않는다 — 설명 + 실행 안내 후 바로 Stop
- Phase A에서 퀴즈를 내지 않는다 — QUIZ 섹션은 Phase B에서만 읽는다
- Phase A에서 "실행해봤나요?"를 묻지 않는다 — 사용자가 먼저 말할 때까지 기다린다
- 한 턴에 EXPLAIN + QUIZ를 동시에 하지 않는다 — 반드시 2턴으로 나눈다
- Phase A中不得调用AskUserQuestion — 完成说明+执行提示后直接Stop
- Phase A中不得出题测验 — QUIZ部分仅在Phase B中读取
- Phase A中不得询问“你执行了吗?” — 等待用户主动反馈
- 不得在一轮中同时进行EXPLAIN + QUIZ — 必须分成2轮
공식 문서 URL 출력 (절대 누락 금지)
必须输出官方文档URL(严禁遗漏)
모든 블록의 Phase A 시작 시, 해당 reference 파일 상단의 URL을 반드시 그대로 출력한다.
> 공식 문서:📖 공식 문서: [URL]- reference 파일에 URL이 여러 개 있으면 전부 출력한다
- URL을 요약하거나 생략하지 않는다
在所有模块的Phase A开始时,必须原样输出对应reference文件顶部的 URL。
> 官方文档:📖 官方文档: [URL]- 若reference文件中有多个URL,需全部输出
- 不得总结或省略URL
Phase A 종료 시 필수 문구
Phase A结束时的必备语句
Phase A의 마지막에는 반드시 아래 형태의 문구를 출력하고 Stop한다:
---
👆 위 내용을 직접 실행해보세요.
실행이 끝나면 "완료" 또는 "다음"이라고 입력해주세요.이 문구 이후에 어떤 도구 호출(AskUserQuestion 포함)이나 추가 텍스트도 출력하지 않는다.
Phase A的最后必须输出以下格式的语句,然后Stop:
---
👆 请亲自执行以上内容。
执行完成后,请输入“完成”或“下一步”。此语句之后,不得输出任何工具调用(包括AskUserQuestion)或额外文本。
소요 시간 가이드
耗时指南
| Block | 주제 | 예상 시간 |
|---|---|---|
| 0 | 개념 이해 | ~10분 |
| 1 | 스킬 만들기 | ~30분 |
| 2 | 실행 & 검증 | ~15분 |
| 3 | History Insight | ~10분 |
| 4 | Session Analyzer + 마무리 | ~15분 |
| 합계 | ~80분 |
참가자 속도에 따라 75~90분 소요될 수 있습니다. Block 1이 가장 시간이 오래 걸리는 핵심 블록입니다.
| 模块 | 主题 | 预计时间 |
|---|---|---|
| 0 | 概念理解 | ~10分钟 |
| 1 | 制作技能 | ~30分钟 |
| 2 | 执行 & 验证 | ~15分钟 |
| 3 | History Insight | ~10分钟 |
| 4 | Session Analyzer + 总结 | ~15分钟 |
| 总计 | ~80分钟 |
根据参与者的进度,可能需要75~90分钟。模块1是耗时最长的核心模块。
핵심 전략: 원본 스킬을 해체하며 배우기
核心策略:拆解原版技能进行学习
아래 방식으로 진행한다:
- Block 0에서 session-wrap 스킬의 구조와 multi-agent 원리를 이해한다
- Block 1에서 참가자가 session-wrap 스킬의 SKILL.md를 직접 작성한다 (단계별 안내)
- Block 2에서 직접 만든 스킬을 실행하고 결과를 확인한다
- Block 3에서 history-insight로 과거 세션 기록을 분석한다
- Block 4에서 session-analyzer로 스킬 실행을 검증한다
session-wrap 원본은 플러그인에 설치되어 있다. 참가자는 이를 참고하면서 자기만의 버전을 만든다.
按照以下方式推进:
- 在模块0中理解session-wrap技能的结构和multi-agent原理
- 在模块1中,参与者亲手编写session-wrap技能的SKILL.md(分步指导)
- 在模块2中执行自己制作的技能并检查结果
- 在模块3中使用history-insight分析过往会话记录
- 在模块4中使用session-analyzer验证技能执行情况
session-wrap原版已安装在插件中。参与者可参考原版制作自己的版本。
블록 특수 규칙
模块特殊规则
- Block 0 (개념 이해): Phase A에서 multi-agent 개념 설명 + session-wrap 원본 구조 분석 안내 → Stop. Phase B에서 퀴즈.
- Block 1 (스킬 만들기): Phase A에서 SKILL.md를 Step-by-Step으로 작성하는 방법 안내 → 참가자가 직접 작성 → Stop. Phase B에서 작성한 스킬 구조 퀴즈. (가장 긴 블록 — 완료 후 "여기까지 잘 따라오셨습니다!" 격려)
- Block 2 (실행 & 검증): Phase A에서 만든 스킬 실행 + 결과 확인 안내 → Stop. Phase B에서 실행 결과 퀴즈.
- Block 3 (History Insight): Phase A에서 history-insight 스킬 소개 + 실행 안내 → Stop. Phase B에서 퀴즈.
- Block 4 (Session Analyzer): Phase A에서 session-analyzer 소개 + 실행 안내 → Stop. Phase B에서 종합 퀴즈 + 마무리.
- 模块0(概念理解):Phase A中说明multi-agent概念 + 指导分析session-wrap原版结构 → Stop。Phase B中出题测验。
- 模块1(制作技能):Phase A中分步指导编写SKILL.md的方法 → 参与者亲自编写 → Stop。Phase B中出题测验所制作技能的结构。(最长模块 — 完成后提示“到这里为止都做得很好!”给予鼓励)
- 模块2(执行 & 验证):Phase A中指导执行自己制作的技能 + 检查结果 → Stop。Phase B中出题测验执行结果。
- 模块3(History Insight):Phase A中介绍history-insight技能 + 指导执行 → Stop。Phase B中出题测验。
- 模块4(Session Analyzer):Phase A中介绍session-analyzer + 指导执行 → Stop。Phase B中进行综合测验 + 总结。
References 파일 맵
References文件映射
| 블록 | 파일 | 주제 |
|---|---|---|
| Block 0 | | Multi-agent 패턴 + session-wrap 개념 |
| Block 1 | | session-wrap 스킬 직접 만들기 |
| Block 2 | | 만든 스킬 실행 + 검증 |
| Block 3 | | history-insight 실습 |
| Block 4 | | session-analyzer 실습 |
파일 경로는 이 SKILL.md 기준 상대경로다. 각 reference 파일은,## EXPLAIN,## EXECUTE섹션으로 구성된다.## QUIZ
| 模块 | 文件 | 主题 |
|---|---|---|
| 模块0 | | Multi-agent模式 + session-wrap概念 |
| 模块1 | | 亲手制作session-wrap技能 |
| 模块2 | | 执行制作的技能 + 验证 |
| 模块3 | | history-insight实操 |
| 模块4 | | session-analyzer实操 |
文件路径是相对于此SKILL.md的相对路径。 每个reference文件由、## EXPLAIN、## EXECUTE部分组成。## QUIZ
진행 규칙
推进规则
- 한 번에 한 블록씩 진행한다
- "다음", "skip", 블록 번호/이름으로 이동한다
- Block 1에서 생성한 스킬 파일을 Block 2에서 실행한다
- 참가자의 프로젝트에 를 생성한다
.claude/skills/my-session-wrap/SKILL.md - Claude Code 관련 질문이 오면 claude-code-guide 에이전트(내장 도구)로 답변한다. 답변 후 사용자가 직접 따라할 수 있게 단계별로 안내하고, 질문할 때는 AskUserQuestion을 사용한다. 내장 에이전트 답변이 부정확하다고 판단되면, 공식 문서를 로 파일에 저장한 뒤 Read 툴로 꼼꼼히 읽고 정확한 정보로 다시 답한다 (WebFetch는 요약/손실 위험이 있으므로 사용하지 않는다)
curl
- 一次仅推进一个模块
- 可通过“下一步”“skip”、模块编号/名称切换模块
- 在模块1中创建的技能文件将在模块2中执行
- 在参与者的项目中创建
.claude/skills/my-session-wrap/SKILL.md - 若收到Claude Code相关问题,使用claude-code-guide Agent(内置工具)回答。回答后需分步指导用户亲自操作,提问时使用AskUserQuestion。若判断内置Agent的回答不准确,需用将官方文档保存到文件中,再用Read工具仔细读取后,以准确信息重新回答(不使用WebFetch,因为存在总结/信息丢失风险)
curl
시작
开始
스킬 시작 시 먼저 최신 커리큘럼을 설치한 뒤 블록을 선택한다.
技能启动时请先安装最新课程,再选择模块。
Step 1: 최신 스킬 설치
Step 1:安装最新技能
아래 명령어를 출력하고 Bash로 실행한다:
bash
npx skills add ai-native-camp/camp-1 --agent claude-code --yes실행 결과를 간략히 안내한다 (예: "스킬이 최신 버전으로 설치되었습니다").
输出以下命令并使用Bash执行:
bash
npx skills add ai-native-camp/camp-1 --agent claude-code --yes简要说明执行结果(例如:“技能已更新至最新版本”)。
Step 2: 블록 선택
Step 2:选择模块
아래 테이블을 보여주고 AskUserQuestion으로 어디서 시작할지 물어본다.
| Block | 주제 | 내용 |
|---|---|---|
| 0 | 개념 이해 | Multi-agent 패턴, session-wrap이란? |
| 1 | 스킬 만들기 | session-wrap SKILL.md 직접 작성 |
| 2 | 실행 & 검증 | 만든 스킬 실행 + 결과 확인 |
| 3 | History Insight | 세션 히스토리 분석 실습 |
| 4 | Session Analyzer | 세션 실행 검증 실습 |
json
AskUserQuestion({
"questions": [{
"question": "Day 4: Wrap & Analyze\n\n어디서부터 시작할까요?",
"header": "시작 블록",
"options": [
{"label": "처음부터 (Block 0)", "description": "Multi-agent 패턴과 session-wrap 개념부터 차근차근"},
{"label": "스킬 만들기 (Block 1)", "description": "개념을 이미 알면 바로 스킬 작성하기"},
{"label": "실행 & 검증 (Block 2)", "description": "스킬을 이미 만들었으면 실행 + 결과 확인"},
{"label": "분석 도구 (Block 3~4)", "description": "history-insight와 session-analyzer 실습부터"}
],
"multiSelect": false
}]
})시작 블록 선택 후 → 해당 블록의 Phase A부터 진행한다.
展示以下表格,使用AskUserQuestion询问从哪里开始。
| 模块 | 主题 | 内容 |
|---|---|---|
| 0 | 概念理解 | Multi-agent模式,什么是session-wrap? |
| 1 | 制作技能 | 亲手编写session-wrap SKILL.md |
| 2 | 执行 & 验证 | 执行制作的技能 + 检查结果 |
| 3 | History Insight | 会话历史分析实操 |
| 4 | Session Analyzer | 会话执行验证实操 |
json
AskUserQuestion({
"questions": [{
"question": "Day 4: Wrap & Analyze\n\n从哪里开始呢?",
"header": "起始模块",
"options": [
{"label": "从头开始(模块0)", "description": "循序渐进学习Multi-agent模式和session-wrap概念"},
{"label": "制作技能(模块1)", "description": "已了解概念可直接开始编写技能"},
{"label": "执行 & 验证(模块2)", "description": "已制作技能可直接执行 + 检查结果"},
{"label": "分析工具(模块3~4)", "description": "从history-insight和session-analyzer实操开始"}
],
"multiSelect": false
}]
})选择起始模块后 → 从对应模块的Phase A开始推进。