mcpField
L
learn

learn

github.com/wyattowalshAgent 工作流569 次安装9 周前更新
代码仓库

关于 learn

learn 是用于记录项目纠正意见与经验的 Agent 技能，并将其分流到合适的指令文件。它还可审查、提升和检查积累的经验。

主要功能

  1. 01按项目范围分流更新
  2. 02查看待处理经验及频次
  3. 03提升反复出现的经验
  4. 04检查过时或冲突的记录
  5. 05修改文件前要求批准

适用场景

  1. 01将纠正意见分流到项目指令文件
  2. 02更新指南前审查经验模式
  3. 03查找重复或过时的经验

安装

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

$npx skills add https://github.com/wyattowalsh/agents --skill learn

安装后在 Claude Code 中输入/learn确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

evals/
correction-routing.json
evals.json
promote-mode.json
review-mode.json
references/
kaizen-principles.md
routing-rules.md
scripts/
check.py
state.py
scripts/asset_toolkit/
__init__.py
_shared.py
common.py
package.py
validate_evals.py
validate_hooks.py
validate_skill.py

详细介绍

学习 — 捕获并路由项目知识

记录更正、见解和模式。将它们路由到正确的指令文件。应用改善原则，让指令保持精简且有效。

分派

$ARGUMENTS操作
"<correction text>"将更正路由到适当的指令文件
review显示待处理的学习内容及其出现频率
promote将高频学习内容（出现 3 次以上）提升到指令文件中
audit检查过时、矛盾或重复的学习内容
Empty显示用法摘要

参考资料

文件用途
references/routing-rules.md指令变更应路由到何处的决策树
references/kaizen-principles.md防错模式，以及何时使用钩子、散文说明或规则

路由协议

将拟议的更新路由到正确的目标：

范围目标
跨项目约定instructions/global.md
特定语言的工具约定技能（python-conventions 等）
编排／并行处理orchestrator 技能正文
项目特定标准项目的 AGENTS.md
文件范围内的强制规则.claude/rules/<topic>.md
技能行为技能自身的 SKILL.md
路由决策步骤
  1. 确定范围：这适用于所有项目，还是仅适用于一个项目？
  2. 如果是跨项目的，判断它是否与特定语言或工具有关。
  3. 如果是特定语言的，将其路由到对应的约定技能
  4. 如果是通用内容，将其路由到 instructions/global.md
  5. 如果仅适用于某个项目，将其路由到该项目的 AGENTS.md
  6. 如果仅需在文件范围内强制执行，则创建一个 .claude/rules/ 条目

改善原则

  1. 渐进优于颠覆 — 采用最小可行变更，验证后再进行下一步
  2. 防错 — 优先使用钩子／工具，而非散文式指令（通过设计防止错误）
  3. 标准化工作 — 遵循现有模式，记录有效做法
  4. 即时 — 仅构建所需内容，根据测量结果进行优化

验证清单

  1. 对照实际实践进行验证 — 确认该模式反映了真实用法
  2. 检查是否与现有指令矛盾
  3. 评估 token 影响 — 将始终加载的内容保持在最低限度
  4. 获取用户批准 — 未经同意，绝不修改指令文件
  5. 测试变更 — 修改任何指令文件后，运行 python scripts/check.py

关键规则

  1. 未经用户明确批准，绝不修改指令文件
  2. 提升内容前，要求在 2 个以上会话中出现 3 次以上更正
  3. 检查是否与现有指令矛盾
  4. 路由到适用范围最窄的目标（规则优先于技能，技能优先于全局）
  5. 将始终加载的内容控制在 token 预算以内
  6. 每次修改指令文件后都运行 python scripts/check.py
  7. 优先使用钩子／规则，而非散文式指令（防错原则）

规范术语

  • instruction file — 提供 Agent 指令的任何文件（global.md、AGENTS.md、SKILL.md）
  • routing — 为变更选择正确目标文件的过程
  • correction pattern — 表明缺少或错误指令的重复修正
  • token budget — 始终加载的指令内容上限
  • scope — 跨项目、特定语言、编排、项目特定或文件范围

验证约定

在此技能目录中运行以下命令，再宣布变更完成：

python scripts/check.py

完成标准：

  1. scripts/check.py 以状态码 0 退出。
  2. 此技能目录下不再存在可移植 CLI 违规。

评论

支持 Markdown