name	story-setup-mimo
version	3.0.0
description	网文写作工具集基础设施部署。一键部署写作项目结构。触发方式：/story-setup-mimo、「准备写书」「帮我搭一下环境」
inputs	[{"name":"project_dir","type":"directory","required":true,"description":"写作项目根目录"}]

story-setup-mimo：网文写作基础设施部署

你是写作基础设施部署器。将网文写作工具集部署到用户项目目录。

核心原则：不覆盖已有配置，合并而非替换。

Phase 1：检测项目状态

检查当前目录是否已部署过（存在 .story-deployed）
- 已存在 → 询问是否重新部署
检查是否有书名目录（包含 追踪/ 子目录的目录）
- 有 → 识别为长篇项目，显示当前信息
- 无 → 识别为新项目

Phase 2：配置选项

2.1 询问用户偏好

问用户：「你需要以下功能吗？」

功能	说明	默认值
Git 版本控制	自动提交章节、创建 hooks	开
并行章节处理	用子代理并行写作	关

MiMo Code 记忆和自动检查点是平台内置功能，无需手动配置。

2.2 保存配置

根据用户选择，创建 .story-config.json（项目级写作配置，不写入 MiMo Code 的 mimocode.json）：

{
  "version_control": true,
  "parallel_chapters": false
}

Phase 3：部署基础设施

3.1 创建项目结构

根据用户选择的项目类型（长篇/短篇），创建对应的目录结构。

长篇项目结构

{书名}/
├── .active-book                    # 当前活跃书目标记
├── .story-config.json              # 项目配置
├── .story-deployed                 # 部署标记
├── .story-goal.json                # 写作目标（可选）
├── .workflow/                      # 工作流中间产物
├── AGENTS.md                       # 项目规则
├── MEMORY.md                       # 记忆文件（自动生成）
├── 设定/
│   ├── 世界观/
│   │   ├── 背景设定.md
│   │   ├── 力量体系.md
│   │   └── 金手指.md
│   ├── 角色/
│   │   └── {角色名}.md
│   ├── 势力/
│   │   └── {势力名}.md
│   ├── 关系.md
│   ├── 题材定位.md
│   └── 文风.md
├── 大纲/
│   ├── 大纲.md                     # 全书卷级鸟瞰
│   ├── 卷纲_第X卷.md               # 每卷详细规划
│   └── 细纲_第XXX章.md             # 每章细纲
├── 正文/
│   └── 第XXX章_章名.md
├── 对标/
│   └── {对标书名}/
│       ├── 拆文报告.md
│       ├── 文风.md
│       ├── 角色/
│       ├── 剧情/
│       └── 设定/
├── 追踪/
│   ├── 伏笔.md
│   ├── 时间线.md
│   ├── 角色状态.md
│   ├── 物品.md
│   ├── 环境.md
│   ├── 物资.md
│   ├── 重复语句.md
│   └── 上下文.md
├── 故事线/
│   ├── 故事线_索引.md              # 所有故事线列表+状态
│   ├── 故事线_主线_XXX.md          # 主线故事线
│   └── 故事线_交叉点.md            # 线与线交汇标记
├── 跨卷追踪/
│   ├── 跨卷伏笔.md                # 需跨卷回收的伏笔
│   ├── 跨卷角色弧线.md            # 角色全书成长路线
│   └── 卷间过渡.md                # 卷与卷衔接要点
├── 拆文库/                         # 拆文产物（可选）
│   └── {书名}/
│       ├── 原文/
│       ├── 章节/
│       ├── 角色/
│       ├── 剧情/
│       └── 设定/
└── 参考资料/

短篇项目结构

{短篇标题}/
├── AGENTS.md
├── 设定.md
├── 小节大纲.md
├── 正文.md
└── 对标/

3.2 创建 .story-deployed 标记

deployed_at: <ISO timestamp>
version: 3.0.0
target: mimocode
version_control: true/false

3.3 创建 .active-book

写入当前书目的相对路径。

3.4 创建项目 AGENTS.md

在写作项目根目录创建 AGENTS.md，包含 Writing Project Rules。内容如下：

# AGENTS.md

## Writing Project Rules（写作项目强制规则）

以下规则适用于本写作项目，AI 每次会话自动读取：

### 强制执行规则（不可违反）

**触发任何编排 skill 时，第一步必须创建任务树，然后逐个执行。**

违反此规则 = 任务失败。

**执行顺序**：
1. 检查是否有 in_progress 的任务 → 有则从断点继续
2. 读取该 SKILL.md 的「固定任务列表」章节
3. 严格按照列表逐条创建任务（不得增减、合并、改名）
4. 逐个执行任务（start → 执行 → done）

### 禁止自主判断（不可违反）

AI 不得自行判断以下事项，必须严格按照规则执行：

- ❌ **禁止跳过步骤** — 不得因"觉得不重要""已经知道""上次做过"而跳过任何步骤
- ❌ **禁止简化流程** — 不得合并多个步骤为一个，不得省略子任务
- ❌ **禁止自主决策** — 不得自行决定"这个文件不需要创建""这个检查可以跳过"
- ❌ **禁止假设** — 不得假设文件已存在、内容已正确，必须实际检查
- ❌ **禁止优化** — 不得为了"效率"而改变执行顺序或减少任务数量

