# Mj Book Swarm

> Use when a book project has multiple chapters or sections that can be researched, drafted, or revised in parallel by separate agents without sharing a write target.

- Skill: `makerjackie/mj-book-swarm` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add makerjackie/mj-book-swarm`
- Raw SKILL.md: https://api.skillmd.com/api/skills/makerjackie/mj-book-swarm/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: makerjackie (https://skillmd.com/u/makerjackie)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/makerjackie/mj-book-swarm

---


# MJ Book Swarm

把一本书拆成可以并行推进的写作单元。

## 什么时候用

- 已经有研究笔记
- 已经有目录树
- 至少有 2 个章节可以独立写
- 每个 agent 都能拿到清楚的 source pack 和章节 brief

## 核心原则

- 一个 agent 只拥有一个章节或一个明确小节
- 共享 research note，但不共享写入文件
- 先定 brief，再开写
- 主线程只做整合，不和子线程抢同一段落

## 推荐拆法

### 方案 A：按章节拆

- Agent 1：平台定位
- Agent 2：产品地图
- Agent 3：中国章节
- Agent 4：案例 / appendix

### 方案 B：按工序拆

- Agent 1：补官方来源
- Agent 2：写正文
- Agent 3：做去 AI 味审校
- Agent 4：统一 source notes

## 每个 agent 必须拿到

- 本章标题
- 读者问题
- 必须使用的来源
- 禁止越界的边界
- 输出文件路径

## 合并规则

- 先合 research，再合正文
- 每次只合一个章节
- 合并后统一跑一遍 `mj-book-polish`

## 失败信号

- 两个 agent 同时改一章
- 没有 source pack 就开写
- 子 agent 写成“总述”，导致章节互相重复