Agent Context

@cat-kit/agent-context 用来把 ac-workflow 安装到不同 AI 工具中，让它们围绕同一份 .agent-context/ 计划目录协作。适用环境：Node.js。

它由两部分组成：

• CLI：安装 Skill、同步协议、校验目录结构、管理计划生命周期（归档、索引）、升级自身
• Skill：在对话中识别 init、plan、replan、implement、patch、rush、review、done 协议意图（与 renderSkillArtifacts 生成的 SKILL.md 一致），按协议推进任务

目录结构：

.agent-context/
├── .env               # SCOPE 配置（SCOPE=<name>）
├── .gitignore
└── {scope}/           # 作用域目录（按协作者隔离）
    ├── index.md       # 计划索引（自动生成）
    ├── plan-{N}/      # 当前计划（最多一个）
    │   ├── plan.md
    │   └── patch-{N}.md
    ├── preparing/     # 待执行计划队列
    │   └── plan-{N}/
    └── done/          # 已归档计划
        └── plan-{N}-{YYYYMMDD}/

动作依赖图（主路径与 review）

与 packages/agent-context/src/skill/protocols/*.ts 一致：rush 在单条流程里先按 plan 的差异规则写好 plan.md，再完整执行 implement（无裁剪），因此落地后与普通 plan → implement 相同，可继续 patch、review、done，而不是跳过实施直接归档。

图表加载中...

说明：plan / implement / rush 在协议末尾均可按 Skill 约定询问用户是否立刻 review。review 不接受额外描述；审查后常见后续为 replan（仍 未执行）或 patch（已 已执行）。

状态机与路由

校验与状态由 CLI validate / status 与 plan.md 状态行驱动；两态为 未执行、已执行。下图表示「目录里有没有当前计划、计划处于哪一态」之间的转移；review 不改变状态行，故不单独画状态迁移。

图表加载中...

各状态下 Skill 路由（与安装后的 SKILL.md 相同）：

状态	可选动作
A	init、plan、rush
B	implement、replan、review；无关新需求 → 询问归档或终止
C	patch、review、done（CLI）；无关新需求 → 询问归档或终止

页面导航

• Protocol 说明 — 每个协议的适用时机、前置条件和产物
• AI 协作场景 — 按任务类型选择正确动作的具体流程
• CLI 命令 — 安装、同步、校验、状态、归档、索引

常见问题

Codex 中交互式引导不起作用

你需要在 codex 配置中（用户目录：～/.codex/config.toml 或 项目根目录：.codex/config.toml）启用以下功能标识：

[features]
default_mode_request_user_input = true