📝 docs(memory): bound context snapshot sections

This commit is contained in:
csh
2026-05-27 14:53:21 +08:00
parent 16287e207f
commit 30c1582186
5 changed files with 51 additions and 1 deletions
@@ -27,12 +27,20 @@
- 最近变更
- touched files
- 下一步
- 本文件是短期上下文快照,不是长期日志
- `Recent Changes` 只保留最近 3-5 条仍影响后续判断的变化
- `Touched Files` 只保留当前 Plan / 下一轮仍相关的文件
- `Next Steps` 只保留接下来最优先的 1-3 步
- 更新时整理/替换旧上下文,不做无限追加
### `memory-bank/progress.md`
- 先读取 `workflow-state`:当前阶段、spec、plan、executor、constraints
- 再读取 `plan-status`:当前 Plan 的机器状态
- 只更新上半部分的人类摘要,不修改状态块
- 上半部分是短期状态快照,不是长期日志
- `Recent Changes` 只保留最近 3-5 条对恢复上下文有价值的变化
- 更新时整理/替换旧摘要,不要把 `Recent Changes` 当作无限追加日志
### `memory-bank/decisions.md`
@@ -55,6 +63,8 @@
- 流程规则或项目私有约束变更写入 `AGENT_RULES.local.md`
- `progress.md` 的状态块只由 `main_loop.py` 维护
- 摘要应与 `workflow-state` / `plan-status` 保持一致
- 摘要区保持短期状态快照;长期历史依赖 commit、Plan 文件和
`decisions.md`
## 禁止事项