♻️ refactor(cook-it-through): move workflow engine into skill

This commit is contained in:
csh
2026-08-20 17:02:34 +08:00
parent f6854d065a
commit 9b95bf2682
19 changed files with 3905 additions and 1474 deletions
@@ -0,0 +1,29 @@
# 阶段边界与稳定知识
到达阶段边界或感到上下文压力时,只按下列顺序选择首个满足项:
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` 只作词汇来源,不单独起会话。