Four Modes

四种工作模式 (A/B/C/D)

ai-coding-ok 有四种工作模式，覆盖完整生命周期：安装、规划、执行、升级。每种模式有明确的触发条件和执行流程。

---

模式总览

graph TD
    Start([用户发起任务]) --> Check{项目有<br/>.github/agent/memory/?}
    Check -->|否| ModeA[Mode A: 安装]
    Check -->|是| Intent{用户要做什么？}
    Intent -->|"install ai-coding-ok"| ModeA
    Intent -->|"upgrade ai-coding-ok"| ModeD[Mode D: 升级]
    Intent -->|任意编码任务| ModeB[Mode B: 规划]
    ModeB --> ModeC[Mode C: 记录]
    ModeD --> Done([完成])
    ModeA --> Done
    ModeC --> Done

Loading

---

Mode A：安装

触发条件： 项目没有 .github/agent/memory/，或用户明确说"install ai-coding-ok"/"安装 ai-coding-ok"。

用途： 一次性设置——复制模板、定制占位符、初始化记忆。

执行流程（8 步）：

步骤	操作
1	检测用户语言（中文/英文）
2	定位模板目录（templates/zh/ 或 templates/en/）
3	冲突检查——如果 AGENTS.md、CLAUDE.md 或 .github/agent/ 已存在则警告
4	复制模板到项目中
5	提问："你想做一个什么东西？"（一句话）
5.5	提问："你的源码目录是什么？"（用于 hooks）
5.6	配置 Claude Code hooks（如果 .claude/ 存在）
6	推断技术栈，替换所有 {{占位符}}
7	初始化 TASK-001（安装记录）
8	报告：已安装文件清单 + 关键决策

产出： 项目中有完整定制的 ai-coding-ok 安装。PDCA 循环立即生效。

---

Mode B：规划

触发条件： 项目有 .github/agent/memory/，且用户请求任何开发工作（功能、修复、重构、设计等）。

用途： 在编码前加载项目上下文。

执行流程：

1. 读取 AGENTS.md — 架构速查
2. 读取 .github/agent/system-prompt.md — Agent 角色和行为
3. 读取 .github/agent/workflows.md — 场景工作流
4. 读取 .github/agent/coding-standards.md — 编码规范
5. 读取 .github/agent/memory/project-memory.md — 项目事实
6. 读取 .github/agent/memory/decisions-log.md — 历史决策
7. 读取 .github/agent/memory/task-history.md — 近期任务上下文

耗时： 约 30 秒。

重要： Mode B 是上下文加载，不是用户任务的替代。读取后，AI 继续执行实际任务。

⚠️ 如果同时触发了其他技能（如 superpowers 的 writing-plans），先执行 Mode B，再进入该技能。

---

Mode C：记录

触发条件： 编码/设计任务刚刚完成。

用途： 写回记忆——关闭 PDCA 循环。

执行流程：

优先级	操作	条件
1	更新 task-history.md	始终——每个任务
2	更新 decisions-log.md	架构/技术决策有变化
3	更新 project-memory.md	项目事实有变化
4	更新 agent 文档	AGENTS.md 等内容过时

输出格式： 每次响应必须包含 ## 记忆更新 章节：

## 记忆更新

- ✅ task-history.md — TASK-XXX：[摘要]
- ✅ decisions-log.md — ADR-XXX：[新决策]（如适用）
- ⬜ project-memory.md — 无变化

⛔ v3.0.1+：记忆更新章节是强制性的。缺少它视为不合规。

可以跳过 Act 的合法情况：

• 纯对话/信息问题（无代码变更）
• 用户明确说"这次不用更新记忆"
• 任务在做出任何变更前被取消

---

Mode D：升级

触发条件： 用户说"upgrade ai-coding-ok"/"升级 ai-coding-ok"。

用途： 将框架文件更新到最新版本，同时保留项目定制。

执行流程（8 步）：

步骤	操作
1	从文件标记中检测当前版本
2	读取最新模板
3	差异对比（新增/删除/修改章节）
4	向用户展示变更清单，请求确认
5	应用变更（合并，保留项目定制）
6	更新所有文件中的版本标记
7	在 task-history.md 中记录升级
8	报告：旧版本→新版本、变更文件、定制内容保留

安全机制： 绝不自动应用。始终请求确认。绝不覆盖项目特定内容（项目名、技术栈、架构图）。

---

模式切换表

从	到	时机
（无）	Mode A	不存在 .github/agent/memory/
（无）	Mode B	存在 .github/agent/memory/ + 任意编码任务
Mode B	Mode C	任务完成
（任意）	Mode D	用户说"升级"

---

各模式触发词

Mode A 触发词

• install ai-coding-ok
• 初始化 ai-coding-ok
• set up project memory
• 给项目装上三层记忆系统

Mode B 触发词

• 有 .github/agent/memory/ 的项目中的任意编码任务
• feat:、fix:、refactor:、新功能、修复、重构

Mode C 触发词

• 任务完成（自动——无需用户触发）

Mode D 触发词

• upgrade ai-coding-ok
• update ai-coding-ok
• 升级 ai-coding-ok
• 更新 ai-coding-ok

---

下一步

• PDCA 工作流 — Mode B 和 Mode C 如何构成 PDCA
• 五层防御体系 — 模式如何被强制执行
• 升级 ai-coding-ok — Mode D 详细操作