30 lines
1.7 KiB
Markdown
30 lines
1.7 KiB
Markdown
# 阶段边界与稳定知识
|
||
|
||
到达阶段边界或感到上下文压力时，只按下列顺序选择首个满足项：
|
||
|
||
1. **继续当前 session**：下一阶段需要当前 session 作为 primary source，或剩余 smart zone 足够
|
||
（约 150k tokens）。
|
||
2. **使用 `clear`**：上下文与下一阶段无关，且没有必须随身携带的未交接事实。
|
||
3. **使用 `handoff`**：跨 harness、目录、仓库或同事，或需要 mid-phase 旁支；
|
||
`handoff` 解决的是可移植性，不是上下文过长。
|
||
4. **交给 subagent**：工作可独立、边界清楚并可 AFK，且主 session 不需要实时决策。
|
||
5. **使用 `compact`**：其余情况；说明要保留的事实、当前路由和下一动作。
|
||
|
||
`clear`、`compact`、`handoff`、压缩或恢复后，重新加载 `SKILL.md` 与当前路由文件，
|
||
并重新读取会改变下一步动作的项目规则；不得只依据 `status` 输出继续。
|
||
稳定知识不能替代阶段上下文。
|
||
|
||
## 稳定知识准入与归属
|
||
|
||
只把已经验证且可复现的事实写入稳定知识，并且至少满足一项：重新发现成本高、
|
||
不能从代码直接看出、下一 session 仍需要。
|
||
|
||
- `memory-bank/project-brief.md`：稳定定位、边界和目标。
|
||
- `memory-bank/tech-context.md`：已验证的工具链和验证入口。
|
||
- `memory-bank/system-patterns.md`：当前模块边界与不变量。
|
||
- `CONTEXT.md`：稳定领域词汇；关键取舍及理由写入 `docs/adr/`；项目执行规则写
|
||
`AGENT_RULES.local.md`。
|
||
- `handoff` 产物写入 OS 临时目录，不写稳定知识文件。
|
||
|
||
按需使用 `domain-modeling`；`codebase-design` 只作词汇来源，不单独起会话。
|