MBA/学术论文多Agent协作工作流#

完整文档见： references/checklist.md（学术规范清单）、 references/loop-design.md（Loop 设计原理）

⚠️ 触发规则#

当用户请求生成 Word 文档且满足以下任一条件时， 必须 调用本 skill 的 Word 输出流程，不得使用简单 md2docx 脚本：

• 输入文件路径匹配： 论文*.md、 *thesis*.md、 *dissertation*.md
• 上下文中存在「论文」「MBA」「答辩」「开题」等关键词
• 用户明确要求导出 .docx 格式且文件性质为学术论文

正确流程： 写作语法预检 → Review Agent 终审（ scripts/loop_self_check.py 校验通过）→ scripts/md2docx_strict.py 合规转换 → Word 输出

核心架构#

text

Phase 1（规划）→ Phase 2（双版本起草）→ Phase 2.5（用户确认）
→ Phase 3（格式审核）→ Phase 3.5（学术深度评审）
→ Phase 4（整合）→ Phase 5（终审）→ [Phase 5.1 去AI味] → Phase 5.2（Word 输出）

⚠️ 阶段强制顺序： 全部 Phase 必须按顺序执行，不得跳过。Phase 2.5（人工确认门槛）和 Phase 3.5（深度评审）是固定节点，不得跳过。

Agent 设计原则#

每个 Agent 只做一件事。 Agent 间通过文件传递结果，不共享上下文。Orchestrator 专注调度，不执行执行性工作。

Agent调用方式主责Orchestrator当前 session调度 / 推进 / 决策H-generatorexec hermes chat版本H起草（深度逻辑链）Executorsessions_spawn版本O起草 + 格式执行Reviewersessions_spawnPhase 3/5 规则型审核DeepReviewersessions_spawnPhase 3.5 学术深度评审Integratorsessions_spawnPhase 4 整合方案WordAgentexec python3md2docx执行 + 格式校验

关键实现说明#

版本H/版本O 的分工#

• 版本H（Hermes优先）： hermes --version 检测安装，可用则 hermes chat，不可用回退到 sessions_spawn subagent。版本H prompt 必须包含「数据查询工具」说明（ web_search / academic-research / arxiv-search-collector），让 Agent 主动搜索行业数据而非仅靠内部知识。
• 版本O（OpenClaw）： 始终通过 sessions_spawn 启动 subagent，格式规范优先。

公司信息处理#

• 用真实公司名搜索公开数据，填入正文时替换为代号（A公司/B公司）
• 搜索 prompt 用真实名，输出 prompt 用代号
• 映射关系不进入最终文档

检索同步规则#

所有 Phase 调用数据查询工具（ web_search / academic-research）时，必须：

1. 同步输出工具名称 + 查询条件 + 结果摘要（<50字）
2. Subagent 用 sessions_send 向主 session 发送同步
3. 大型检索完成后输出结构化结果摘要

数据查询工具#

工具场景调用web_search行业数据/市场规模/企业信息直接描述搜索需求academic-research学术文献/引用分析python3 scripts/scholar-search.py search "关键词"``arxiv-search-collector前沿论文追踪初始化后批量抓取

Phase 详解#

Phase 1：规划与定稿#

通过问答输出确认清单，用户逐项确认后方可动笔。

红色星标项（必填）：

• ⭐ 实际公司名称（仅用于数据检索，正文以A公司/B公司呈现，不进入公开文档）
• ⭐ 大纲结构（7章大纲逐章确认）
• 论文基本信息（题目/作者/专业/学位类型/答辩年份）

→ 生成「写作任务书」用户签收后进入 Phase 2。

Phase 2：双版本起草#

前置检查： Phase 1 必填项已确认 / Hermes 可用 / Executor 可用

章节×版本对照：

章节版本O版本H第1/2/7章✅ 必须❌第3/4/5/6章✅ 必须✅ 必须（核心章节双版本对比）

Phase 2 强制检索要求（关键词中的 {论文主题行业} 由 Orchestrator 自动提取）：

• 第3章 PESTEL 分析前 → 搜索「{论文主题行业} 市场规模/趋势/政策」
• 第3章 五力模型分析前 → 搜索「{论文主题行业} 主要竞争对手/市场份额」
• 战略理论部分 → 搜索「{论文主题行业} 竞争战略 应用」
• 每章至少 1 个引用标注来源，全文检索记录 ≥ 3 次

输出物： 版本O文件（第1-7章全部）+ 版本H文件（第3-6章全部） 状态文件机制： {论文名}_任务状态.json（见 scripts/state_manager.py）

→ 所有文件存在且字数达标后进入 Phase 2.5（用户确认）。

Phase 3：双版本审核#

Reviewer 分别对版本H和版本O输出独立审核报告。审核维度：格式 / 大纲 / 内容准确性 / 查重风险 / 学术规范 / 写作语法。

Phase 3.5：深度学术评审（固定节点）#

DeepReviewer 对 Phase 3 报告进行二次审查，输出 P0/P1/P2 分级问题清单。P0 问题进入修订 → 重审闭环（见审核 Loop）。

Phase 4：整合#

