Skip to content

AI 协作场景

介绍

agent-context 最有价值的地方,不是“多了几个动作名”,而是把一类常见协作场景固定成统一流程。

如果文档只说“像和同事一样跟 AI 协作”,用户仍然不知道什么时候该 plan,什么时候该 patch。这页给出更具体的任务流。

快速使用

先按任务类型判断:

  • 新需求且需要拆解:plan
  • 计划还没执行,但方案要变:replan
  • 当前计划已经执行过,还要继续改:patch
  • 任务很小且边界清楚:rush

如果你只记一条规则,记这一条:

text
已执行计划上的任何增量需求,都优先走 patch,不要重新 plan。

API参考

场景 1:开发一个中等复杂度的新功能

适用情况:

  • 涉及多个文件
  • 需要先拆步骤
  • 可能持续几轮对话

推荐流程:

  1. 为“新增 Excel 导出功能”出计划
  2. 审阅 plan.md 是否合理
  3. 按当前计划开始实现
  4. 如果实现后又发现一个小问题:给当前计划补一个 patch,...
  5. 全部完成后:当前计划已经真正完成,归档它

为什么这样做:

  • plan 负责把复杂任务结构化
  • implement 保证 AI 不会偏离计划
  • patch 保留增量修改记录,不污染主计划

场景 2:原计划还没开始,但方案推翻重来

适用情况:

  • 计划还处于 未执行
  • 你想改技术路线、拆分方式或验收思路

推荐指令:

text
重做当前计划,不再引入第三方库,改成基于现有 core 能力实现

为什么这样做:

  • 这是典型的 replan
  • 还没实施就不要用 patch
  • 也不应该让 AI 一边改代码一边偷偷改计划

场景 3:需求非常明确,直接做完更高效

适用情况:

  • 目标只有一件事
  • 验收标准清楚
  • 不值得先单独花一轮对话做计划确认

推荐指令:

text
rush 一下,把 agent-context 文档中的 action 说明补全

为什么这样做:

  • rush 会先创建单计划,再直接实施
  • 适合文档修订、单测修复、小脚本调整
  • 不适合模糊需求或大范围重构

场景 4:主任务做完了,但上线前又冒出一个小问题

适用情况:

  • 当前计划已经是 已执行
  • 新问题仍属于同一任务上下文

推荐指令:

text
给当前计划补一个 patch,修复 Windows 下路径分隔符导致的失败

为什么这样做:

  • 继续 plan 会打断上下文连续性
  • patch 会把增量改动留在当前计划下面
  • 主计划的影响范围和补丁历史会保持完整

场景 5:你要把任务正式收尾

适用情况:

  • 当前计划及相关 patch 都完成了
  • 需要开始下一个 preparing 计划,或清空上下文

推荐指令:

text
当前计划已经真正完成,归档它

为什么这样做:

  • done 会把当前计划归档到 done/
  • 如果有准备中的计划,下一个计划会被晋升
  • 这样下一次对话时,AI 不会继续把旧计划当成活跃任务

基于 MIT 许可发布