mcpField
U
update-claude-learnings

update-claude-learnings

github.com/ulpi-ioAgent 工作流5162 次安装9 周前更新
代码仓库

关于 update-claude-learnings

用于管理项目级 Claude Code 持久记忆的技能，将会话中的行为或工作流经验整理为一条经确认的 CLAUDE.md 指引。它强调检查适用范围、排查重复，并在修改前征求明确同意。

主要功能

  1. 01限定 Claude Code 行为与工作流经验
  2. 02检查记忆范围和章节位置
  3. 03写入前排查重复内容
  4. 04修改 CLAUDE.md 前征求确认
  5. 05核验并报告变更

适用场景

  1. 01记录项目特定的 Claude 工作流规则
  2. 02判断会话经验是否适合写入记忆
  3. 03将新指引归入合适章节
  4. 04在获批后更新并核查 CLAUDE.md

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ulpi-io/skills --skill update-claude-learnings

安装后在 Claude Code 中输入/update-claude-learnings确认已加载。

附带文件references/claude-md-template.mdreferences/learning-scope.md

详细介绍

＜EXTREMELY-IMPORTANT＞ 此技能会更新持久化的 Claude 记忆，必须严守规范。

不可妥协的规则：

  1. 只记录关于 Claude Code 在此项目中的行为或工作流的经验。
  2. 拒绝记录应用代码、子 Agent 或技能编写方面的经验，并将其转交给适当的维护流程。
  3. 写入前检查是否有重复或近似重复的内容。
  4. 修改 CLAUDE.md 前，必须先获得用户明确确认。
  5. 保留现有结构，只添加最精简且正确的指令。

更新 Claude 经验

输入

  • $request：可选的经验候选、类别提示，或关于本次会话发现的提醒

目标

通过以下方式向项目记忆中添加一条经过验证的 Claude 行为经验：

  • 从会话中提取恰当的规则
  • 确认该规则适合写入 CLAUDE.md
  • 将其放入正确的章节
  • 保留周围的记忆结构
  • 准确报告所做的更改

第 0 步：确认这条经验适合写在这里

此技能仅用于记录此项目中 Claude Code 的持久行为规范。

有效示例：

  • 规定 Claude 何时应使用特定技能的工作流规则
  • 规定 Claude 在何时应先询问再扩大工作范围的范围控制规则
  • 有关检查点、进度更新或停止条件的会话管理规则
  • 能改进未来会话的项目专属 Claude 行为规范

无效示例：

  • 更适合写入 Agent 文件的应用实现规则
  • 更适合写入技能经验的技能编写模式
  • 不值得持久保存的一次性临时备注

加载 references/learning-scope.md，了解内容转交、类别归属和失败模式。

如果这条经验不适合写入 CLAUDE.md，请停止并说明它应该写在哪里。

成功标准：这条经验明确适合写入持久化的 Claude 项目记忆。

第 1 步：从会话中提取一条具体经验

回顾会话并找出最精简且有用的规则。

规则：

  • 优先选择一条明确的经验，而不是多条含糊的经验
  • 使用祈使语气撰写
  • 将规则与具体行为关联，而非泛泛而谈
  • 避免重复已有的、更强有力的指导原则所隐含的规则

合适的形式：

  • “用户明确要求提交时，使用 /commit，而非手动执行 git 提交流程。”
  • “将 bug 修复扩展到相邻重构前，先征求确认。”

不合适的形式：

  • “更加谨慎。”
  • “采用更好的工作流。”

成功标准：你已确定一条可执行的经验候选，并有明确的提取理由。

第 2 步：检查当前 Claude 记忆并选择放置位置

阅读项目的 CLAUDE.md。如果该文件不存在，则使用 references/claude-md-template.md 作为结构备用模板。

选择正确的章节：

  • Workflow Rules
  • Session Management
  • Scope Control
  • Behavioral Patterns

写入前：

  • 搜索重复或近似重复的内容
  • 如果已有类似规则，则合并并调整措辞
  • 让新增指令简洁且限定在相关范围内

加载 references/learning-scope.md，了解放置位置和重复内容处理指南。

成功标准：已确定目标章节，并检查了重复风险。

第 3 步：向用户确认

编辑 CLAUDE.md 前，请向用户提供：

  • 类别
  • 最终措辞
  • 提取这条经验的原因
  • 计划放置的章节

如需确认或调整措辞，请使用 AskUserQuestion。

在用户明确批准该经验前，不要写入。

成功标准：用户已批准该经验及其放置位置。

第 4 步：更新 CLAUDE.md

进行最小且正确的编辑：

  • 保留文件结构
  • 将经验插入选定的章节
  • 避免删除无关内容
  • 仅当文件中已有“Last updated”标记时才更新该标记

规则：

  • 如果缺少 CLAUDE.md，使用提供的模板创建该文件，然后添加经验
  • 如果缺少相应章节，创建最小且兼容的章节，而不是重构整个文件
  • 保持格式与现有文档一致

成功标准：CLAUDE.md 在正确位置包含已批准的经验，且没有造成附带改动。

第 5 步：验证并报告

验证：

  • 经验已准确添加一次
  • 文件结构仍然合理
  • 指令仍然具体且可执行
  • 更新没有偏离到 Agent 或技能记忆领域

报告：

  • 类别
  • 章节路径
  • 最终措辞
  • 文件是新建还是已更新

成功标准：用户可以清楚看到 Claude 持久记忆具体发生了哪些变化。

防护措施

  • 不要让模型主动调用此技能；它会修改持久记忆。
  • 不要添加 context: fork；此工作流会编辑当前仓库。
  • 不要添加 paths:；这是一个通用维护技能。
  • 不要在 SKILL.md 中保留路由矩阵、质量评分表或冗长的失败案例目录。
  • 未经用户明确批准，不要添加经验。
  • 如果只需进行小范围定向插入，就不要大幅重写 CLAUDE.md。

何时加载参考资料

  • references/learning-scope.md 用于判断经验是否应归入 Claude 记忆、选择章节位置、处理重复内容，以及检查常见失败模式。

  • references/claude-md-template.md 仅在缺少 CLAUDE.md 或其结构需要最小兼容回退方案时使用。

输出约定

报告：

  1. 经验是已采纳还是转到其他位置
  2. 选定的类别和章节
  3. 最终批准的措辞
  4. CLAUDE.md 是新建还是已更新
  5. 任何重复内容合并或位置选择的决定

评论

支持 Markdown