SuperAPI AI 工具集

day4-wrap-and-analyze

智能体与模型

查看项目

更新于 10-15 18:31

技能介绍

用途

本技能是 AI Native Camp 第 4 天课程「Wrap & Analyze」的教学引导程序,用于带着学员完成从理解多智能体(multi-agent)模式、亲手编写 session-wrap 技能、运行并验证,到使用 history-insight 和 session-analyzer 做会话分析的完整流程。核心策略是“拆解原版技能来学习”:session-wrap 原版已安装在插件中,学员参考它写出自己的版本。

主要内容结构

课程分为 5 个 Block,参考文件放在 references/ 下(相对本 SKILL.md 的路径):

  • Block 0:概念理解,references/block0-concept.md,讲 multi-agent 模式与 session-wrap 概念
  • Block 1:技能创建,references/block1-build-session-wrap.md,逐步编写 session-wrap 的 SKILL.md(最长的核心块)
  • Block 2:执行与验证,references/block2-run-session-wrap.md,运行自建技能并确认结果
  • Block 3:History Insight,references/block3-history-insight.md,用 history-insight 分析过往会话记录
  • Block 4:Session Analyzer,references/block4-session-analyzer.md,用 session-analyzer 验证技能是否按预期执行

每个 reference 文件由 ## EXPLAIN、## EXECUTE、## QUIZ 三个部分组成。

使用方式

技能启动时先安装最新课程内容,命令为:

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

随后显示 Block 表,并用 AskUserQuestion 询问从哪个 Block 开始(可选:从 Block 0 开始、Block 1 技能创建、Block 2 执行与验证、Block 3~4 分析工具)。

教学遵循 STOP PROTOCOL,每个 Block 必须分两轮进行:

  • Phase A(第一轮):读取对应 reference 文件的 EXPLAIN 段并讲解功能;读取 EXECUTE 段并提示“现在请直接执行”;输出参考文件顶部的官方文档 URL(格式为「📖 공식 문서: [URL]」);最后输出固定结束语并停止,不调用任何工具、不出题、不追问是否执行。
  • Phase B(第二轮,用户回复“做了”“完成”“下一个”后):读取 QUIZ 段并用 AskUserQuestion 出题,给出对错反馈,再用 AskUserQuestion 询问是否进入下一个 Block;开始下一 Block 时重新回到 Phase A。

禁止事项:Phase A 调用 AskUserQuestion、出题、追问「执行了吗」;一轮内同时做 EXPLAIN 和 QUIZ。

其他规则:一次只推进一个 Block,可用“下一个”“skip”、Block 编号或名称跳转;Block 1 生成的技能文件放在学员项目的 .claude/skills/my-session-wrap/SKILL.md;遇到 Claude Code 相关提问由内置的 claude-code-guide 代理回答,之后分步引导学员自行操作,提问时用 AskUserQuestion,若认为内置代理回答不准确,则用 curl 把官方文档保存成文件再用 Read 工具细读(不使用 WebFetch,因其有摘要/丢失风险)。

术语说明

  • session-wrap:编码会话结束时整理并记录工作的技能,比喻为“下班前整理桌面”
  • multi-agent:多个智能体同时工作的模式
  • 并行(Parallel):同时处理多个任务(反义为顺序/依次)
  • 2-Phase Pipeline:先分析(Phase 1,并行)再验证(Phase 2,顺序)
  • frontmatter:技能文件顶部用 --- 包裹的“名牌”,写技能的名称(name)和说明(description)
  • history-insight:分析过往会话记录并提取洞察的技能
  • session-analyzer:验证技能是否按意图执行的分析工具
  • 插件(Plugin):从外部安装的技能集合,即“技能包”

时间安排

Block 0 约 10 分钟,Block 1 约 30 分钟,Block 2 约 15 分钟,Block 3 约 10 分钟,Block 4 约 15 分钟,合计约 80 分钟,视学员速度可能为 75~90 分钟。

适用场景与限制

适用场景:面向 AI Native Camp 学员的课程引导,需要交互式分块教学与随堂测验。限制:资料未提供该技能的收费、价格、平台要求等信息,暂未提供;本技能为课程教学脚本,具体功能效果依赖对应 reference 文件与课程环境。