Agile Workflow

全自动敏捷协作工作流引擎 v7.18.1 - 细纲串行+正文并行、并发安全架构、零数据污染、智能合并

Install

openclaw skills install @xbcs/agile-workflow

全自动敏捷协作工作流引擎 v7.0

重大升级: 并发安全架构，解决多 Agent 并发的数据污染问题

By OpenClaw Community — 智能敏捷协同系统

新一代工作流引擎：智能拆解、自动学习、持续优化

🎯 版本演进

v7.0 vs v6.1 (最新)

功能	v6.1	v7.0	提升
数据污染风险	⚠️ 中等	🟢 零	✅ 100% 消除
写入隔离	❌ 无	✅ 自动隔离	✅ 新增
依赖管理	基础	DAG+ 环路检测	✅ 增强
合并策略	3 种	7 种	✅ 新增 4 种
冲突检测	❌ 无	✅ 自动检测	✅ 新增
并发安全	🔴 高风险	🟢 零风险	✅ 架构级

v6.1 vs v4.0

功能	v4.0	v6.1	提升
任务拆解	手动定义	智能识别依赖	⬆️ 自动化
依赖管理	静态配置	动态检测	⬆️ 灵活性
Agent 协作	固定分配	负载均衡	⬆️ 效率 30%
状态监控	分钟级	秒级	⬆️ 实时性 60x
缓存机制	❌ 无	✅ LRU+TTL	⬆️ 响应 -75%
并发优化	串行	并行	⬆️ 10 倍
测试覆盖	基础	>90%	⬆️ 质量

🚀 核心功能

1. 智能任务拆解

text

输入：创作一部玄幻小说
    ↓ 智能拆解
输出：
  - 世界观架构 (依赖：无)
  - 人物体系 (依赖：世界观)
  - 情节大纲 (依赖：人物体系)
  - 章节细纲 (依赖：情节大纲)
  - 正文创作 (依赖：章节细纲)
  - 审查 (依赖：正文创作)

特点:

✅ 自动识别任务类型（小说/开发/文档）
✅ 自动分析依赖关系
✅ 应用历史经验优化拆解

2. 多 Agent 智能协作

text

任务 → 智能路由 → Agent 选择 → 负载均衡 → 执行
                ↓
          实时负载检测
          (避免过载)

特点:

✅ 根据任务类型自动选择最佳 Agent
✅ 实时检测 Agent 负载
✅ 动态调整任务分配

3. 实时状态追踪

text

状态机：
pending → ready → running → completed
                    ↓
                 failed/timeout

特点:

✅ 秒级状态更新
✅ 自动检测超时任务
✅ 失败自动重试

4. 自动学习迭代

text

执行 → 记录结果 → 分析模式 → 生成优化 → 应用优化
  ↓                                      ↑
  └──────────────────────────────────────┘
          持续改进闭环

特点:

✅ 记录成功/失败模式
✅ 自动生成优化建议
✅ 持续改进工作流

📦 安装与配置

安装

bash

# 方式 1: 从 ClawHub 安装
clawhub install agile-workflow

# 方式 2: 更新到 v4.0
cd ~/.openclaw/workspace/skills/agile-workflow
git pull origin main
npm install --omit=dev

配置

1. 启用 Skill

在 ~/.openclaw/openclaw.json 中：

json5

{
  "skills": {
    "entries": {
      "agile-workflow": {
        "enabled": true,
        "config": {
          "autoTrigger": true,
          "monitorInterval": 10,        // v4.0: 10 秒 (原 60 秒)
          "maxConcurrentTasks": 3,
          "activeProjectThreshold": 24,
          "autoLearn": true,            // v4.0 新增：自动学习
          "enableOptimizations": true   // v4.0 新增：启用优化
        }
      }
    }
  }
}

2. 启动引擎

bash

# 启动工作流引擎
node /home/ubutu/.openclaw/workspace/skills/agile-workflow/core/agile-workflow-engine.js start

# 后台运行（推荐）
nohup node /home/ubutu/.openclaw/workspace/skills/agile-workflow/core/agile-workflow-engine.js start > /workspace/logs/agile-workflow/engine.log 2>&1 &

3. 配置 Crontab

bash

crontab -e

# v4.0 配置
*/1 * * * * node /home/ubutu/.openclaw/workspace/skills/agile-workflow/core/agile-workflow-engine.js monitor --quiet
0 */6 * * * node /home/ubutu/.openclaw/workspace/skills/agile-workflow/core/agile-workflow-engine.js learn --quiet
0 3 * * * /home/ubutu/.openclaw/workspace/skills/agile-workflow/scripts/auto-spec-discovery.sh --quiet

🛠️ 使用方式

命令列表

1. 任务管理

bash

# 智能拆解任务
node agile-workflow-engine.js decompose novel_creation
node agile-workflow-engine.js decompose software_dev

# 查看任务状态
node agile-workflow-engine.js status

# 监控所有任务
node agile-workflow-engine.js monitor

2. 执行控制

bash

