用途
该技能用于引导一名参与者完成 RAG 训练营的 Module 3(模块3)实操。目标不是追求性能,而是让参与者观察一个朴素(naïve)RAG 的真实表现,并把在第6步(CP6)观察到的缺陷作为 Module 4 的议题。整个工作坊为3小时,共6个步骤,面向技术类参与者,在其本机构建一个基于 ANSSI 语料库的本地 RAG。
本技能定位于单个参与者,而非全体会议。集体复盘、解散讨论和总体时间控制由真人主持人负责。
主要能力
- 六步工作流推进:依次引导 Setup(环境搭建)、Ingestion(文本摄取与分块)、Embeddings(向量化与索引)、Retrieval(检索)、Generation(生成与引用)、Eval(评估与缺陷分析)。
- 状态判断与续接:根据工作区当前产物(如是否存在 .env、node_modules、data/chunks.json、data/index.db、retrieve() 函数、eval-findings.md 等)判断当前处于哪一步,并据此继续。
- 渐进式披露(progressive disclosure):每次只加载当前步骤对应的参考文件,而不是一次性读取全部6个步骤。
- 默认逐步引导模式:以微步骤推进,一次只做一件事(创建/修改文件、运行命令、验证);除非用户明确要求查看完整计划,否则不一次性给出全部流程。
- 可观察的完成门槛:只有当某一步的退出标准可被实际观测(文件存在、输出符合预期、测试通过)时,才宣布该步骤完成,不盲信参与者的口头陈述。
- 提示阶梯(hint ladder):参与者卡住时,先给一个苏格拉底式提示(指向线索但不揭示答案);若仍卡住,则给出完整解决方案与解释。仅此两个层级。
- 直接编辑:在具备编辑/终端工具时,由技能自行创建和修改文件,而非仅给出指令。
使用方式
在会话开始时,技能用最多4行说明工作坊议程(6个步骤、个人实操与集体复盘交替、当前阶段目标、以及为 Module 4 记录缺陷)。随后询问陪伴模式(默认逐步引导,或用户明确要求的完整计划),加载对应步骤的参考文件,并按微步骤逐条推进。
代码微步骤要求提供双交付物:本地已应用的改动,以及可复制的 markdown 代码片段加验证命令。代码回传采用固定短结构:已完成事项、涉及文件路径、可复制的代码块、验证命令与预期结果。若不具备编辑工具,则明确说明并转入“手动补丁”模式。
参考文件(cp1 至 cp6)采用固定模板:目标、学习目标、时长、给参与者的开场简报、引导方式、代码回传、流程、退出标准、验证、提示阶梯、教学陷阱、可选支线任务、过渡语。
操作规则要点
- 所有给参与者的消息使用法语;可阅读英文技术资料但以法语输出。
- 执行前先解释:每条命令前用一句话说明它验证/修改什么以及预期结果。
- 一次只推进一步,不越过当前步骤;若参与者想跳过某步或某检查点,礼貌拒绝(节奏由主持人把控)。
- 不做过度工程:分块为朴素策略(500 tokens、50 重叠),嵌入直接调用 API,存储用 LibSQL;若参与者想优化,提示“记录到 Module 4”并回到当前步骤。
- 独立教程中仅使用 npm/npx,不提供 pnpm/pnpx。
- 强制自主引导:若工作区未就绪(无 src/mastra/index.ts 或 corpus/anssi-essentiels/manifest.json),先执行 references/bootstrap-workspace.md。
- 忠于 Mastra:写 Mastra 代码前先查阅 mastra 技能,未安装则先安装(npx skills add mastra-ai/skills --skill mastra -y),不猜测 API,可在 node_modules/@mastra/core/dist/docs/references/ 中核对。
适用场景
适合作为导师(或陪伴型 AI 助手)与单个技术学员一起,在本地完成一个端到端朴素 RAG 的构建,并聚焦于观察和记录其缺陷。参与者应为技术背景。具体学习目标(LO)在资料中仅以编号出现(LO1 至 LO5),其详细内容在本资料中暂未提供。
限制
- 资料未说明任何收费、价格或商业条款。
- 资料未说明具体平台要求,除提及 Antigravity 作为对话兼容目标外。
- 资料未给出参与者需具备的前置技能细节。
- 资料未列举学习目标 LO1 至 LO5 的具体内容。
- 技能不负责全体会议、集体复盘与整体时间把控,这些由真人主持人承担。
内容状态
根据资料,CP1 与 CP2 已详细撰写(含流程、验证、提示阶梯、陷阱、支线任务);CP3 至 CP6 已撰写可操作内容(流程、验证、提示、陷阱、支线任务);全局提示阶梯调整已应用,使 CP1 至 CP6 的语气、层级与恢复标准统一。资料称该技能可用于带一名参与者完整运行 Step 1 至 Step 6(CP1 至 CP6),全体会议与节奏把控仍归主持人。