К основному содержанию
плагин CX Codex

agent-workflow-system — плагин для Claude Code и Codex: что делает

Плагин agent-workflow-system с семью скиллами, которые превращают размытую задачу в пошаговый план, ведут проект от старта до сдачи и восстанавливают контекст после закрытия окна.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install agent-workflow-system@awesome-codex-plugins
Открыть на GitHub

Что делает agent-workflow-system

Плагин состоит из семи скиллов: workflow-system раздаёт задачи остальным, newbie-guide задаёт уточняющие вопросы и формулирует план, project-master делит работу на этапы и ставит критерии приёмки, debug-fixer чинит ошибки по TDD, learning-coach учит программированию и языкам через цикл объяснение-практика-разбор, drift-auditor ловит расхождения между целью и реализацией, phase-closeout закрывает этап и фиксирует результат. Плагин пишет в RESUME.md чекпойнт задачи и список решений, читает его при открытии нового окна и предлагает четыре варианта: продолжить, отложить, бросить или начать новый проект.

Хуки session-end.ps1 и session-end.sh при закрытии окна коммитят изменения RESUME.md и пушат их в репозиторий, session-start.sh при старте тянет обновления раз в сутки. Файл BEHAVIOR_SPEC.md запрещает скиллам-исполнителям принимать архитектурные решения, а скиллу-планировщику — писать код. Плагин работает на русском и английском языках.

Какие задачи решает

  • разбить неясную идею на список конкретных шагов
  • вернуться к прерванной задаче через неделю и продолжить с места обрыва
  • заметить, что реализация ушла в сторону от изначальной цели
  • научиться чему-то через практику с проверкой и объяснением ошибок
  • автоматически синхронизировать чекпойнты между окнами через GitHub

Примеры запросов агенту

  • Я хочу сделать сайт-портфолио, но не знаю с чего начать
  • Тесты падают после последнего коммита, почини
  • Покажи, как работают замыкания в JavaScript, дай задачу и разбери моё решение

Как установить agent-workflow-system

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install agent-workflow-system@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы об agent-workflow-system

Как установить agent-workflow-system в Claude Code?

Выполни /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем /plugin install agent-workflow-system@awesome-codex-plugins.

Что делает agent-workflow-system?

Плагин превращает размытую задачу в план, делит его на этапы, исправляет ошибки, учит через практику и восстанавливает контекст после закрытия окна через файл RESUME.md.

Как работает восстановление контекста после перерыва?

При закрытии окна хук записывает в RESUME.md текущую задачу и решения, коммитит и пушит файл. При открытии нового окна плагин читает RESUME.md и предлагает продолжить, отложить, бросить задачу или начать новую. Синхронизация через Git происходит автоматически.

Исходный текст

agent-workflow-system · MIT
# Agent Workflow System(智能工作流系统)

一套中文 AI 工作流系统,覆盖 Claude Code 和 Codex 双平台。通过 **7 个协作技能** + **行为规范宪法** + **会话恢复机制**,将模糊目标转化为可执行任务,在项目全生命周期中提供支持。

---

## ✨ 核心特性

### 🔄 会话恢复机制(v1.5.0 新增,v1.6.0 增强)

**窗口关了,任务还在。新窗口 AI 像同一个人。**

- **CLAUDE.md** — 每次新会话启动时自动检测未完成任务 + 单线程原则
- **RESUME.md** + **context_snapshot** — checkpoint + 用户偏好/决策记录/防犯错指南,新窗口 AI 不再"失忆"
- **四选项恢复 UI** — 继续 / 暂缓 / 放弃 / 新项目,精准区分场景
- **⏱️ 时间间隔感知** — 根据距离上次会话的时间(小时/天/周)自动调整恢复策略,间隔越长越先确认再动手
- **SessionEnd Hook** — 关窗口时自动写入恢复点 + 自动 commit/push 系统更新
- **SessionStart Hook** — 每次启动自动 `git pull` 拉取最新版本(24h 节流)
- **跨平台支持** — PowerShell + Bash 双实现

### 🔁 全自动更新链路

**开发者改完关窗口 → 自动推送 GitHub → 用户开窗口自动拉取。零人工干预。**

```
你改系统 → 关窗口 → hook 自动 commit + push
                              ↓
                         GitHub 更新
                              ↓
              用户开窗口 → hook 自动 pull(24h 一次)
```

### 🧠 7 个协作技能

