Skip to main content
plugin CX Codex

agent-workflow-system — Claude Code and Codex plugin: how it works

agent-workflow-system — a plugin with seven skills that turn vague ideas into step-by-step plans, guide projects from start to handoff, and restore context after closing the window.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install agent-workflow-system@awesome-codex-plugins
Open on GitHub

What agent-workflow-system does

The plugin includes seven skills: workflow-system routes tasks to others, newbie-guide asks clarifying questions and shapes a plan, project-master breaks work into stages and sets acceptance criteria, debug-fixer repairs errors using TDD, learning-coach teaches programming and languages through explain-practice-review cycles, drift-auditor catches mismatches between goals and implementation, and phase-closeout closes stages and records outcomes. The plugin writes task checkpoints and decision logs to RESUME.md, reads them when a new window opens, and offers four options: continue, defer, abandon, or start a new project.

Hooks session-end.ps1 and session-end.sh commit RESUME.md changes and push them to the repository on window close; session-start.sh pulls updates once daily on startup. The file BEHAVIOR_SPEC.md prevents executor skills from making architectural decisions and the planner skill from writing code. The plugin operates in Russian and English.

What it helps with

  • break a fuzzy idea into a list of concrete steps
  • pick up an interrupted task a week later and resume from where it stopped
  • spot when implementation has drifted away from the original goal
  • learn something through practice with error checking and explanations
  • sync checkpoints between windows automatically via GitHub

Example prompts for the agent

  • I want to build a portfolio site but don't know where to start
  • Tests are failing after the last commit, fix them
  • Show me how closures work in JavaScript, give me a task, and review my solution

How to install agent-workflow-system

Plugin marketplace

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

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about agent-workflow-system

How do I install agent-workflow-system in Claude Code?

Run /plugin marketplace add hashgraph-online/awesome-codex-plugins, then /plugin install agent-workflow-system@awesome-codex-plugins.

What does agent-workflow-system do?

The plugin turns vague tasks into plans, splits them into stages, fixes errors, teaches through practice, and restores context after closing a window by reading and writing RESUME.md.

How does context restoration work after a break?

On window close, a hook writes the current task and decisions to RESUME.md, commits, and pushes the file. On opening a new window, the plugin reads RESUME.md and offers to continue, defer, abandon the task, or start fresh. Git sync happens automatically.

Source text

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

Similar plugins

All plugins for Agent setup: memory, context, orchestration →

From the same set391

The whole set →
agentpack agentpack gives your agent a task-shaped map of the repo — likely files, rules, skills and warnings — before it touches the code. CX Codex ★ 1,596repo stars agentops agentops is a plugin for Claude Code and Codex that provides engineering practices and skills for coding agents to plan tasks via BDD, test code, and preserve context across sessions. CX Codex ★ 1,596repo stars codiris-agentizer The codiris-agentizer plugin turns a website into a Next.js agent interface with chat, voice calls, and interactive products. Use it to generate and deploy the project. CX Codex ★ 1,596repo stars agentic-readiness-assessment The agentic-readiness-assessment plugin for Claude Code and Codex checks whether an agent can work independently in a repository, then returns a 14-area scorecard and prioritized fixes. CX Codex ★ 1,596repo stars agent-retro agent-retro is a plugin for Claude Code and Codex that reviews weekly activity in 12 animated slides with stats and four prompt-coaching tips to inspect your own habits. CX Codex ★ 1,596repo stars agent-harness-skills agent-harness-skills — a plugin for Claude Code and Codex that builds the repository control layer agents need: entry points, boundaries, validation, runtime traces, and delivery records. CX Codex ★ 1,596repo stars agent-guard The agent-guard plugin for Claude Code and Codex intercepts tool inputs and outputs to block secrets. It runs locally by default without telemetry. CX Codex ★ 1,596repo stars agent-deck agent-deck binds MCP services, credentials, and playbooks to a workspace session. Use it when the same working process must carry across Claude Code and Codex. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open