Mba Thesis Workflow

v2 新框架：多Agent协作完成MBA/学术论文写作的完整工作流。v2 重构为 outline-anchored 设计 + 9 HIL 节点 + 真实 CLI 入口。⚠️ 测试版，需独立安装（不覆盖 v1）。

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-generator	exec hermes chat	版本H起草（深度逻辑链）
Executor	sessions_spawn	版本O起草 + 格式执行
Reviewer	sessions_spawn	Phase 3/5 规则型审核
DeepReviewer	sessions_spawn	Phase 3.5 学术深度评审
Integrator	sessions_spawn	Phase 4 整合方案
WordAgent	exec python3	md2docx执行 + 格式校验

关键实现说明

版本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 生命周期管理

真实入口（v2.0.6 新增）

执行脚本：scripts/run_workflow.py（v2 真实入口 CLI） 状态文件：~/.openclaw/workspace/{paper_name}/_orchestrate_state.json 设计原则：驱动状态机 + 9 个 HIL 节点 hard pause

bash

# 仅查看状态
python3 scripts/run_workflow.py <paper_name> --status

# auto 模式：根据 state 自动判断下一步
python3 scripts/run_workflow.py <paper_name> --phase auto

# 指定阶段
python3 scripts/run_workflow.py <paper_name> --phase phase1
python3 scripts/run_workflow.py <paper_name> --phase phase2  # 需 --llm
python3 scripts/run_workflow.py <paper_name> --phase phase3

Python API（v2.0.6 推荐）

python

import sys
sys.path.insert(0, "scripts")
from orchestrator_v2 import orchestrate, write_single_node, apply_user_decision

# Phase 1.1: 解析开题报告（docx 或文本）
r = orchestrate(paper_name, action="phase1_1_init",
                input_type="docx", input_data="path/to/proposal.docx")

# Phase 1.2: 确认大纲（用户 HIL）
r = orchestrate(paper_name, action="phase1_confirm")

# Phase 1.3: 提交开题报告归因
r = orchestrate(paper_name, action="phase1_3_submit",
                docx_path="path/to/proposal.docx", llm_func=my_llm)

# Phase 1.3: 确认归因（用户 HIL）
r = orchestrate(paper_name, action="phase1_3_confirm")

# Phase 2: 逐节点写作（v2.0.4 推荐调用模式）
for node_id in next_nodes:
    r = write_single_node(paper_name, node_id, llm_func=my_llm,
                          reviewer_func=my_reviewer)  # 独立评审
    if r["action"] == "needs_user_input":
        # HIL #3：info_scarcity 3 决策路径
        apply_user_decision(paper_name, node_id, "2")  # AI 自行生成
        r = write_single_node(paper_name, node_id, llm_func=my_llm,
                              reviewer_func=my_reviewer, bypass_scarcity=True)
    elif r["action"] == "pending_review":
        # HIL #4：评审质量 medium/low
        # 用户决策后重新调

# Phase 3: 整合
r = orchestrate(paper_name, action="phase3_review")
# Phase 5: 导出
r = orchestrate(paper_name, action="phase3_export")

HIL 节点（v2.0.6 完整 9 个）

#	触发位置	检查内容	决策
1	Phase 1.1 后	大纲结构	接受 / 修改
2	Phase 1.3 后	归因结果	接受 / 调整 hint
3	Phase 2 写作前	info_scarcity	提供 hint / AI 生成 / 跳过
4	Phase 2 评审后	quality=medium/low	接受 / 重写
5	Phase 2 完成后	章节内容预览	通过 / 修改
6	Phase 3 整合后	整合版内容	通过 / 修改反馈
7	Phase 3.5 P0 修复	超 3 轮未收敛	接受 / 继续修订
8	Phase 4 整合方案	方案是否接受	接受 / 修改
9	Phase 5.2 后	Word 输出	导出 / 修改

v2.0.6 拦截规则（enforcement）

• 拍板 #1 强制：Phase 1.3 不允许跳过
  • orchestrate(action="phase1_3_skip") → 拦截，返回 拍板 #1 强制不允许跳过
  • skip_phase1_3() 函数体加 MBA_THESIS_PRODUCTION=1 env guard + 必填 reason/operator + audit log
• B-2 幂等保护：outline_update_status() 默认拒绝覆盖已 completed 节点的内容
  • 需重写请调 write_single_node(bypass_scarcity=True) 重走标准流程
  • 或显式传 force=True（调试用）
• 独立 Reviewer：write_single_node() 接受 reviewer_func 参数
  • 防止生成和评审使用同一 LLM（自我审核）
  • 默认 reviewer_func == llm_func 时发警告
  • 调试场景可显式 allow_self_review=True

审核 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 内部自检 Loop	Observe → Think → Act → Verify 四步	Guardrails 100% 通过
审核 Loop	审→改→重审→连续2轮无新P0→通过	连续 2 轮无新 P0/P1
Guardrails 校验	scripts/loop_self_check.py 10项自动化检查	全部通过
Verification Loop	Word 输出后自动校验格式	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/4
2	字数门槛（每章≥100行）	Phase 2/4
3	参考文献存在	Phase 4
4	无 ## 第X章 混合格式	Phase 2/4
5	无 **正文加粗**	Phase 2/4
6	引用完整性（≥10处）	Phase 2/4
7	三线表列数一致	Phase 4
8	表标题在表上方	Phase 4
9	无合并残留（===END===）	Phase 4
10	核心章节关键词（第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 设计原理说明