| 技能 | 角色 | 触发场景 |
|------|------|----------|
| `workflow-system` | 总调度 | 入口分类,自动路由到合适的子技能 |
| `newbie-guide` | 引导者 | 模糊目标 → 可执行任务(苏格拉底式追问) |
| `project-master` | 策划者 | 任务拆分、决策闸门、验收标准定义 |
| `debug-fixer` | 执行者 | 报错/测试失败/功能异常(TDD 最小修复) |
| `learning-coach` | 执行者 | 学习编程/英语/设计/AI(讲-练-批改-复习) |
| `drift-auditor` | 审计者 | 项目跑偏/上下文漂移/任务分叉检测 |
| `phase-closeout` | 收尾者 | 阶段结束、冻结状态、生成新对话口令 |

### 📜 行为规范宪法(BEHAVIOR_SPEC.md)

14 章统一行为规范,约束所有技能:

- **职能隔离** — 策划者不写代码,执行者不做架构决策
- **五级纠错** — 从自查到强制人工介入的逐级升级
- **法律觉察** — 三层法律风险提示,不越界判断
- **Artifact 交接层** — 50k 上下文 → 5k Artifact,轻量技能间传递
- **会话恢复** — 跨会话任务连续性(第 14 章)

**CLAUDE.md 硬约束(v1.6.2 新增):**
- **实操验证优先** — 验证必须直接执行命令/接口,禁止纯搜索文档推测
- **回复语气规范** — 禁止简短否定甩结论、反问句、居高临下语气

---

## 🚀 快速开始

### Claude Code

**方式一(推荐):对话安装**

在聊天里说:
```
帮我安装 agent-workflow-system
```
Claude 会读取仓库并自动配置所有文件。

**方式二:手动安装**

```bash
git clone https://github.com/1139030773-cmd/agent-workflow-system.git
cp -r agent-workflow-system/.claude ./  && cp agent-workflow-system/CLAUDE.md . && cp agent-workflow-system/RESUME.md .
```

### Codex

**加入市场源(一次):**

在终端执行:
```bash
codex plugin marketplace add https://github.com/hashgraph-online/awesome-codex-plugins.git
```
然后在 Codex 聊天里输入 `/plugins`,在列表中找到 **Agent Workflow System** 安装。

