Action 说明

介绍

ac-workflow 的 action 不是 CLI 子命令，而是安装 Skill 之后你在对话里对 AI 说出的动作意图。

这套动作的目标是让 AI 不再“边做边猜”，而是先判断当前 .agent-context/ 所处的状态，再决定该创建计划、执行计划还是做增量修补。

快速使用

先记住两个原则：

1. 有活跃且已执行的当前计划，再提变更时优先走 patch
2. implement 只执行当前计划，不接受追加需求

最常见的说法如下：

初始化这个项目的 agent context
为“新增导出功能”出计划
按当前计划开始实现
给当前计划补一个 patch，修复 CSV 编码问题
当前计划已经真正完成，归档它

API参考

Action	适用时机	前置状态	典型产物
init	项目还没有稳定协作规则	无	新建或补全 AGENTS.md
plan	要开始一个新需求	不能有冲突的当前计划	.agent-context/plan-{N}/plan.md
replan	计划未执行，但方案要重做	目标计划必须是 未执行	更新后的计划结构
implement	计划已确认，开始实施	当前计划必须存在且为 未执行	代码或文档改动，计划状态变为 已执行
patch	已执行计划上补修复或增量需求	当前计划必须是 已执行	patch-{N}.md 与更新后的影响范围
rush	任务很明确，想直接创建并实施	当前不能有未实施计划	单计划立即执行
done	当前计划确实完成	当前计划必须是 已执行	当前计划归档到 done/

init

用于建立项目级协作基线。

适合：

• 新项目刚开始，还没有 AGENTS.md
• 老项目已有 AGENTS.md，但规则不完整或质量差

典型输入：

初始化这个项目的 agent context，技术栈是 Bun + TypeScript

执行重点：

• 判断项目是新项目还是旧项目
• 生成或补全 AGENTS.md
• 如果是新项目，可以继续推进到计划创建阶段

plan

用于把一个需求转换成正式计划。

适合：

• 需求已经明确，但还没开始实施
• 任务较复杂，需要拆步骤或拆成多个计划

典型输入：

为“给 HTTP 客户端增加重试插件”出计划

执行重点：

• 先做必要澄清，避免目标模糊
• 创建 plan.md
• 复杂任务可拆成“一个当前计划 + 多个 preparing 计划”

replan

用于重做未实施计划。

适合：

• 技术路线变了
• 原计划拆分不合理
• 想保留目标，但改动实施方式

典型输入：

重做当前计划，不引入任何新依赖

执行重点：

• 只处理 未执行 的计划
• 已执行计划不允许 replan
• 需要保持单当前计划模型

implement

用于严格执行当前计划。

适合：

• plan.md 已经存在
• 现在要开始真正落地

典型输入：

按当前计划开始实现

执行重点：

• 读取当前 plan.md
• 对照 ## 内容 逐项实施
• 完成验证后，把状态改成 已执行
• 回写 ## 影响范围

patch

用于在已执行计划上做增量修改。

适合：

• 修 Bug
• 补遗漏项
• 加一个不值得新开计划的小改动

典型输入：

给当前计划补一个 patch，修复流式读取时空行被跳过的问题

执行重点：

• 读取主计划和历史补丁，避免重复修
• 生成新的 patch-{N}.md
• 同步更新主计划里的 ## 历史补丁 与 ## 影响范围

rush

用于快速处理一个边界很清楚的任务。

适合：

• 小范围文档修订
• 单一测试修复
• 明确脚本修改

典型输入：

rush 一下，把 README 里的 action 解释补完整

执行重点：

• 仍然要创建计划
• 但创建后直接实施，不单独等待确认
• 不适合需求范围模糊的大任务

done

用于归档真正完成的当前计划。

适合：

• 当前计划已经实施完毕
• 相关补丁也已经补完
• 需要把上下文推进到下一个计划

典型输入：

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

执行重点：

• 最终调用 agent-context done
• 归档到 .agent-context/done/
• 如果有 preparing 队列，自动晋升下一个计划