Auto-Context — 情境感知协议（元技能）

在执行任何操作前，先理解你所处的环境。该技能确保 AI 在执行任一重大操作前，自动加载关键项目上下文，从而避免无效劳动、重复工作以及偏离目标的实现。

安装

OpenClaw / Moltbot / Clawbot

npx clawhub@latest install auto-context

激活时机

该技能根据当前操作自动触发。无需等待用户明确指示——只要满足以下任一条件，即应主动加载上下文。

需读取的上下文文件

按优先级顺序读取以下文件。若任务范围较窄且低优先级文件明显无关，可提前终止读取。

备选路径

部分项目使用不同路径。若主路径下无对应文件，请检查以下备用路径：

上下文加载策略

步骤 1：加载 Critical 级别文件（始终执行）

读取 TODO.md → 提取：当前任务、下一优先级事项、阻塞项
读取 roadmap.md → 提取：当前阶段、活跃里程碑、即将截止日期

若任一 Critical 文件缺失，则向用户发出警告：

“未找到 TODO.md。建议创建该文件以跟踪任务。”

步骤 2：加载 High 级别文件（若存在）

读取 task_plan.md → 提取：实施步骤、验收标准
遍历 .cursor/handoffs/*.md → 按修改时间倒序读取最近 3 个

步骤 3：按需加载 Medium/Low 级别文件

仅当当前任务确实受益于历史上下文时才读取：

• 正在调试？ — 读取 findings.md 和 CHANGELOG.md
• 正在规划？ — 读取全部文件（含会话文件）
• 快速修复？ — 完全跳过 Medium 和 Low 级别文件

步骤 4：综合提炼并呈现

完成加载后，在执行任务前生成上下文摘要（格式见下文）。

陈旧性检测

检查所有已加载文件的最后修改时间，标记可能包含过时信息的文件。

在 macOS 上检查文件年龄：

stat -f "%m %N" TODO.md roadmap.md task_plan.md findings.md CHANGELOG.md 2>/dev/null

在 Linux 上：

stat -c "%Y %n" TODO.md roadmap.md task_plan.md findings.md CHANGELOG.md 2>/dev/null

上下文摘要格式

完成上下文加载后，请使用如下模板输出简洁摘要。务必精炼——目标是建立情境意识，而非复述细节。

## Context Loaded

**当前阶段：** {来自 roadmap 的阶段名称}
**活跃里程碑：** {里程碑名称及进展}

**当前任务：** {来自 TODO.md 或 task_plan.md}
- 状态：{进行中 / 已阻塞 / 未开始}
- 阻塞项：{列出所有阻塞项，或写“none”}

**近期变更：**
- {从 CHANGELOG 或 handoffs 中提取最近 2–3 条记录}

**相关发现：**
- {影响当前任务的关键发现，或写“none”}

**陈旧性警告：**
- {列出所有陈旧性警告，或写“all context is fresh”}

若完全未找到任何上下文文件，则输出：

## Context Loaded

未找到任何项目上下文文件。当前在无历史上下文状态下运行。
建议创建 TODO.md 和 roadmap.md，以启用具备上下文感知能力的辅助支持。

集成点

该技能与其他工作流命令紧密集成，应在主命令执行前先行运行。

执行顺序

用户触发操作
  → Auto-Context 激活（本技能）
    → 呈现上下文摘要
      → 主技能/命令在完全知情的前提下执行

速查清单

上下文加载检查清单：
  1. 读取 TODO.md（Critical）
  2. 读取 roadmap.md（Critical）
  3. 若存在则读取 task_plan.md
  4. 若存在则读取最近 3 个 handoffs
  5. 检查各文件陈旧性
  6. 若相关则读取 findings.md / CHANGELOG.md
  7. 呈现上下文摘要
  8. 开始执行任务

绝对禁止事项

1. 绝不可为节省时间跳过 Critical 文件 —— 将导致重复劳动与相互冲突的实现
2. 绝不可无视任务性质而加载全部文件 —— 浪费 token 并引入大量无关信息，干扰聚焦
3. 绝不可忽略陈旧性警告 —— 基于过时上下文所做的决策必然失准
4. 绝不可读取文件却不加以总结 —— 原始文件内容堆砌令人难以消化；必须先综合提炼
5. 绝不可仅依赖记忆中的上下文 —— 会话本身无状态；每次均须重新读取文件
6. 绝不可在无任何上下文时静默继续 —— 用户必须明确知晓自己正“盲操作”
7. 绝不可超出限制读取 handoffs / sessions —— 最近 3 个 handoffs 与最近 2 个 sessions 已足够