agent-workflow-system — плагин для Claude Code и Codex: что делает
Плагин agent-workflow-system с семью скиллами, которые превращают размытую задачу в пошаговый план, ведут проект от старта до сдачи и восстанавливают контекст после закрытия окна.
MIT ★ 1 596 обновлён 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install agent-workflow-system@awesome-codex-pluginsЧто делает 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