AI技能开发：session-wrap与multi-agent分析实战指南 | 技能创建与验证流程

day4-wrap-and-analyze by ai-native-camp/camp-1

1,100 周安装量

214 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/ai-native-camp/camp-1 --skill day4-wrap-and-analyze

AI/机器学习开发数据分析

🇨🇳中文介绍

第四天：总结与分析

이 스킬이 호출되면 아래 STOP PROTOCOL 을 반드시 따른다.

术语整理

本技能中使用的核心术语：

术语	说明
session-wrap	编码会话结束时整理工作并进行文档化的技能。"下班前整理桌面"
multi-agent	多个代理同时工作的模式。"会议中同时听取各团队负责人汇报"
병렬(Parallel)	同时处理多个任务。"同时听取4位团队负责人的汇报"（反义：顺序 = 依次进行）
2-Phase Pipeline	先分析（Phase 1，并行）→ 后验证（Phase 2，顺序）。"收集专家意见后由团队负责人进行重复检查"
frontmatter	技能文件最上方用 `---` 包裹的"标签"。在此处填写技能的名称（name）和描述（description）
history-insight	分析过往会话记录并提取洞察的技能
session-analyzer

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

STOP PROTOCOL — 绝对禁止违反

此协议是本技能的最高优先规则。违反以下规则将导致课程失败。

每个区块必须分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 中不调用 AskUserQuestion — 说明 + 执行引导后立即 Stop
Phase A 中不出题 — QUIZ 部分仅在 Phase B 中读取
Phase A 中不询问"执行了吗？" — 等待用户先开口
不在同一轮中同时进行 EXPLAIN + QUIZ — 必须分成2轮

输出官方文档 URL（绝对禁止遗漏）

所有区块的 Phase A 开始时，必须原样输出 对应 reference 文件顶部的 > 官方文档: URL。

📖 官方文档: [URL]

如果 reference 文件中有多个 URL，则全部输出
不得总结或省略 URL

Phase A 结束时的必需语句

Phase A 的最后必须输出以下形式的语句并 Stop：

---
👆 请亲自尝试执行以上内容。
执行结束后，请输入"完成"或"下一步"。

此语句之后不得输出任何工具调用（包括 AskUserQuestion）或附加文本。

区块	主题	预计时间
0	概念理解	~10分钟
1	技能创建	~30分钟
2	执行与验证	~15分钟
3	History Insight	~10分钟
4	Session Analyzer + 收尾	~15分钟
总计		~80分钟

根据参与者速度，可能需要 75~90 分钟。Block 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 原始版本已安装在插件中。参与者可参考此版本创建自己的版本。

Block 0 (概念理解) : Phase A 中说明 multi-agent 概念 + 引导分析 session-wrap 原始结构 → Stop。Phase B 中出题。
Block 1 (技能创建) : Phase A 中分步引导编写 SKILL.md 的方法 → 参与者亲自编写 → 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 中综合题目 + 收尾。

参考资料文件映射

区块	文件	主题
Block 0	`references/block0-concept.md`	Multi-agent 模式 + session-wrap 概念
Block 1	`references/block1-build-session-wrap.md`	亲手创建 session-wrap 技能
Block 2	`references/block2-run-session-wrap.md`	执行所创建技能 + 验证
Block 3	`references/block3-history-insight.md`	history-insight 实践
Block 4	`references/block4-session-analyzer.md`	session-analyzer 实践

文件路径是相对于此 SKILL.md 的相对路径。每个 reference 文件由 ## EXPLAIN、## EXECUTE、## QUIZ 部分组成。

一次进行一个区块
通过"下一步"、"skip"、区块编号/名称进行移动
在 Block 2 中执行 Block 1 创建的技能文件
在参与者的项目中创建 .claude/skills/my-session-wrap/SKILL.md
收到关于 Claude Code 的提问时，使用 claude-code-guide 代理（内置工具）回答。回答后，引导用户能够亲自分步操作，提问时使用 AskUserQuestion。如果判断内置代理的回答不准确，则使用 curl 将官方文档保存到文件中，然后使用 Read 工具仔细阅读，并用准确的信息重新回答（不使用 WebFetch，因为有总结/丢失信息的风险）。

技能开始时，首先安装最新课程，然后选择区块。

Step 1: 安装最新技能

输出以下命令并在 Bash 中执行：

npx skills add ai-native-camp/camp-1 --agent claude-code --yes

简要引导执行结果（例如："技能已安装至最新版本"）。

Step 2: 选择区块

显示以下表格，并使用 AskUserQuestion 询问从哪里开始。

区块	主题	内容
0	概念理解	Multi-agent 模式，什么是 session-wrap？
1	技能创建	亲手编写 session-wrap SKILL.md
2	执行与验证	执行所创建技能 + 确认结果
3	History Insight	会话历史分析实践
4	Session Analyzer	会话执行验证实践

