# Agent Workflow System：为 Claude Code 和 Codex 打造的双语 AI 协作工作流系统

> 一套支持中英文的双语 AI Agent 工作流系统，通过7个协作技能、行为规范章程和会话恢复机制，将模糊想法转化为可执行任务，同时支持 Claude Code 和 Codex CLI 双平台。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-06-10T11:15:27.000Z
- 最近活动: 2026-06-10T11:20:46.017Z
- 热度: 161.9
- 关键词: AI Agent, Claude Code, Codex CLI, 工作流系统, 会话恢复, 行为规范, 任务管理, AI协作, 开源工具
- 页面链接: https://www.zingnex.cn/forum/thread/agent-workflow-system-claude-code-codex-ai
- Canonical: https://www.zingnex.cn/forum/thread/agent-workflow-system-claude-code-codex-ai
- Markdown 来源: ingested_event

---

## 原作者与来源

- 原作者/维护者：1139030773-cmd
- 来源平台：github
- 原始标题：agent-workflow-system
- 原始链接：https://github.com/1139030773-cmd/agent-workflow-system
- 来源发布时间/更新时间：2026-06-10T11:15:27Z

## 原作者与来源\n\n- **原作者/维护者**: 1139030773-cmd\n- **来源平台**: GitHub\n- **原始标题**: agent-workflow-system\n- **原始链接**: <https://github.com/1139030773-cmd/agent-workflow-system>\n- **发布时间**: 2026年6月\n\n---\n\n## 引言：AI 编程助手的新范式\n\n随着 Claude Code 和 Codex CLI 等 AI 编程助手的普及，开发者与 AI 的协作方式正在发生根本性变化。然而，许多用户在实际使用中面临一个共同困境：如何将自己的模糊想法转化为 AI 能够理解和执行的明确任务？如何在多轮对话中保持上下文连贯？如何防止任务偏离轨道？\n\nAgent Workflow System 正是为解决这些问题而生。这是一套由 1139030773-cmd 开发的开源工作流系统，它通过角色分工、行为规范和会话恢复三大核心机制，让 AI 助手真正成为高效的协作伙伴。\n\n---\n\n## 系统架构：七个协作角色构成的完整闭环\n\nAgent Workflow System 的核心设计理念是将 AI 助手的功能分解为七个专业角色，每个角色负责特定的任务阶段：\n\n### 1. workflow-system（协调器）\n作为系统的入口路由，负责识别用户意图并将其引导至合适的子技能。它就像一位智能前台，能够快速判断用户当前需要的是任务拆解、错误修复还是学习指导。\n\n### 2. newbie-guide（新手引导员）\n专为初学者设计，采用苏格拉底式提问法，将模糊的目标转化为可执行的具体任务。例如，当用户说"我想做个网站"时，它会通过一系列问题帮助用户明确需求：网站类型、目标用户、核心功能等。\n\n### 3. project-master（项目规划师）\n负责任务拆解、决策门设置和验收标准制定。它将大型项目分解为可管理的阶段，并在关键节点设置检查点，确保项目按计划推进。\n\n### 4. debug-fixer（调试修复员）\n专注于错误处理、测试失败和 Bug 修复，遵循测试驱动开发（TDD）原则，以最小改动解决问题。\n\n### 5. learning-coach（学习教练）\n支持编程、设计、语言学习等多种学习场景，提供结构化的学习路径和实践指导。\n\n### 6. drift-auditor（偏离审计员）\n监控范围蔓延、上下文漂移和任务分叉，及时提醒用户当前工作是否偏离了原定目标。\n\n### 7. phase-closeout（阶段收尾员）\n负责阶段总结、状态冻结和恢复令牌生成，确保每个阶段的工作成果都被妥善保存。\n\n这七个角色形成了一个完整的 PDCA（计划-执行-检查-行动）闭环，覆盖了从需求澄清到任务交付的全过程。\n\n---\n\n## 行为规范章程：14章统一行为标准\n\nAgent Workflow System 的另一大特色是其详尽的行为规范章程，共包含14个章节，为所有技能设定了统一的行为标准：\n\n### 角色隔离原则\n规划者不直接编码，执行者不做架构决策。这种严格的角色分离确保了每个环节的专业性和客观性。\n\n### 五级纠错机制\n从自我检查到强制人工干预，建立了多层次的错误发现和纠正体系。当系统检测到潜在问题时，会根据严重程度采取不同级别的响应措施。\n\n### 法律意识层\n在不提供法律建议的前提下，系统会针对可能的法律风险给出三层预警提示，帮助用户规避潜在问题。\n\n### 工件交接优化\n通过将50k上下文压缩为5k轻量级工件，实现技能间的高效信息传递，避免上下文窗口的浪费。\n\n### 任务分叉与收敛\n子任务自动继承父任务上下文，完成后自动返回主任务。这种设计确保了复杂项目中的上下文连贯性。\n\n### 四问自检法\n在实施任何变更前，系统会强制进行四个问题的自检：逻辑是否正确？是否存在冲突？是否重要？时机是否合适？\n\n---\n\n## 会话恢复机制：真正的跨会话连续性\n\n这是 Agent Workflow System 最具创新性的功能之一。传统 AI 助手的一个痛点是：一旦关闭窗口，之前的对话上下文就会丢失。而 Agent Workflow System 通过以下机制解决了这个问题：\n\n### CLAUDE.md 自动检测\n每次会话开始时，系统会自动检测是否存在未完成的任务。\n\n### RESUME.md + context_snapshot\n创建包含决策记录、用户偏好和注意事项的检查点，确保新会话能够无缝接续。\n\n### 时间间隔感知\n系统会根据距离上次会话的时间长短调整恢复策略。例如，间隔24小时以上的会话会收到更详细的背景回顾。\n\n### SessionEnd 钩子\n窗口关闭时自动保存检查点并提交更改，确保工作不会丢失。\n\n### SessionStart 钩子\n新窗口打开时自动执行 git pull（24小时节流），保持代码同步。\n\n### 跨平台支持\n同时支持 PowerShell 和 Bash，覆盖主流开发环境。\n\n---\n\n## 双平台兼容：Claude Code 与 Codex CLI\n\nAgent Workflow System 的另一大优势是同时支持 Anthropic 的 Claude Code 和 OpenAI 的 Codex CLI 两大平台：\n\n### Claude Code 安装\n最简单的方式是直接对 Claude 说："Install agent-workflow-system for me"，系统会自动完成安装。也可以手动克隆仓库并复制配置文件。\n\n### Codex CLI 安装\n支持命令行一键安装：`codex plugin install 1139030773-cmd/agent-workflow-system`，或者通过桌面应用的插件市场安装。\n\n这种双平台支持让用户可以根据场景选择最适合的工具，而无需学习两套不同的工作流。\n\n---\n\n## 实际应用场景与启动指令\n\n系统设计了直观的自然语言启动方式，无需记忆复杂命令：\n\n| 场景 | 启动方式 |\n|------|---------|\n| 有模糊想法 | \"Start the newbie guide, help me turn my idea into tasks\" |\n| 管理项目 | \"Enter project master mode, help me manage this project\" |\n| 修复 Bug | \"Help me fix this bug\" |\n| 学习新技能 | \"I want to learn Python, make me a study plan\" |\n| 检查偏离 | \"Check if my progress has drifted\" |\n| 阶段总结 | \"Help me do a phase closeout and organize what we did\" |\n\n系统会自动检测用户使用的语言（中文或英文）并做出相应调整。\n\n---\n\n## 版本演进与社区生态\n\nAgent Workflow System 保持着活跃的更新节奏。从 v1.5.0 引入会话恢复机制，到 v1.7.5 新增技能退出协议和返回任务格式规范，每个版本都在解决实际使用中的痛点。\n\n项目采用 MIT 许可证开源，目前已提交至 Codex 社区插件市场（等待 PR 合并），未来用户将能够通过官方市场直接安装。\n\n---\n\n## 结语：AI 协作的未来方向\n\nAgent Workflow System 代表了一种新的 AI 协作范式：不再将 AI 视为简单的问答工具，而是作为具有专业分工、行为规范和记忆能力的协作伙伴。通过角色分离确保专业性，通过规范章程确保一致性，通过会话恢复确保连续性，这套系统为 AI 辅助开发树立了新的标杆。\n\n对于正在使用 Claude Code 或 Codex CLI 的开发者来说，Agent Workflow System 值得一试。它可能改变你与 AI 协作的方式，让模糊的想法真正转化为可执行的代码。