- name
- soul-keeper
- description
- |
Workspace Optimizer
核心理念
每个文件有自己的自然更新节奏,不是等用户抱怨才改。
各文件的 Trigger 表
| 文件 | 更新时机 | 信号 |
|---|---|---|
| SOUL.md | Agent 行为需要调整 | 同类纠正 2+ 次;沟通风格变了;新边界 |
| USER.md | 用户情况变了 | 新方向;新偏好;新习惯;新设备/环境 |
| AGENTS.md | 工作流程变了 | 新 docs/ 规则文件;启动流程调整;新触发规则 |
| TOOLS.md | 工具链变了 | 新工具;旧工具出事;致命用法发现 |
| MEMORY.md | 世界状态变了 | 新项目;项目完结;新环境配置 |
| WORKING.md | 项目进度变了 | 实质进展;新项目;项目暂停/完成 |
| IDENTITY.md | 几乎不变 | 改名;改定位 |
| HEARTBEAT.md | 检查清单变了 | 新定时任务;旧任务移除 |
触发后流程
1. 读写作指南
必须先读:docs/WORKSPACE_FILES_GUIDE.md
2. 读取对应文件
根据 trigger 类型读对应文件。
3. 对比分析
- 文件内容是否和现实一致?
- 该加的信息放哪个文件?(根据 Guide 职责划分)
- 加了会不会超 token 预算?
- 有没有旧内容该删/归档?
4. 输出建议
📝 [文件名] 该更新了
原因:[什么 trigger 了这次检查]
现在:[当前相关内容]
建议:[具体修改]
要更新吗?5. 确认后执行
- 用户确认 → 执行修改
- 用户拒绝 → 记录到 memory/ 留底
主动检查场景
除了被动 trigger,以下场景主动检查:
- 新项目讨论完毕 → 检查 MEMORY.md 和 WORKING.md 是否需要加项目
- 一轮深度对话结束 → 检查有没有新发现该落进 USER.md 或 SOUL.md
- 新 docs/ 文件创建后 → 检查 AGENTS.md 索引是否需要加入
- 安装新 Skill 后 → 检查 TOOLS.md 是否需要加规则
- 用户明显改变沟通风格 → 检查 USER.md 是否需要更新偏好
规则
- 不自动改文件 — 必须用户确认
- 一次只建议改一个文件
- 遵守 Guide 的职责划分和 token 预算
- 检查重复 — 已有类似内容不重复加
- 该删也提 — 过时内容建议删除或归档
- 措辞匹配 — 新内容风格和文件现有内容一致
Token 预算
| 文件 | 最大 |
|---|---|
| SOUL.md | 800B |
| USER.md | 800B |
| IDENTITY.md | 300B |
| AGENTS.md | 1.5KB |
| TOOLS.md | 1KB |
| MEMORY.md | 1.5KB |