AskUserQuestion({
  "questions": [{
    "question": "第四天：总结与分析\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 开始进行。

🇺🇸English

Day 4: Wrap & Analyze

이 스킬이 호출되면 아래 STOP PROTOCOL 을 반드시 따른다.

용어 정리

이 스킬에서 사용하는 핵심 용어:

용어	설명
session-wrap	코딩 세션이 끝날 때 작업을 정리하고 문서화하는 스킬. "퇴근 전 책상 정리"
multi-agent	여러 에이전트가 동시에 일하는 패턴. "회의에서 각 팀장에게 동시에 보고 받기"
병렬(Parallel)	여러 작업을 동시에 처리하는 것. "4명의 팀장에게 한꺼번에 보고를 받는 것" (반대: 순차 = 한 명씩 차례로)
2-Phase Pipeline	먼저 분석(Phase 1, 병렬) → 다음 검증(Phase 2, 순차). "전문가 의견 수집 후 팀장이 중복 체크"
frontmatter	스킬 파일 맨 위에 `---`로 감싸서 적는 "이름표". 스킬의 이름(name)과 설명(description)을 여기에 적는다
history-insight	과거 세션 기록을 분석해 인사이트를 추출하는 스킬
session-analyzer	스킬이 의도대로 실행됐는지 검증하는 분석 도구
플러그인(Plugin)	외부에서 설치한 스킬 모음. 스킬이 여러 개 묶여 있는 "스킬 패키지"

STOP PROTOCOL — 절대 위반 금지

이 프로토콜은 이 스킬의 최우선 규칙이다. 아래 규칙을 위반하면 수업이 망가진다.

각 블록은 반드시 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에서 AskUserQuestion을 호출하지 않는다 — 설명 + 실행 안내 후 바로 Stop
Phase A에서 퀴즈를 내지 않는다 — QUIZ 섹션은 Phase B에서만 읽는다
Phase A에서 "실행해봤나요?"를 묻지 않는다 — 사용자가 먼저 말할 때까지 기다린다
한 턴에 EXPLAIN + QUIZ를 동시에 하지 않는다 — 반드시 2턴으로 나눈다

공식 문서 URL 출력 (절대 누락 금지)

모든 블록의 Phase A 시작 시, 해당 reference 파일 상단의 > 공식 문서: URL을 반드시 그대로 출력 한다.

📖 공식 문서: [URL]

reference 파일에 URL이 여러 개 있으면 전부 출력한다
URL을 요약하거나 생략하지 않는다

Phase A 종료 시 필수 문구

Phase A의 마지막에는 반드시 아래 형태의 문구를 출력하고 Stop한다:

---
👆 위 내용을 직접 실행해보세요.
실행이 끝나면 "완료" 또는 "다음"이라고 입력해주세요.

이 문구 이후에 어떤 도구 호출(AskUserQuestion 포함)이나 추가 텍스트도 출력하지 않는다.

소요 시간 가이드

Block	주제	예상 시간
0	개념 이해	~10분
1	스킬 만들기	~30분
2	실행 & 검증	~15분
3	History Insight	~10분
4	Session Analyzer + 마무리	~15분
합계		~80분

참가자 속도에 따라 75~90분 소요될 수 있습니다. Block 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 원본은 플러그인에 설치되어 있다. 참가자는 이를 참고하면서 자기만의 버전을 만든다.

블록 특수 규칙

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에서 종합 퀴즈 + 마무리.

References 파일 맵

블록	파일	주제
Block 0	`references/block0-concept.md`	Multi-agent 패턴 + session-wrap 개념
Block 1	`references/block1-build-session-wrap.md`	session-wrap 스킬 직접 만들기
Block 2	`references/block2-run-session-wrap.md`	만든 스킬 실행 + 검증
Block 3	`references/block3-history-insight.md`	history-insight 실습
Block 4	`references/block4-session-analyzer.md`

파일 경로는 이 SKILL.md 기준 상대경로다. 각 reference 파일은 ## EXPLAIN, ## EXECUTE, ## QUIZ 섹션으로 구성된다.

진행 규칙

한 번에 한 블록씩 진행한다
"다음", "skip", 블록 번호/이름으로 이동한다
Block 1에서 생성한 스킬 파일을 Block 2에서 실행한다
참가자의 프로젝트에 .claude/skills/my-session-wrap/SKILL.md를 생성한다
Claude Code 관련 질문이 오면 claude-code-guide 에이전트(내장 도구)로 답변한다. 답변 후 사용자가 직접 따라할 수 있게 단계별로 안내하고, 질문할 때는 AskUserQuestion을 사용한다. 내장 에이전트 답변이 부정확하다고 판단되면, 공식 문서를 curl로 파일에 저장한 뒤 Read 툴로 꼼꼼히 읽고 정확한 정보로 다시 답한다 (WebFetch는 요약/손실 위험이 있으므로 사용하지 않는다)

시작

스킬 시작 시 먼저 최신 커리큘럼을 설치 한 뒤 블록을 선택한다.

Step 1: 최신 스킬 설치

아래 명령어를 출력하고 Bash로 실행한다:

npx skills add ai-native-camp/camp-1 --agent claude-code --yes

실행 결과를 간략히 안내한다 (예: "스킬이 최신 버전으로 설치되었습니다").

Step 2: 블록 선택

아래 테이블을 보여주고 AskUserQuestion으로 어디서 시작할지 물어본다.

Block	주제	내용
0	개념 이해	Multi-agent 패턴, session-wrap이란?
1	스킬 만들기	session-wrap SKILL.md 직접 작성
2	실행 & 검증	만든 스킬 실행 + 결과 확인
3	History Insight	세션 히스토리 분석 실습
4	Session Analyzer	세션 실행 검증 실습

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부터 진행한다.

Weekly Installs

747

Repository

ai-native-camp/camp-1

GitHub Stars

197

First Seen

Feb 18, 2026

Security Audits

Gen Agent Trust HubWarn SocketPass SnykPass

Installed on

claude-code739

opencode36

github-copilot28

codex28

cursor28

gemini-cli27

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

102,200 周安装