关于 meditate
Meditate 是用于审查和维护 Agent 记忆、指令与技能的 Skill。它通过分阶段审计、复核、定向修改和清理来处理内容,并在非交互会话中自动应用高置信度变更。
主要功能
- 01审计记忆、指令与技能
- 02分阶段执行审计和复核
- 03识别过时、重复及低价值笔记
- 04应用修改并更新索引
- 05清理过期会话状态
适用场景
- 01删减过时的项目笔记
- 02发现技能与原则之间的冲突
- 03精简记忆并添加有用链接
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ poteto/ noodle --skill meditate安装后在 Claude Code 中输入/meditate确认已加载。
附带文件references/agents.mdscripts/snapshot.sh
详细介绍
静心
自主会话模式
在非交互模式下运行时(Cook、Oops、Repair):
- 自主应用所有高置信度的更改。对于有歧义或风险较高的更改(删除脑文件、重写原则),改为创建待办事项。
- 使用
/commit技能提交所有更改。
质量标准: 一条笔记只有在具备高信号(Claude 若没有它,就会经常出错)、高频率(会在大多数会话或某类任务的大多数情况下出现)或高影响(出错会造成重大损失或浪费大量工作)时,才值得保留。其他内容都是噪声。精简、准确的脑库胜过全面却臃肿的脑库。
流程
使用 Tasks 跟踪进度(每个步骤使用 TaskCreate,使用 TaskUpdate 将状态设为 in_progress/completed)。
1. 构建快照
sh <skill-path>/scripts/snapshot.sh brain/ /tmp/brain-snapshot.md
sh <skill-path>/scripts/snapshot.sh .agents/skills/ /tmp/skills-snapshot.md
文件以 === path/to/file.md === 标题分隔。另请定位自动记忆目录(~/.claude/projects/<project>/memory/)。
2. 审计员(阻塞步骤——其报告将作为第 3 步的依据)
生成 general-purpose 子 Agent。完整提示词规范请参阅 references/agents.md § Auditor。输入:脑库快照、自动记忆路径、CLAUDE.md 路径。
审计脑库笔记、CLAUDE.md 和自动记忆,检查是否存在过时、冗余、价值低、冗长和孤立的内容,并返回分类报告。
提前退出条件: 如果审计员发现的可执行事项少于 3 项,则跳过第 3 步,直接进入第 4 步。
3. 审阅员(审计员完成后)
生成一个 general-purpose 子 Agent。完整提示词规范请参阅 references/agents.md § Reviewer。输入:脑库快照、技能快照、审计员报告、brain/principles.md。
在一次检查中综合处理三个方面:
- 综合整理:提出缺失的维基链接,指出原则间的冲突,并建议澄清内容。
- 提炼:找出揭示未明说原则的重复模式。新原则必须满足以下条件:(1) 相互独立;(2) 有 2 条或更多笔记作为依据;(3) 可指导行动。
- 技能审查:对照脑库原则检查技能。找出矛盾、缺失的结构性约束和冗余指令。审查描述 frontmatter 是否包含过多上下文。
4. 审阅报告
向用户提供汇总后的报告。格式请参阅 references/agents.md § Report Template。
5. 将技能专属经验归入相应位置
检查所有报告,找出应写入技能文件而非 brain/ 的发现。直接更新技能的 SKILL.md 或 references/。先阅读技能内容,以免重复。
6. 应用更改
直接应用所有更改。用户会审阅差异。
- 过时笔记:更新或删除
- 冗余笔记:合并到更完善的笔记中,删除较弱的笔记
- 低价值笔记:删除
- 冗长笔记:就地精简
- 新增关联:添加
[[wikilinks]] - 原则冲突:改写以明确边界
- 新原则:仅根据提炼部分的内容创建,且必须真正独立。编写脑库文件并更新
brain/principles.md - 合并原则:查找彼此包含或具体应用关系的原则——将较窄的原则合并到较广的原则中,并选择能概括合并后含义的名称
- 臃肿的技能描述:精简 frontmatter 描述——删去 Claude 能推断出的内容,只保留独特的触发条件和用途
- CLAUDE.md 问题:重写或删除
- 过时记忆:删除或重写
7. 整理
清理过时的 .noodle/ 状态(旧的讨论、已完成的会话、过时的计划文件)。对新增或删除的文件,更新 brain/index.md。
总结
## Meditate Summary
- Pruned: [N notes deleted, M condensed, K merged]
- Extracted: [N new principles, with one-line + evidence count each]
- Skill review: [N findings, M applied]
- Housekeep: [state files cleaned]