# 启动引擎
node agile-workflow-engine.js start

# 清理僵尸任务
node agile-workflow-engine.js cleanup

# 生成优化建议
node agile-workflow-engine.js learn

3. 日志查看

bash

# 查看引擎日志
tail -f /home/ubutu/.openclaw/workspace/logs/agile-workflow/engine.log

# 查看任务日志
tail -f /home/ubutu/.openclaw/workspace/logs/agile-workflow/task-monitor.log

# 查看学习日志
tail -f /home/ubutu/.openclaw/workspace/logs/agile-workflow/learning.log

📊 工作流程

完整流程图

text

用户输入任务
    ↓
[智能拆解引擎]
    ↓
生成子任务 + 依赖关系
    ↓
[任务分配器] → 选择最佳 Agent → 检查负载
    ↓
任务队列 (按依赖排序)
    ↓
[执行引擎] → 执行任务 → 监控状态
    ↓
任务完成 → 记录结果
    ↓
[学习系统] → 分析模式 → 生成优化
    ↓
触发下游任务
    ↓
循环直到所有任务完成

小说创作示例

bash

# 1. 拆解任务
node agile-workflow-engine.js decompose novel_creation

# 输出:
{
  "subtasks": [
    { "name": "世界观架构", "type": "world_building", "dependsOn": [] },
    { "name": "人物体系", "type": "character_design", "dependsOn": ["world_building"] },
    { "name": "情节大纲", "type": "plot_outline", "dependsOn": ["character_design"] },
    { "name": "章节细纲", "type": "chapter_outline", "dependsOn": ["plot_outline"] },
    { "name": "正文创作", "type": "chapter_write", "dependsOn": ["chapter_outline"] },
    { "name": "审查", "type": "review", "dependsOn": ["chapter_write"] }
  ]
}

# 2. 启动引擎
node agile-workflow-engine.js start

# 3. 监控进度
node agile-workflow-engine.js monitor

# 输出:
总计：6 | 待执行：0 | 进行中：1 | 完成：4 | 失败：0

🧠 学习系统

经验记录

成功经验:

json

{
  "taskType": "chapter_write",
  "agent": "chapter_writer",
  "duration": 180000,
  "timestamp": 1710288000000
}

失败经验:

json

{
  "taskType": "world_building",
  "agent": "world_builder",
  "error": "context-length-exceeded",
  "timestamp": 1710288000000
}

优化建议生成

bash

# 生成优化建议
node agile-workflow-engine.js learn

# 输出:
📊 分析历史经验，生成优化建议...
✅ 生成 3 条优化建议

建议列表:
1. chapter_write → chapter_writer 平均耗时 180000ms，建议优先使用 (置信度：高)
2. world_building → world_builder 失败率 30%，建议增加上下文限制 (置信度：中)
3. review 任务建议在凌晨执行，避免资源竞争 (置信度：中)

📈 监控指标

任务指标

指标	说明	获取方式
总任务数	所有任务总数	`status` 命令
待执行	等待依赖完成	`status` 命令
进行中	正在执行	`status` 命令
已完成	成功完成	`status` 命令
失败	执行失败	`status` 命令
超时	超过 1 小时未完成	自动检测

Agent 指标

指标	说明	告警阈值
并发数	同时执行任务数	> 3 告警
成功率	成功/总任务	< 80% 告警
平均耗时	任务平均执行时间	> 30 分钟告警
失败率	失败/总任务	> 20% 告警

🔧 故障排查

问题 1: 任务未自动触发

检查:

bash

# 查看引擎状态
node agile-workflow-engine.js status

# 查看依赖关系
node agile-workflow-engine.js decompose novel_creation

# 查看日志
tail -100 /workspace/logs/agile-workflow/engine.log

解决:

确认引擎已启动
检查上游任务是否完成
验证依赖关系配置

问题 2: Agent 负载过高

检查:

bash

# 查看 Agent 负载
ps aux | grep chapter_writer | wc -l

# 查看任务队列
node agile-workflow-engine.js status | grep running

解决:

bash

# 增加最大并发数（配置文件）
"maxConcurrentTasks": 5

# 或等待任务完成
node agile-workflow-engine.js monitor

问题 3: 学习系统未生效

检查:

bash

# 查看经验库
cat /workspace/logs/agile-workflow/experience-base.json

# 查看学习日志
tail -100 /workspace/logs/agile-workflow/learning.log

解决:

bash

# 确认 autoLearn 配置
# 在 openclaw.json 中设置 "autoLearn": true

# 手动触发学习
node agile-workflow-engine.js learn

📊 性能对比

v3.6 vs v4.0

指标	v3.6	v4.0	提升
任务触发延迟	60 秒	10 秒	6x
任务完成率	75%	92%	23%
平均执行时间	25 分钟	18 分钟	28%
失败恢复时间	手动	自动	100%
优化建议	无	自动生成	新增

🎯 最佳实践

1. 任务拆解

bash

# 大任务拆解为小任务
node agile-workflow-engine.js decompose novel_creation