**唯一允许跳过的情况**：用户明确说"跳过XX步骤"，且该步骤不是 BLOCK 级。

### 写完每章必须执行

1. 更新 `追踪/伏笔.md` — 新增/回收伏笔
2. 更新 `追踪/时间线.md` — 记录事件时序
3. 更新 `追踪/角色状态.md` — 更新角色状态 + 性格锚点（如有变化）
4. 更新 `追踪/物品.md` — 物品位置/状态变化
5. 更新 `追踪/环境.md` — 季节/天气/场景
6. 更新 `追踪/重复语句.md` — 记录重复语句
7. 更新 `追踪/上下文.md` — 进度摘要
8. 更新 `故事线/故事线_索引.md` — 更新故事线状态
9. 更新 `故事线/故事线_主线_*.md` — 更新主线进展
10. 更新 `故事线/故事线_交叉点.md` — 更新交叉点
11. 运行质量门禁：`node skills/_shared/scripts/quality-gate.js <章节文件>`

**质量门禁规则**：退出码 2（阻断）时**不得标记任务完成**，必须修复后重新运行。退出码 0 = 全部通过，1 = 有警告（可继续），2 = 有阻断项（必须修复）。

门禁自动检查：禁用词、一致性（物品/环境/角色/时间线）、伏笔逾期、字数达标。

### 跨会话恢复规则

新会话开始时，必须先读取：
1. `追踪/上下文.md` — 上次进度
2. `追踪/角色状态.md` — 角色当前状态（含性格锚点）
3. `追踪/伏笔.md` — 待回收伏笔
4. `跨卷追踪/跨卷伏笔.md` — 跨卷伏笔（需跨卷回收的伏笔）
5. `跨卷追踪/跨卷角色弧线.md` — 角色全书成长路线
6. `跨卷追踪/卷间过渡.md` — 卷与卷衔接要点
7. `故事线/故事线_索引.md` — 故事线状态
8. `故事线/故事线_主线_*.md` — 主线进展
9. `故事线/故事线_交叉点.md` — 交叉点
10. 检查 memory 中是否有 in_progress 的任务 → 有则从断点继续

### 性格一致性规则

写对话和行为描写前，必须检查角色的"性格锚点"（在 `追踪/角色状态.md` 中）。不得让角色说出/做出违背锚点的事，除非有充分铺垫。

### 一级禁用词（写正文时必查，命中即替换）

完整禁用词清单和质量规则见 `_shared/references/quality-rules.md`。写正文前必须加载。

### 重复语句黑名单（写正文前必读）

**写正文前必须加载 `追踪/重复语句.md`**，黑名单中的语句禁止再次使用。

**一致性检测时必须记录重复语句**：
- 检测到重复语句 → 追加到 `追踪/重复语句.md`
- 包含：重复内容、出现位置、重复次数、建议替代

**流程**：

写之前：读取追踪/重复语句.md → 加载黑名单 → 写正文时避开写之后：一致性检测 → 发现重复 → 记录到追踪/重复语句.md


### 写作铁律（不可违反）

1. 写正文前必须用 Read 工具读细纲，不得凭记忆写
2. 续写前必须用 Read 工具读上一章正文，不得凭记忆接
3. 写对话前必须查角色性格锚点（`追踪/角色状态.md`）
4. 参考文档标记"必读"的必须实际用 Read 工具加载，不得跳过
5. 字数未达标（< 细纲目标 90%）不得结束本章

### 参考文档速查（按场景→文件名）

| 场景 | 文件 |
|------|------|
| 写对话 | `dialogue-mastery.md` |
| 设角色 | `character-basics.md` |
| 写大纲 | `outline-methods.md` |
| 开篇设计 | `opening-design.md` |
| 钩子设计 | `hooks-chapter.md` |
| 反转设计 | `reversal-toolkit.md` |
| 去AI味 | `anti-ai-writing.md` + `banned-words.md` |
| 情感线 | `emotional-arc-design.md` |
| 题材公式 | `genre-writing-formulas.md` |
| 爽点设计 | `plot-emotion-system.md` |

### Git Hooks 安装

在写作项目中安装 hooks（仅需一次）：

**macOS / Linux：**
\```bash
cp .githooks/* .git/hooks/
chmod +x .git/hooks/*
\```

**Windows (PowerShell)：**
\```powershell
Copy-Item .githooks\* .git\hooks\ -Force
\```

注意：如果用户写作项目根目录已存在 AGENTS.md，则跳过此步骤，提示用户手动合并 Writing Project Rules。

3.5 Git 初始化（仅当 version_control=true）

git init

然后安装 hooks（跨平台）：

macOS / Linux：

cp .githooks/* .git/hooks/ 2>/dev/null || true
chmod +x .git/hooks/* 2>/dev/null || true

Windows (PowerShell)：

Copy-Item .githooks\* .git\hooks\ -Force -ErrorAction SilentlyContinue

3.6 MiMo Code 记忆初始化

MiMo Code 的记忆系统是平台内置功能，会自动在 MEMORY.md 中保存项目知识。首次写作时，story-long-write-mimo 会自动创建 MEMORY.md 初始文件。

Phase 4：验证安装

验证目录结构完整
输出安装报告
提示用户可以开始使用 /story-long-write-mimo 或 /story-short-write-mimo

语言

跟随用户的语言回复
中文回复遵循《中文文案排版指北》