By TreeX-X
Automate multi-agent code development with requirement discovery, structured planning, implementation, and quality evaluation. Execute workflows that generate code, audit for simplicity and elegance, produce prototypes, and optimize prompts for AI tools, all coordinated through an orchestrator.
Execute Mode B workflow (local module, PRD detection)
Optimize prompt without triggering workflow
Invoke the orchestratorX agent in status mode to scan the project, collect workflow state, and generate an HTML status report.
Execute Mode C workflow (unit task, minimal change)
Execute Mode A workflow (whole codebase, full planning phase)
Lean code & engineering analysis agent. Owns structured Markdown code summarization and must apply abstracter-code-summary skill for detailed analysis workflow.
Code implementation teammate. Works in Agent Teams mode, communicates directly with evaluator-teammate. Claims coding tasks, implements code, marks completion.
Lean coding agent. Owns implementation of features, bug fixes, refactors, and tests. Must apply karpathy-guidelines skill as the behavioral baseline for all coding work. Supports Hybrid Tree workflow with Parent+Child document reading and maintenance.
Code evaluation teammate. Works in Agent Teams mode, communicates directly with coder-teammate. Reviews code, generates evaluation reports, discusses fix plans.
Lean code audit and evaluation agent. Reads Parent+Child hybrid docs for ground truth, inspects git diffs and project code, then produces structured evaluation reports in Hybrid Tree workflows.
Code & engineering analysis skill for abstracter agents. Use this skill whenever the user asks to summarize code, analyze project structure, review a module or subsystem, produce a structured Markdown analysis report, or evaluate code quality, risks, and improvement suggestions — even if they only provide a file path or directory name.
Intelligent request classification and routing. Status gate, 4 routes (active workflow, direct handling, workflow selection, explicit command), 5-dimension analysis, mode recommendation, status management. Used by main Claude agent before dispatching orchestratorX.
Spec-driven coding workflow for coderX agents. Use this skill whenever implementing, fixing, refactoring, or iterating code from hybrid docs or specified requirements, especially when file index, knowledge index, or evaluator findings are present.
Structured code audit workflow supporting both PRD-based and prompt-based evaluation modes. evaluatorX is a pure analyzer — reads docs + code, outputs structured Evaluation Result Payload. Document writes are handled by orchestratorX, not evaluatorX.
Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid overcomplication, make surgical changes, surface assumptions, and define verifiable success criteria.
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
WorkflowX 是一套装进你 AI 编程工具里的工作流框架。 它把单个 AI"边聊边写"的随意模式,变成一条有角色分工的流水线:一个编排者负责规划、派活、记录,一个程序员智能体负责写代码,一个评估员智能体负责独立验收——不达标就打回重做,达标才收工。
你不需要安装任何服务或运行时。把配置文件拷进项目,它就能在 Claude Code / OpenAI Codex / OpenCode 里直接运行。
一次完整的 xwhole 工作流:需求收束 → Hybrid Tree → 指令优化 → 编码 → 独立验收 → 修复回流 → PASS 收口
直接和单个 AI 聊天写代码,你大概率遇到过这些坑。WorkflowX 针对每一个都给了机制化的答案:
| 用 AI 写代码的痛点 | WorkflowX 的解法 |
|---|---|
| 长对话后上下文失控,信息越堆越乱、成本越来越高 | 每个智能体在独立上下文中工作,只通过结构化 Payload 通信 |
| AI 声称完成,但实际没做或做错 | 评估员独立验收,不采信程序员的自我声明,逐条核对验收标准后才放行 |
| 需求散落在聊天记录里,变更难追踪 | 需求沉淀为结构化 Hybrid Tree,支持追踪、增量修改和影响联动 |
| 编码后才发现需求理解偏差 | 规划阶段通过苏格拉底式追问和主动质疑提前暴露假设、边界与风险 |
| 多轮迭代 Token 消耗过快 | 三层 Token 优化让多轮场景节省 40–60% |
| 并行任务互相覆盖、产生分支冲突 | 每个智能体在独立 git worktree 中工作,配合跨分支违规检测 |
整套框架只有一个核心循环。你只跟一个角色对话,剩下的它替你协调:
你 ──提需求──▶ orchestratorX(编排者,唯一文档写入者)
│
① 把需求写成 Hybrid Tree(结构化需求文档)
│
② ┌───────────────────────────────┐
▼ │ 不达标,带修复指令重来
coderX 编码 ──Change Summary──▶ evaluatorX 独立验收
│
③ 达标 ──────────────────────────┘ → 收口为最终版本
Parent(总纲/路由)+ 多个 Child(子任务,含各自验收标准)。这是整个流程的事实来源,需求变更只改这里。一句话:编排者规划,程序员实现,评估员把关,文档树记账。 每一轮"编码→验收"不通过就自动再来(默认最多 2 轮),通过就收口。
编排层 + 数据层:orchestratorX 调度子智能体,通过 Hybrid Tree + MCP 记忆图谱实现结构化协作
环境要求:Node.js v18+
① 安装 MCP 依赖(用于跨会话记忆)
npm install -g @modelcontextprotocol/server-memory @modelcontextprotocol/server-sequential-thinking
② 安装 WorkflowX
| 平台 | 安装方式 |
|---|---|
| Claude Code | /plugin marketplace add https://github.com/TreeX-X/workflowX → /plugin install workflowx |
| OpenAI Codex | /plugins → 搜索 workflowx → Install Plugin |
| OpenCode | 在 opencode.json 添加 "plugin": ["workflowx@git+https://github.com/TreeX-X/workflowX.git"] |
| 手动部署 | 把 .claude/(或 .codex/ .opencode/)目录拷进项目根目录,再按 mcp.json.template 挂载 MCP 配置 |
③ 跑第一条指令
xwhole 实现用户登录功能,支持邮箱+密码和 OAuth 两种方式
接下来编排者会反问你几个关键问题、给出方案,你确认后它就自动进入"编码 → 验收 → 迭代"循环。完整示例见下方一次完整的工作流。
按"改动范围"从大到小选。不确定就直接说需求——框架会自动分析并推荐合适的模式让你确认。
| 模式 | 一句话场景 | 规划 | 验收迭代 | 触发示例 |
|---|---|---|---|---|
xwhole 全局 | 新功能、跨模块重构 | 多轮对话 → 生成 Hybrid Tree | 自动,最多 N 轮 | xwhole 实现订单中心 |
xwhole -parallel 并行 | 多个互相独立的子任务同时做 (仅 Claude Code) | 同 xwhole,自动拆分并行 | 多评估员并行 | /xwhole -parallel 实现用户、订单、商品三个模块 |
xlocal 局部 | 1–2 个模块内的修改/修 bug | 跳过(自动检测/生成 PRD) | 自动,最多 N 轮 | xlocal 修复订单列表分页 bug |
xunit 单元 | 单文件、小改动 | 跳过 | 默认不评估 | xunit 给 Config 加超时配置 |
常用参数:-N 3 限定最多迭代 3 轮(默认 2)| -box demo 在沙箱分支隔离执行(仅 xwhole)
其他指令:
| 指令 | 作用 |
|---|---|
xstatus | 一键生成高保真 HTML 工作流状态报告 |
xprompt [文本] | 只优化提示词,不触发开发流程 |
触发语法差异:Claude Code 与 OpenCode 用斜杠命令(
/xwhole);OpenAI Codex 用自然语言前缀(消息开头直接写xwhole,无斜杠)。-parallel并行模式仅 Claude Code 支持。
以 xwhole 实现用户登录功能 为例,你会经历这 6 步:
① 你发起需求
xwhole 实现用户登录功能,支持邮箱+密码和 OAuth 两种方式
npx claudepluginhub treex-x/workflowx --plugin workflowx75 specialized AI agents across Engineering, Product, Infrastructure, Data, Security, Marketing, Sales, Finance, Legal, and People. Automatic routing to the right specialist.
OpenAgentsControl — multi-agent orchestration for Claude Code. Context-aware development with skills, subagents, parallel execution, and automated code review.
Multi-agent team orchestration for parallel task execution, research, and implementation
Production-ready Claude Code configuration with role-based workflows (PM→Lead→Designer→Dev→QA), safety hooks, 44 commands, 19 skills, 8 agents, 43 rules, 30 hook scripts across 19 events, auto-learning pipeline, hook profiles, and multi-language coding standards
Conductor v3 — Multi-agent orchestration with Evaluate-Loop, parallel execution, Board of Directors, and bundled SupaConductor skills for Claude Code
Plan-Execute-Review development workflow with brainstorming, executor agent, and adversarial code review loop