Flow Attention Refresh - 注意力刷新协议

Overview

解决 "Lost in the Middle" 效应：当上下文过长时，原始目标被"推出"注意力窗口。

问题:
上下文开始: [原始目标 - 距离很远，被"遗忘"]
     ↓
... 50+ 工具调用 ...
     ↓
上下文末尾: [最近的工具输出 - 在注意力窗口]

解决:
在关键时刻强制读取目标文档 → 将目标"拉回"注意力窗口

The Iron Law

BEFORE MAJOR DECISION → READ GOAL FILES → THEN ACT

Refresh Protocols

Protocol 1: Flow Entry (每个 flow-* 命令开始)

触发点: 任何 /flow-* 命令的 Entry Gate

动作:

read:
  - BRAINSTORM.md "成功标准" 章节
  - TASKS.md 当前阶段任务列表
focus: 本次命令要达成什么？

实现: 已由现有 Brainstorm Alignment Check 覆盖

Protocol 2: Task Start (flow-dev 每个任务开始)

触发点: flow-dev TDD 循环中，每个任务执行前

动作:

read:
  - TASKS.md 当前任务 T### 段落 + DoD
  - quickstart.md 相关命令
focus: 这个任务的验收标准是什么？

实现位置: flow-dev.md 阶段 3 TDD 循环

代码片段:

**注意力刷新** (Protocol 2):
→ Read: TASKS.md 当前任务 T### 段落
→ Focus: 任务目标和 DoD
→ Then: 开始执行任务

Protocol 3: Ralph Iteration (Ralph 循环每次迭代)

触发点: /flow-ralph 每次迭代开始

动作:

read:
  - TASKS.md 第一个未完成任务
  - ERROR_LOG.md 最近 5 条记录
focus: 下一步行动 + 避免重复错误

实现位置: flow-ralph.md Ralph Loop 开始处

代码片段:

**注意力刷新** (Protocol 3):
→ Read: TASKS.md 找到第一个 `- [ ]` 任务
→ Read: ERROR_LOG.md 最近 5 条（如存在）
→ Focus: 下一步行动是什么？有什么错误需要避免？
→ Then: 执行任务

Protocol 4: Error Recovery (遇到错误后)

触发点: 测试失败、构建错误、运行时异常后

动作:

read:
  - ERROR_LOG.md 当前错误记录
  - TASKS.md 当前任务定义
focus: 错误根因 + 解决方案

实现位置: flow-tdd skill 错误处理部分

代码片段:

**错误恢复刷新** (Protocol 4):
→ Record: 将错误追加到 ERROR_LOG.md
→ Read: ERROR_LOG.md 当前错误 + 历史相似错误
→ Read: TASKS.md 当前任务
→ Focus: 根因分析，避免盲目修复
→ Then: 有针对性地修复

Integration Map

现有机制:
┌──────────────────────────────────────┐
│ flow-brainstorming skill             │
│ ↓ 触发于 /flow-init                  │
│ ↓ 输出 BRAINSTORM.md                 │
└──────────────────────────────────────┘
              ↓
┌──────────────────────────────────────┐
│ Brainstorm Alignment Check           │
│ ↓ 在每个 flow-* Entry Gate           │
│ ↓ 读取 BRAINSTORM.md 验证对齐        │
│ ↓ = Protocol 1                       │
└──────────────────────────────────────┘

新增机制:
┌──────────────────────────────────────┐
│ flow-attention-refresh skill (本文件) │
│ ↓ 被 flow-dev, flow-ralph 引用       │
│ ↓ 在更细粒度的时刻刷新注意力          │
│ ↓ Protocol 2, 3, 4                   │
└──────────────────────────────────────┘

Rationalization Prevention

Red Flags - STOP

如果你发现自己：

• 开始任务前没有读取 TASKS.md
• 遇到错误后没有先记录 ERROR_LOG.md
• Ralph 循环中忘记读取上次错误
• 做决策时没有参考 BRAINSTORM.md

STOP。执行对应的 Protocol。

[PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md