用途:Learn 用于把项目中的纠正、洞察和重复模式记录下来,并路由到合适的指令文件,避免同类问题反复出现。它适合在模式重复出现 3 次以上时使用,或用于保存经验。
主要能力:支持四种动作。传入纠正文本时,将纠正路由到合适的指令文件;review 显示待处理学习项及其出现频率;promote 将高频学习项(出现 3 次以上)提升到指令文件;audit 检查过期、矛盾或重复的学习项;无参数时显示用法摘要。
路由协议:按范围选择目标。跨项目约定写入 instructions/global.md;语言相关工具写入对应约定技能(如 python-conventions);编排与并行写入 orchestrator 技能正文;项目特定标准写入项目的 AGENTS.md;仅文件级约束创建 .claude/rules/<topic>.md;技能行为写入该技能自身的 SKILL.md。路由决策依次判断:是否适用于所有项目、是否与特定语言或工具相关、是否仅限项目、是否仅需文件级约束。
Kaizen 原则:增量优于革命,做最小可行改动并验证后再继续;poka-yoke,优先用钩子或工具而非文字说明;遵循既有模式并记录有效做法;JIT,只构建所需内容,测量后再优化。
验证清单:对照实际实践确认模式反映真实用法;检查与现有指令是否矛盾;评估 token 影响,保持常加载内容最小;获得用户批准;修改指令文件后运行 python scripts/check.py 测试。
关键规则:未经用户明确批准不得修改指令文件;跨 2 个以上会话累计 3 次以上纠正才可提升;检查与现有指令的矛盾;路由到最窄适用范围(规则优先于技能,技能优先于全局);保持常加载内容在 token 预算内;每次修改指令文件后运行 python scripts/check.py;优先使用钩子或规则而非文字说明。
完成标准:在技能目录下运行 python scripts/check.py,退出码为 0,且该技能目录下无 portable-CLI 违规。
限制:资料未提供具体安装方式、收费信息、支持平台及更多使用示例。