运行时配置(第0步 - 任何处理之前)
阅读这些文件以配置特定领域的操作:
-
ops/derivation-manifest.md— 词汇映射,领域上下文- 使用
vocabulary.notes作为笔记文件夹名称 - 使用
vocabulary.note作为输出中的笔记类型名称 - 使用
vocabulary.rethink作为阈值警报中的rethink命令名称 - 使用
vocabulary.topic_map作为MOC引用
- 使用
-
ops/config.yaml— 阈值self_evolution.observation_threshold(默认:10)— 用于阈值警报self_evolution.tension_threshold(默认:5)— 用于阈值警报
-
ops/methodology/— 在创建新笔记之前阅读现有的方法论笔记(防止重复)
如果这些文件不存在(预初始化调用或独立使用),则使用通用默认值。
立即执行
目标:$ARGUMENTS
立即解析:
- 如果目标包含引用描述或未引用文本:显式模式 — 用户直接描述摩擦
- 如果目标为空:上下文模式 — 回顾最近的对话以查找更正
- 如果目标包含
--mine-sessions或--mine:会话挖掘模式 — 扫描ops/sessions/以查找模式
现在开始。 下面的定义定义了三种模式。
显式模式
用户提供描述:/remember "不要处理像研究一样的个人笔记" 或 /remember 总是在创建之前检查重复项
第1步:解析摩擦
分析用户的描述以提取:
- 代理做错了什么(或用户想要防止什么)
- 用户想要的是什么(正确的行为)
- 范围 — 何时适用?始终如此?仅适用于特定内容类型?仅在某些阶段?
- 类别 — 这影响代理行为的哪个领域?
| 类别 | 适用时 |
|---|---|
| processing | 如何提取、减少或处理内容 |
| capture | 如何记录、归档或组织传入材料 |
| connection | 如何找到、评估或添加笔记之间的链接 |
| maintenance | 如何处理健康检查、重新编织、清理 |
| voice | 如何编写,使用什么语气或风格 |
| behavior | 代理的一般行为,交互模式 |
| quality | 笔记、描述、标题的标准 |
第2步:检查现有方法论笔记
在创建新笔记之前,阅读 ops/methodology/ 中的所有文件:
ls -1 ops/methodology/*.md 2>/dev/null
对于每个现有笔记,检查它是否涵盖相同的行为领域。具体来说:
- 现有笔记是否涉及同一领域的相同摩擦?
- 新学习是否扩展现有笔记而不是需要一个新的?
| 检查结果 | 行动 |
|---|---|
| 此领域没有现有笔记 | 创建新的方法论笔记 |
| 现有笔记涵盖同一领域的不同方面 | 创建新笔记,链接到现有 |
| 现有笔记涵盖相同的摩擦 | 用新证据扩展现有笔记,而不是创建重复项 |
| 现有笔记与新摩擦相矛盾 | 创建一个新的方法论笔记 AND 关于矛盾的观察 |
第3步:创建方法论笔记
写入 ops/methodology/:
规则零: 这个方法论笔记成为系统规范的一部分。ops/methodology/不是一个记录发生了什么的日志 — 它是系统应该如何行为的权威声明。将这个笔记写成指令:代理应该做什么,而不是出了什么问题。未来的会话,/rethink漂移检查和元技能将参考这个笔记作为系统行为的真相。
文件名: 将散文标题转换为kebab-case。例如:"不要处理像研究一样的个人笔记"变成dont-process-personal-notes-like-research.md。
---
description: [这个方...(此处省略原文以节省篇幅)
## 方法论学习循环
这是/remember参与的完整循环:
工作发生 → 用户纠正代理行为(显式或隐式) → /remember将更正作为方法论笔记捕获 → 方法论笔记归档到ops/methodology/ → 代理在会话开始时读取方法论笔记(通过上下文文件引用) → 代理行为改进 → 需要的更正更少 → 当方法论笔记累积(同一类别中的3+) → /rethink分类并检测模式 → 将模式提升到上下文文件更改 → 系统方法论在架构层面发展 → 循环在新的摩擦边缘继续
每一层循环都服务于不同的目的:
- /remember 捕获个别摩擦点 — 快速,低仪式
- ops/methodology/ 存储累积的行为指导 — 跨会话持久化
- /rethink 检测模式并提出结构更改 — 定期,深思熟虑
- ops/context.md(或等效)体现系统的稳定方法论 — 很少变化,经人工批准
当方法论笔记累积缓慢(摩擦正在得到解决)并且/rethink在超过阈值时将模式提升到上下文级别的更改时,循环是健康的。
当同一类别不断获得方法论笔记而没有提升时,循环是不健康的(系统正在捕获摩擦但没有从中学习)。
规则零:方法论作为规范规范
方法论文件夹不仅仅是摩擦捕获日志。它是系统的权威自我模型 — 从哪个漂移被测量的规范规范。
这对/remember意味着什么:
- 你创建的每个方法论笔记都成为规范的一部分。写指令,而不是事件报告。
- 标题应该是一个可操作的行为(“在创建任何笔记之前检查语义重复项”)而不是问题描述(“重复创建问题”)。
- 未来的/rethink会话将把系统行为与方法论笔记声明的内容进行比较。含糊的笔记创建不可测量的规范。
这对系统意味着什么:
- ops/methodology/由元技能(/ask,/architect,/rethink)作为系统如何工作的真相来源。
- 漂移检测将方法论笔记断言与实际config.yaml和上下文文件状态进行比较。
- 当方法论笔记过时(比config更改更旧)时,系统将此作为维护条件呈现。
方法论文件夹是规范。/remember编写规范。/rethink执行规范。循环是封闭的。
方法论笔记设计
标题模式
方法论笔记标题应该描述代理应该做什么,而不是出了什么问题:
| 坏的(描述问题) | 好的(描述行为) |
|---|---|
| “重复创建问题” | “在创建任何笔记之前检查语义重复项” |
| “错误的语气问题” | “在所有输出中匹配用户的正式程度” |
| “处理过于激进” | “在处理深度上区分个人笔记和研究” |
标题是代理在会话开始时阅读的内容。它应该是立即可操作的行为指令。
正文质量
方法论笔记是操作指导,而不是散文。它们应该是:
- 足够具体,以便新的代理会话可以遵循这些指导而不需要会话的上下文
- 明确范围 — 何时适用,何时不适用?
- 双面 — 既做什么又避免什么
- 基于证据 — 引用触发此学习的特定摩擦
类别选择
选择最具体的适用类别:
| 类别 | 何时使用 |
|---|---|
| processing | 摩擦期间/reduce,提取,声明创建 |
| capture | 摩擦期间收件箱归档,原始材料处理 |
| connection | 摩擦期间/reflect,链接评估,MOC更新 |
| maintenance | 摩擦期间/reweave,健康检查,清理 |
| voice | 关于写作风格,语气,输出格式化的摩擦 |
| behavior | 关于一般代理行为,交互模式,工具使用的摩擦 |
| quality | 关于笔记质量,描述写作,标题制作的摩擦 |
如果摩擦点跨越类别(例如,“处理声音"或"捕获质量”),选择主要类别并在正文中提及次要类别。
边缘情况
没有ops/methodology/目录
创建它和 ops/methodology.md MOC:
---
description: 方法论笔记捕获这个系统如何学会操作
type: moc
---
# methodology
按类别组织的方法论笔记。每个笔记捕获特定的行为学习。
## Processing
## Capture
## Connection
## Maintenance
## Voice
## Behavior
## Quality
重复摩擦
如果已经存在非常相似内容的方法论笔记:
- 不要创建重复项
- 链接到现有笔记
- 将新实例作为证据添加:用新上下文更新现有笔记的正文
- 报告:“用额外的证据扩展了现有方法论笔记 [[title]]”
与现有方法论相矛盾
如果新摩擦与现有方法论相矛盾(用户现在想要与之前捕获的相反):
- 在
ops/observations/中创建一个观察笔记,记录矛盾 - 更新现有方法论笔记的状态为
superseded并添加superseded_by: [new note] - 创建具有更新指导的新方法论笔记
- 报告矛盾,并建议/rethink如果这是更广泛模式的一部分
没有会话可挖掘
清楚地报告:“在ops/sessions/中没有发现未处理的会话。” 不要将其视为错误。
非常长的会话
对于超过2000行的会话:
- 以大约500行的块处理
- 跟踪跨块的发现,以检测跨越会话的模式
- 报告块级进度以提高透明度
隐式与显式更正
有些更正是隐式的 — 用户自己做而不是告诉代理更改:
- 用户手动编辑代理创建的笔记(编辑揭示了出了什么问题)
- 用户选择不同的方法而不解释为什么
- 用户跳过代理建议的步骤
在上下文模式中,将这些标记为低信心发现,并在从隐式信号创建方法论笔记之前始终确认。
空对话上下文
在上下文模式中没有对话历史(例如,会话的第一条消息):
--=={ remember — contextual }==--
没有对话上下文可供分析。
使用/remember "description"直接捕获特定的摩擦。