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. 智能任务拆解 ``` 输入：创作一部玄幻小说 ↓ 智能拆解 输出： - 世界观架构 (依赖：无) - 人物体系 (依赖：世界观) - 情节大纲 (依赖：人物体系) - 章节细纲 (依赖：情节大纲) - 正文创作 (依赖：章节细纲) - 审查 (依赖：正文创作) ``` **特点**: - ✅ 自动识别任务类型（小说/开发/文档） - ✅ 自动分析依赖关系 - ✅ 应用历史经验优化拆解 ### 2. 多 Agent 智能协作 ``` 任务 → 智能路由 → Agent 选择 → 负载均衡 → 执行 ↓ 实时负载检测 (避免过载) ``` **特点**: - ✅ 根据任务类型自动选择最佳 Agent - ✅ 实时检测 Agent 负载 - ✅ 动态调整任务分配 ### 3. 实时状态追踪 ``` 状态机： pending → ready → running → completed ↓ failed/timeout ``` **特点**: - ✅ 秒级状态更新 - ✅ 自动检测超时任务 - ✅ 失败自动重试 ### 4. 自动学习迭代 ``` 执行 → 记录结果 → 分析模式 → 生成优化 → 应用优化 ↓ ↑ └──────────────────────────────────────┘ 持续改进闭环 ``` **特点**: - ✅ 记录成功/失败模式 - ✅ 自动生成优化建议 - ✅ 持续改进工作流 --- ## 📦 安装与配置 ### 安装 ```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 ``` --- ## 📊 工作流程 ### 完整流程图 ``` 用户输入任务 ↓ [智能拆解引擎] ↓ 生成子任务 + 依赖关系 ↓ [任务分配器] → 选择最佳 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 ``` **解决**: 1. 确认引擎已启动 2. 检查上游任务是否完成 3. 验证依赖关系配置 ### 问题 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（细纲串行 + 正文并行） ### 核心原则 1. **细纲任务串行执行**：`outline_N` 依赖 `outline_{N-1}` 2. **正文任务只依赖细纲**：`write_N` 依赖 `outline_N`（不依赖 `write_{N-1}`） 3. **流水线并行**：细纲完成后正文可立即开始 ### 依赖关系图 ``` 细纲任务链（串行）： 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" } ``` ### 相关脚本 - **依赖生成器**: `scripts/task-dependency-generator.js` - **任务修复**: `scripts/repair-task-states.js` - **依赖检查**: `core/dependency-manager.js` --- ## 🔄 版本历史 ### 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) - ✅ 新增通用任务依赖自动触发 - ✅ 支持所有项目类型 --- ## 📖 参考文档 - [工作流引擎架构](/workspace/docs/agile-workflow-architecture.md) - [学习系统说明](/workspace/docs/learning-system.md) - [故障排查指南](/workspace/docs/troubleshooting.md) --- **让敏捷协作全自动、智能化、持续优化！** 🚀