名称: 笔记 描述: 管理持久工作记忆。添加优先级上下文、手动笔记或跨会话持久的工作记忆。 参数提示: “<内容> [–priority|–manual|–show|–prune|–clear]” 允许的工具: Read, Write, Edit, Bash, Glob, AskUserQuestion 禁用模型调用: true
笔记 — 持久工作记忆
管理跨Claude Code会话持久的笔记。优先级上下文在会话开始时注入。
存储
所有笔记位于 .maestro/notepad.md,包含三个部分:
# 记事本
## 优先级上下文
[在每个会话开始时注入 — 用于关键提醒]
## 工作记忆
[从会话中积累的上下文 — 自动管理]
## 手动
[用户编写的笔记,直到手动删除]
命令
默认(无标志): 添加到工作记忆
/note 修复: 身份验证中间件缺少令牌刷新检查
将内容作为项目符号追加到 ## 工作记忆。
--priority: 添加到优先级上下文
/note --priority 在生产部署前修复身份验证
将内容作为项目符号追加到 ## 优先级上下文。此部分由 session-start.sh 读取并注入每个新会话。
--manual: 添加到手动笔记
/note --manual API速率限制为每个密钥每分钟100请求
将内容作为项目符号追加到 ## 手动。
--show: 显示记事本
/note --show
读取并显示完整的记事本内容。
--prune: 修剪工作记忆
/note --prune
从 ## 工作记忆 中删除不再相关的条目。保持 ## 优先级上下文 和 ## 手动 完整。使用判断删除过时项目 — 如果不确定,询问用户。
--clear: 清除部分
/note --clear priority
/note --clear working
/note --clear all
清除指定部分(或所有部分)。在清除 ## 优先级上下文 或全部之前请求确认。
工作流程
步骤 1: 解析参数
从用户输入中提取标志(如果有)和内容。
- 无标志 → 默认为工作记忆
--priority→ 优先级上下文--manual→ 手动--show→ 仅显示--prune→ 修剪工作记忆--clear <部分>→ 清除部分
步骤 2: 确保记事本存在
如果 .maestro/notepad.md 不存在,使用模板创建它:
# 记事本
## 优先级上下文
## 工作记忆
## 手动
同时确保 .maestro/ 目录存在。
步骤 3: 执行命令
对于添加命令 (default, --priority, --manual):
- 读取当前记事本
- 找到目标部分标题
- 在部分标题后(下一部分之前)追加
- <内容> - 写入更新后的记事本
对于 --show:
- 读取并显示记事本
- 如果不存在,说“未找到记事本。使用
/note <内容>开始。”
对于 --prune:
- 读取记事本
- 审查
## 工作记忆中的每个项目符号 - 删除看起来过时或已解决的项目
- 显示被删除的内容
对于 --clear:
- 与用户确认(除非仅清除工作记忆)
- 从指定部分(s)中删除所有项目符号
- 保持部分标题完整
步骤 4: 确认
在任何写入操作后,显示更新后的部分以确认更改。
部分合同
| 部分 | 写入者 | 读取者 | 持久性 |
|---|---|---|---|
| 优先级上下文 | 用户通过 --priority |
session-start.sh |
直到手动清除 |
| 工作记忆 | 默认 /note |
会话, 修剪 | 定期修剪 |
| 手动 | 用户通过 --manual |
会话 | 直到手动清除 |