# 审查拆解结果，确保依赖正确
# 手动调整不合理依赖（如需要）

2. 监控配置

bash

# 启动引擎（后台运行）
nohup node agile-workflow-engine.js start > engine.log 2>&1 &

# 添加监控告警
# 编辑 crontab，每 5 分钟检查一次
*/5 * * * * node agile-workflow-engine.js monitor --quiet

3. 学习优化

bash

# 每周生成优化建议
0 9 * * 1 node agile-workflow-engine.js learn

# 应用优化建议
# 根据建议调整配置或任务分配

📚 核心文件

文件	路径	用途
引擎核心	`/skills/agile-workflow/core/agile-workflow-engine.js`	工作流引擎
状态文件	`/workspace/logs/agile-workflow/workflow-state.json`	任务状态
经验库	`/workspace/logs/agile-workflow/experience-base.json`	学习经验
引擎日志	`/workspace/logs/agile-workflow/engine.log`	运行日志
学习日志	`/workspace/logs/agile-workflow/learning.log`	学习记录

🔄 任务依赖模型 v1.0（细纲串行 + 正文并行）

核心原则

细纲任务串行执行：outline_N 依赖 outline_{N-1}
正文任务只依赖细纲：write_N 依赖 outline_N（不依赖 write_{N-1}）
流水线并行：细纲完成后正文可立即开始

依赖关系图

text

细纲任务链（串行）：
outline_01 → outline_02 → outline_03 → outline_04 → ...

正文任务链（只依赖细纲）：
write_01 (依赖 outline_01)
write_02 (依赖 outline_02)  ← 不等待 write_01
write_03 (依赖 outline_03)  ← 不等待 write_02
write_04 (依赖 outline_04)  ← 不等待 write_03

并行执行效果

时间	完成任务	可开始任务	并行情况
T1	outline_01	outline_02 + write_01	并行
T2	outline_02	outline_03 + write_02	并行
T3	outline_03	outline_04 + write_03	并行

任务命名规范

任务类型	ID 格式	示例
细纲任务	`outline_NN`	outline_01, outline_02, ...
正文任务	`write_NN`	write_01, write_02, ...
审查任务	`review_NN`	review_01, review_02, ...

任务属性

json

{
  "id": "outline_01",
  "name": "第1章_细纲_半块玉牌",
  "chapter": 1,
  "type": "outline",  // outline | writing | review
  "status": "pending",
  "agent": "novel_architect",
  "output": "/path/to/04_章节细纲/第01章_半块玉牌.md"
}

🔄 版本历史

v7.18.1 (2026-03-15)

✅ 清理老版本文件（v5/v7 引擎、v2 执行器、v2 健康检查）
✅ 删除冗余测试框架（stress-test、test-framework）
✅ 释放空间 120 KB，文件数从 53 减少到 47
✅ 备份位置：backups/20260315_215924/

v7.18.0 (2026-03-15)

✅ 新增任务依赖模型（细纲串行 + 正文并行）
✅ 新增任务依赖生成器
✅ 新增任务状态修复脚本
✅ 优化流水线并行效率

v4.0.0 (2026-03-12)

✅ 新增智能任务拆解引擎
✅ 新增多 Agent 智能协作
✅ 新增实时状态追踪（秒级）
✅ 新增自动学习迭代系统
✅ 监控间隔从 60 秒降至 10 秒
✅ 性能提升 30%

v3.6.0 (2026-03-08)

✅ 修复文件名匹配问题
✅ 实现按顺序触发
✅ 新增活跃项目检测

v3.5.0 (2026-03-08)

✅ 新增通用任务依赖自动触发
✅ 支持所有项目类型

📖 参考文档

让敏捷协作全自动、智能化、持续优化！ 🚀

Agile Workflow

Install

全自动敏捷协作工作流引擎 v7.0

🎯 版本演进

v7.0 vs v6.1 (最新)

v6.1 vs v4.0

🚀 核心功能

1. 智能任务拆解

2. 多 Agent 智能协作

3. 实时状态追踪

4. 自动学习迭代

📦 安装与配置

安装

配置

🛠️ 使用方式

命令列表

1. 任务管理

2. 执行控制

3. 日志查看

📊 工作流程

完整流程图

小说创作示例

🧠 学习系统

经验记录

优化建议生成

📈 监控指标

任务指标

Agent 指标

🔧 故障排查

问题 1: 任务未自动触发

问题 2: Agent 负载过高

问题 3: 学习系统未生效

📊 性能对比

v3.6 vs v4.0

🎯 最佳实践

1. 任务拆解

2. 监控配置

3. 学习优化

📚 核心文件

🔄 任务依赖模型 v1.0（细纲串行 + 正文并行）

核心原则

依赖关系图

并行执行效果

任务命名规范

任务属性

相关脚本

🔄 版本历史

v7.18.1 (2026-03-15)

v7.18.0 (2026-03-15)

v4.0.0 (2026-03-12)

v3.6.0 (2026-03-08)

v3.5.0 (2026-03-08)

📖 参考文档

Related skills