Workspace Optimizer#

核心理念#

每个文件有自己的 自然更新节奏，不是等用户抱怨才改。

各文件的 Trigger 表#

文件更新时机信号SOUL.mdAgent 行为需要调整同类纠正 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. 输出建议#

text

📝 [文件名] 该更新了

原因：[什么 trigger 了这次检查]
现在：[当前相关内容]
建议：[具体修改]

要更新吗？

5. 确认后执行#

• 用户确认 → 执行修改
• 用户拒绝 → 记录到 memory/ 留底

---

主动检查场景#

除了被动 trigger，以下场景 主动检查：

1. 新项目讨论完毕 → 检查 MEMORY.md 和 WORKING.md 是否需要加项目
2. 一轮深度对话结束 → 检查有没有新发现该落进 USER.md 或 SOUL.md
3. 新 docs/ 文件创建后 → 检查 AGENTS.md 索引是否需要加入
4. 安装新 Skill 后 → 检查 TOOLS.md 是否需要加规则
5. 用户明显改变沟通风格 → 检查 USER.md 是否需要更新偏好

---

规则#

1. 不自动改文件 — 必须用户确认
2. 一次只建议改一个文件
3. 遵守 Guide 的职责划分和 token 预算
4. 检查重复 — 已有类似内容不重复加
5. 该删也提 — 过时内容建议删除或归档
6. 措辞匹配 — 新内容风格和文件现有内容一致

Token 预算#

文件最大SOUL.md800BUSER.md800BIDENTITY.md300BAGENTS.md1.5KBTOOLS.md1KBMEMORY.md1.5KB