mcpField
M
meditate

meditate

github.com/potetoAgent 工作流564228 次安装32 周前更新
代码仓库

关于 meditate

Meditate 是用于审查和维护 Agent 记忆、指令与技能的 Skill。它通过分阶段审计、复核、定向修改和清理来处理内容,并在非交互会话中自动应用高置信度变更。

主要功能

  1. 01审计记忆、指令与技能
  2. 02分阶段执行审计和复核
  3. 03识别过时、重复及低价值笔记
  4. 04应用修改并更新索引
  5. 05清理过期会话状态

适用场景

  1. 01删减过时的项目笔记
  2. 02发现技能与原则之间的冲突
  3. 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]

评论

支持 Markdown