Integrator 汇总 Phase 3 + Phase 3.5 全部评审结果，制定整合方案。核心原则：取长补短，不为统一而破坏内容质量。

自动验证： 整合版运行 python3 scripts/loop_self_check.py 校验，100%通过方可输出 Word。

Phase 5：终审与输出#

• Phase 5：Reviewer 终审
• Phase 5.1：[可选] humanize-chinese skill 去AI味
• Phase 5.2： python3 scripts/md2docx_strict.py 生成 Word 文档

Orchestrator 生命周期管理#

执行脚本： scripts/orchestrator.py 配合 OpenClaw cron 实现自动推进

启动方式#

用户确认 Phase 1 任务书后，Orchestrator 创建 cron job（每 5 分钟检查一次状态文件）。

bash

# 手动触发决策（测试用）
python3 scripts/orchestrator.py 论文_xxx_任务状态.json

# 决策 + 自动校验
python3 scripts/orchestrator.py 论文_xxx_任务状态.json --validate

生命周期#

text

用户启动 → 创建 cron（每5分钟检查状态文件）
             ↓
    orchestrator.py 读取状态文件 → 决策引擎判断
    ┌───────────────┬────────────┬───────────────┐
    ↓               ↓            ↓               ↓
  执行下一 Phase   HIL 暂停     RETRY 打回      全部完成
                     ↓            ↓                ↓
                 发消息等你     Agent 补写      cron 删除自己
                 回复确认后     → 恢复循环
                 恢复循环

HIL 节点（自动暂停，需你确认）#

节点暂停原因确认后行为Phase 1→2公司映射表 + 大纲进入 Phase 2Phase 2→2.5章节内容是否预期进入 Phase 3Phase 3.5→4P0 修复超 3 轮接受/继续修订Phase 4→5整合方案是否接受进入终审

审核 Loop 自动重审#

Phase 3.5 完成 → orchestrator 解析 P0 计数 → 有 P0？→ 自动进入修订 → 修订完成 → 自动回到 Phase 3.5 重审 → 连续 2 轮无新 P0 → 通过 → 超过 3 轮 → HIL 暂停

Phase 内部自检#

每 Phase 完成后，orchestrator 自动运行 loop_self_check.py 校验：

bash

python3 scripts/orchestrator.py 状态文件.json --validate

校验失败 → RETRY 打回 → Agent 修复 → 再次校验（最多 3 次）

⚠️ Loop 设计原则#

详细原理见 references/loop-design.md

Loop 元素作用终止条件Orchestrator Loop每 Phase 完成后自动判断下一步全部 7 Phase 完成Phase 内部自检 LoopObserve → Think → Act → Verify 四步Guardrails 100% 通过审核 Loop审→改→重审→连续2轮无新P0→通过连续 2 轮无新 P0/P1Guardrails 校验scripts/loop_self_check.py 10项自动化检查全部通过Verification LoopWord 输出后自动校验格式Word 格式 100% 通过

最大重试： 每个 Loop 3 次，超过则强制 Human-in-the-loop。 Human-in-the-loop检查点： Phase 1/2.5/4/5.2 末尾，必须用户确认才能推进。

Guardrails 校验（10 项）#

bash

python3 scripts/loop_self_check.py --file 论文_xxx.md   # 单文件
python3 scripts/loop_self_check.py --phase 2 --workspace ~/.openclaw/workspace/  # Phase 级别
python3 scripts/loop_self_check.py --file 论文_xxx.docx --verify-docx           # Word 校验

#校验项失败阻断1章节完整性（7章齐全）Phase 2/42字数门槛（每章≥100行）Phase 2/43参考文献存在Phase 44无 ## 第X章 混合格式Phase 2/45无 **正文加粗**Phase 2/46引用完整性（≥10处）Phase 2/47三线表列数一致Phase 48表标题在表上方Phase 49无合并残留（ ===END===）Phase 410核心章节关键词（第5章战略/第6章实施）Phase 2.5

Word 输出质量保障#

正文加粗过滤#

• 正文段落（非标题级）内的 **text** → 去掉 ** 转为普通文字
• 表格单元格内的 ** 同步清除（ scripts/md2docx_strict.py 的 _strip_bold() 函数）

三线表格式#

• 顶线 1.5 磅 / 表头底线 0.75 磅 / 底线 0.5 磅，无竖线

分页#

• 每章标题前插入分页符（首章跳过），附录/致谢前分页

附录：脚本与文档结构#

text

mba-thesis-workflow/
├── SKILL.md                    ← 本文件（简版触发器 + 核心逻辑）
├── README.md / README_EN.md    ← 安装/使用说明
├── CHANGELOG.md                ← 版本日志
├── config.template             ← 配置模板
├── install.sh                  ← 安装脚本
├── .clawhubignore / .github/workflows/skill-publish.yml
├── scripts/
│   ├── md2docx_strict.py       ← Word 合规转换
│   ├── loop_self_check.py      ← Guardrails 自动化校验（10项）
│   ├── state_manager.py        ← 状态文件管理
│   └── tests/                  ← 单元测试
└── references/
    ├── checklist.md            ← 学术规范人工对照清单
    └── loop-design.md          ← Loop 设计原理说明