> 💡 插件已提交 [awesome-codex-plugins](https://github.com/hashgraph-online/awesome-codex-plugins) 市场([PR #184](https://github.com/hashgraph-online/awesome-codex-plugins/pull/184) 审核中)。合并后即可通过上述方式安装。

Codex 会自动识别仓库、安装插件。

---

## 🏗️ 项目结构

```
.
├── CLAUDE.md                  # 会话启动自检 + 恢复检查
├── RESUME.md                  # 任务恢复点(自动 checkpoint)
├── README.md                  # 本文件
├── RELEASE_CHECKLIST.md       # 发布检查清单
├── PROJECT.md                 # 项目目标与范围
├── TASK_QUEUE.md              # 任务队列
├── DECISIONS.md               # 架构决策记录
├── STATE_SNAPSHOT.md          # 状态快照
├── .claude/
│   ├── skills/                # 7 个技能 + references
│   ├── hooks/                 # SessionEnd/SessionStart 脚本
│   └── settings.local.json    # Hook 配置
├── memory/                    # 持久化任务追踪
├── skills/agent-*/            # Codex 版技能
└── plugins/                   # 插件包
```

---

## 🔧 配置

### 启用会话恢复(推荐)

将以下文件复制到你的项目中:
- `CLAUDE.md` — AI 在每个新会话中自动读取
- `RESUME.md` — AI 在工作过程中自动更新
- `.claude/hooks/session-end.ps1` — Windows 关窗口自动保存
- `.claude/hooks/session-end.sh` — Linux/Mac 关窗口自动保存

### 启用自动更新(推荐)

```json
// .claude/settings.local.json
{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "bash .claude/hooks/session-start.sh",
            "timeout": 10
          }
        ]
      }
    ]
  }
}
```

---

## 📋 使用流程

```
开窗口 → AI 自动检测 RESUME.md
    │
    ├── 有未完成任务 → ⚠️ 四选项 UI
    │    A. 继续 → 从上次中断处接着做
    │    B. 暂缓 → 保留进度,先做别的
    │    C. 放弃 → 删除恢复点
    │    D. 新项目 → 归档旧任务
    │
    └── 无活跃任务 → 正常开始
         │
         说 "我想做..." → workflow-system 自动分类
         → 引导 → 策划 → 执行 → 审计 → 收尾
              │
              └── 每步自动更新 RESUME.md
```

---

## 📖 版本历史

| 版本 | 日期 | 主要变更 |
|------|------|----------|
| **1.7.1** | 2026-06-07 | 💬 会话收尾提示:关窗前自动提醒收尾 |
| **1.7.0** | 2026-06-07 | 📁 CLAUDE.md 拆分(开发/用户规则分离)+ 🔒 任务收尾铁律 |
| **1.6.2** | 2026-06-05 | 🔍 实操验证优先 + 🗣️ 回复语气规范 |
| **1.6.1** | 2026-06-05 | ⏱️ 时间间隔感知 + 📋 系统改动铁律 + 🔁 全自动更新链路 |
| **1.6.0** | 2026-06-05 | 🧠 context_snapshot 记忆快照 + 单线程原则 |
| **1.5.0** | 2026-06-05 | 🔄 会话恢复机制、跨平台 hooks、README |
| 1.4.1 | 2026-06-04 | 发布管线 + 社区市场同步 |
| 1.4.0 | 2026-06-03 | Artifact 交接层 + 交互预算 |

详见 [CHANGELOG.md](https://github.com/1139030773-cmd/agent-workflow-system/blob/main/CHANGELOG.md)

---

## 🤝 贡献

欢迎提交 Issue 和 PR。详见 [CONTRIBUTING.md](https://github.com/1139030773-cmd/agent-workflow-system/blob/main/CONTRIBUTING.md)

## 📄 许可

MIT License

## 🔗 链接

- GitHub: [1139030773-cmd/agent-workflow-system](https://github.com/1139030773-cmd/agent-workflow-system)
- Codex 市场: `/plugins add 1139030773-cmd/agent-workflow-system`
- 社区市场: [awesome-codex-plugins](https://github.com/hashgraph-online/awesome-codex-plugins)

© Codex 工作流系统 · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
groove-groovebook-publish andreadellacorte Скилл groove-groovebook-publish для Claude Code публикует рабочий инсайт в groovebook через pull request. Запускается после groove-work-compound, если наработкой стоит поделиться. CX Codex +1 507установок instinct-system codewithmukesh Скилл instinct-system для Claude Code фиксирует паттерны, правки пользователя и находки в файлах проекта. Он помогает агенту учиться на повторяющихся решениях. CX Codex +1 4 000установок mentoring-juniors официальный github Скилл mentoring-juniors для GitHub Copilot превращает его в наставника: он ведёт джуна вопросами и не выдаёт готовых решений. Помогает при обучении и разборе чужого кода. CX Codex +1 6 900установок search Rohit Ghumare Команда search ищет сохранённые правила и выводы в базе знаний pro-workflow через BM25. Помогает быстро вспомнить решения прошлых ошибок при написании кода. CX Codex +1 ★ 2 966звёзд репо 10-learn AI-Driven Dev Скилл 10-learn для Claude Code, Cursor и других платформ, который помогает записывать и формализовать решения, соглашения, уроки и находки из кода. CX Codex +1 ★ 571звёзд репо code-documentation-code-explain sickn33 Скилл code-documentation-code-explain на Claude Code превращает запутанный код в понятные объяснения с диаграммами и пошаговыми разборами. Разбирает алгоритмы, архитектуру и паттерны, объясняя структуру и поток выполнения. CX Codex +1 1 000установок

Из того же набора391

Весь набор →
agentpack Плагин agentpack собирает для агента карту репозитория под конкретную задачу: вероятные файлы, правила, скиллы и предупреждения — до того, как он начнёт править код. CX Codex ★ 1 596звёзд репо agentops Плагин agentops для Claude Code и Codex объединяет инженерные практики и скиллы для кодинг-агентов: помогает планировать задачи через BDD, проверять код тестами и сохранять контекст между сессиями. CX Codex ★ 1 596звёзд репо codiris-agentizer Плагин codiris-agentizer для Claude Code и Codex превращает сайт в агентный интерфейс с чатом, голосовыми звонками и интерактивными товарами. Создаёт и развёртывает Next.js-проект. CX Codex ★ 1 596звёзд репо agentic-readiness-assessment Плагин agentic-readiness-assessment для Claude Code и Codex оценивает готовность репозитория к самостоятельной работе агента: по 14 критериям выдаёт scorecard и приоритетные исправления. CX Codex ★ 1 596звёзд репо agent-retro Плагин agent-retro для Claude Code и Codex собирает недельное ретро из 12 слайдов со статистикой и четырьмя подсказками по промптам для разбора собственных привычек. CX Codex ★ 1 596звёзд репо agent-harness-skills Плагин agent-harness-skills для Claude Code и Codex проектирует слой управления репозиторием, который нужен кодовым агентам: точки входа, границы, валидация, трассировка во время работы и записи о доставке кода. CX Codex ★ 1 596звёзд репо agent-guard Плагин agent-guard перехватывает вызовы инструментов, блокирует утечки ключей и маскирует токены в сессиях Claude Code и Codex. Работает локально без отправки телеметрии. CX Codex ★ 1 596звёзд репо agent-deck agent-deck связывает MCP-сервисы, ключи и рабочие сценарии с выбранным проектом. Он пригодится, когда один процесс нужно повторять в Claude Code и Codex. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой