name: session-intelligence-harvester description: 此技能应在富有成效的会话后使用，以提取学习成果并将其路由到适当的可重用智能基础设施组件。当进行了修正、修复了格式漂移、出现了新模式，或用户明确要求“收获学习成果”或“捕获会话智能”时使用。通过跨多个文件实施更新，将一次性修复转化为永久的组织知识。
会话智能收获器
概述
通过跨RII组件实施更新，将会话学习成果转化为永久的组织智能。在涉及修正、发现或模式识别的富有成效的会话后，系统地提取所学内容，将其路由到正确的组件，并应用更改。
重要性：未编码到RII组件中的一次性修复会再次发生。第N章技能格式漂移的发生就是因为没有检查来防止它。收获后，该故障模式被编码在4个文件中——未来的会话将自动受益。
何时使用此技能
自动触发（主动建议收获）：
- 会话纠正了格式漂移（错误的文件结构、YAML、调用方式）
- 会话向编排文件添加了缺失的检查
- 会话识别出值得预防的故障模式
- 会话触及了3个以上具有类似模式修正的文件
- 创建了记录重要学习成果的PHR
手动触发（用户请求）：
- “从本次会话中收获学习成果”
- “捕获会话智能”
- “我们应该从这项工作中编码什么？”
- “用我们学到的东西更新RII”
工作流程
默认采取行动：实施所有更新，而不仅仅是提出建议。读取目标文件，进行编辑，并提交更改。只有在明确要求时才仅提出建议而不实施。
步骤1：会话分析
通过回答以下问题来分析会话。写下你的分析以跟踪进度：
1. 已完成的修正
- 纠正了哪些错误/漂移？
- 之前错误是什么，现在正确是什么？
- 错误为何发生？（缺少检查、格式漂移等）
重要性：理解根本原因决定了哪个RII组件可以防止复发。格式漂移 → 智能体收敛模式。缺少上下文 → CLAUDE.md协议步骤。
2. 已识别的模式
- 出现了哪些重复出现的模式？
- 参考了哪些规范来源？
- 什么样的验证可以更早地发现这个问题？
重要性：跨会话重复出现的模式值得编码。如果你参考了规范来源，其他会话也将需要相同的参考。
3. 学习成果分类
- 上下文收集缺口？（CLAUDE.md）
- 教学/教育问题？（Constitution）
- 智能体收敛模式？（Agents）
- 可重用工作流？（Skills）
- 缺失的编排检查？（Commands）
重要性：错误的路由意味着学习成果不会在正确的时间触发。CLAUDE.md中的收敛模式无助于章节规划器在规划期间捕获它。
步骤2：路由到RII组件
使用此路由表。将学习成果路由到将在正确时间发现它们的组件：
| 学习类型 | 目标组件 | 位置 | 添加内容 | 触发时机 |
|---|---|---|---|---|
| 上下文收集缺口 | CLAUDE.md | 第一部分 | 上下文协议中的新步骤 | 在任何平台工作之前 |
| 故障模式示例 | CLAUDE.md | 故障模式 | 带有修正的命名示例 | 当检测到类似情况时 |
| 教学框架 | Constitution | 第二部分a | 教学方法更新 | 在课程设计期间 |
| 智能体收敛模式 | 智能体文件 | 收敛模式 | 模式 + 原因 + 修正 | 在智能体执行期间 |
| 智能体自我监控 | 智能体文件 | 自我监控清单 | 新的清单项 | 在智能体最终确定输出之前 |
| 规范来源查找 | 多个智能体 | 分析问题 | 交叉引用检查 | 在规划阶段 |
| 可重用工作流 | 新技能 | .claude/skills/ | 新的SKILL.md | 当用户调用技能时 |
| 编排检查 | 命令文件 | 阶段0或相关阶段 | 新的验证步骤 | 在工作流执行期间 |
| 格式规范 | 规范来源章节 | 课程内容 | 权威格式 | 在教授该模式时 |
路由的重要性：放置在错误组件中的学习成果无法防止复发。content-implementer.md中的检查在chapter-planner执行期间发生错误时没有帮助。
步骤3：读取目标文件并生成更新
对于每个已识别的学习成果：
- 读取目标文件以了解当前结构并找到确切的放置位置
- 生成更新，包含用于精确定位的周围上下文
- 跟踪进度，因为你将处理多个文件
## 学习成果：[简要标题]
**类型**：[上下文缺口 | 故障模式 | 收敛模式 | 等]
**目标**：[文件路径]
**当前状态**（读取文件后）：
[缺失或错误的内容 - 如有帮助，引用现有内容]
**确切放置位置**：
[哪个部分，在哪个内容之后 - 具体到足以编辑]
**要添加的内容**：
[确切内容，与文件的风格和格式匹配]
**理由**：
[为什么这能防止复发 - 什么将触发此检查]
**规范来源**（如适用）：
[哪个章节/课程定义了权威格式]
步骤4：实施更新
采取行动：编辑每个目标文件。使用编辑工具进行更改。
对于每个更新：
- 读取目标文件（如果尚未读取）
- 定位确切的插入点
- 使用编辑工具应用编辑
- 验证编辑是否正确应用
跟踪完成情况：
更新进度：
- [x] CLAUDE.md - 添加了故障模式部分
- [x] chapter-planner.md - 添加了收敛模式6
- [ ] sp.loopflow.v2.md - 添加阶段0检查（进行中）
- [ ] content-implementer.md - 待处理
步骤5：验证
在最终确定之前，验证以下每一项（确认时勾选复选框）：
- [ ] 在编辑前读取每个目标文件（不推测结构）
- [ ] 验证每个学习成果都路由到在正确时间触发的组件
- [ ] 确认更新包含确切的放置上下文（不是模糊的位置）
- [ ] 检查规范来源是否存在与格式相关的学习成果
- [ ] 搜索目标文件以确认不存在重复信息
- [ ] 对智能体文件使用命令式，对其他文件使用适当的风格
- [ ] 在模式出现在多个文件中的地方添加交叉引用
- [ ] 所有编辑已成功应用（无待处理更改）
步骤6：创建PHR并提交
-
创建PHR，记录：
- 学到了什么
- 编码在何处（列出所有文件）
- 为什么这能改进未来的工作
-
提交更改，附带描述性消息：
feat(intelligence): 将会话学习成果收获到RII中 更新： - [文件1]：[添加了什么] - [文件2]：[添加了什么] 防止：[此操作防止的故障模式]
RII组件参考
CLAUDE.md结构
第一部分：上下文收集协议
- 步骤1-N：顺序上下文步骤
- 每个步骤都有要做什么以及为什么重要
- “查找规范来源”步骤用于模式教学
故障模式（在第一部分和第二部分之间）：
- 命名的故障示例：“故障模式：[名称] 示例”
- “我做错了什么”列表
- “我应该做什么”编号步骤
- “结果”显示防止了什么
智能体文件结构
分析问题（第三部分）：
- 带有“重要性”解释的编号问题
- 末尾的自我检查提示
原则（第四部分）：
- 命名的原则，包含框架 + 这意味着什么 + 应用指导
- 自我检查提示
收敛模式（第六部分）：
- “通用模式”描述
- “为什么这是收敛”解释
- “修正”包含具体步骤
自我监控清单（第八部分）：
- 带有勾选表情符号前缀的编号清单
- 每个项目都是一个验证问题
命令文件结构
阶段0：基础检查
- 宪法阅读
- 规范来源检查（针对教育内容）
- 每个步骤解释原因
收敛模式：
- 症状描述
- 检测方法
- 修正步骤
输出格式
完成收获后，提供摘要：
## 会话智能收获摘要
**会话**：[简要描述]
**日期**：[ISO日期]
**状态**：完成
### 提取的学习成果：[N]
| # | 学习成果 | 类型 | 目标 | 状态 |
|---|----------|------|--------|--------|
| 1 | [标题] | [类型] | [文件] | 已应用 |
| 2 | [标题] | [类型] | [文件] | 已应用 |
### 已应用的更新
1. **[文件]**：[添加了什么]（第X-Y行）
2. **[文件]**：[添加了什么]（第X-Y行）
### 创建的PHR
- 路径：[PHR路径]
- 阶段：[阶段]
### 引用的规范来源
- [模式]：[第X章 第Y课]
### 提交
- 哈希值：[提交哈希]
- 消息：[提交消息摘要]
示例
示例1：格式漂移修正（多文件）
会话：将技能格式修复为使用基于域的结构
分析：
已完成的修正：
- 错误：.claude/skills/section-writer.md（平面文件，无域）
- 正确：.claude/skills/authoring/section-writer/SKILL.md（域 + 目录结构）
- 根本原因：技能/智能体没有域组织
已识别的模式：
- 技能必须在authoring/或engineering/域文件夹中
- 智能体必须在authoring/或engineering/域文件夹中
- 多个文件引用了旧的平面结构
分类：
- 故障模式 → CLAUDE.md
- 收敛模式 → chapter-planner.md, content-implementer.md
- 技能结构 → skill-creator, session-intelligence-harvester
已应用的更新：
- CLAUDE.md：更新了智能体架构部分
- skill-creator：添加了域组织要求
- session-intelligence-harvester：更新了带有域路径的路由表
- 将所有技能移动到authoring/或engineering/
- 将所有智能体移动到authoring/或engineering/
- 通用技能位于.claude/skills/
示例2：缺失的验证（单文件）
会话：发现课程没有检查chapter-index.md中的先决条件
分析：
已完成的修正：
- 错误：未阅读chapter-index.md就开始章节工作
- 正确：必须先阅读chapter-index.md以获取部分、熟练度、先决条件
- 根本原因：上下文协议中没有强制步骤
分类：
- 上下文收集缺口 → CLAUDE.md 第一部分
已应用的更新：
- CLAUDE.md：添加了步骤1以阅读chapter-index.md，包含特定的提取要求
自我监控
在标记收获完成之前，请验证你是否：
- [ ] 分析了会话以识别所有修正和模式
- [ ] 对每个学习成果进行分类以确定正确的路由
- [ ] 在编辑前读取了每个目标文件（不推测）
- [ ] 使用编辑工具应用了所有编辑（不仅仅是提出）
- [ ] 验证了编辑与目标文件的风格和结构匹配
- [ ] 在模式出现在多个文件中的地方添加了交叉引用
- [ ] 创建了记录收获的PHR
- [ ] 提交了带有描述性消息的更改
- [ ] 生成了显示所有已应用更新的摘要