/pre-write-checklist

name: pre-write-checklist
description: "Activates automatically before chapter writing to enforce the 9-item mandatory file reading checklist - prevents AI focus degradation in long-form fiction by ensuring all context is loaded before each writing session"
allowed-tools: Read, Grep

写作前强制检查清单

核心功能

**解决AI长篇失焦问题** - 这是Novel Writer Skills v1.0的核心创新。

问题根源

用户反馈：使用novel-writer创作，前30章质量很好，但30章后AI开始：

• 忘记前文设定
• 角色性格不一致
• 情节重复或矛盾
• 忽略创作宪法的原则

**根本原因**：长对话导致AI遗忘早期context，即使specification.md写得再详细也会被忘记。

解决方案

**每次写作前强制重读所有关键文件** → AI重新加载完整context → 保持一致性

---

9项强制检查清单

每次执行`/write`命令时，必须先完成此检查清单：

📋 写作前检查清单（必须完成）：

✓ 1. memory/constitution.md - 创作宪法
✓ 2. memory/style-reference.md - 风格参考（如有）
✓ 3. stories/*/specification.md - 故事规格
✓ 4. stories/*/creative-plan.md - 创作计划
✓ 5. stories/*/tasks.md - 当前任务
✓ 6. spec/tracking/character-state.json - 角色状态
✓ 7. spec/tracking/relationships.json - 关系网络
✓ 8. spec/tracking/plot-tracker.json - 情节追踪（如有）
✓ 9. spec/tracking/validation-rules.json - 验证规则（如有）

📊 上下文加载状态：✅ 完成

---

工作原理

自动触发时机

1. **用户执行 `/write` 命令** 2. **本Skill自动激活** 3. **强制执行检查清单** 4. **输出确认报告** 5. **然后才开始写作**

执行流程

用户: /write 第10章

         ↓

[pre-write-checklist 自动激活]

         ↓

步骤1：读取 memory/constitution.md
步骤2：读取 memory/style-reference.md（如有）
步骤3：读取 stories/*/specification.md
步骤4：读取 stories/*/creative-plan.md
步骤5：读取 stories/*/tasks.md
步骤6：读取 spec/tracking/character-state.json
步骤7：读取 spec/tracking/relationships.json
步骤8：读取 spec/tracking/plot-tracker.json（如有）
步骤9：读取 spec/tracking/validation-rules.json（如有）

         ↓

输出确认：
📋 写作前检查清单（已完成）：
✓ 1-9 所有文件已读取
📊 上下文加载状态：✅ 完成

关键信息摘要：
- 创作原则：[从constitution提取]
- 当前任务：[从tasks.md提取]
- 主要角色：[从character-state提取]
- 情节进度：[从plot-tracker提取]

         ↓

开始写作第10章...

---

输出格式

标准输出（所有文件存在）

📋 写作前检查清单（已完成）：

✓ 1. memory/constitution.md - 创作宪法
   → 核心原则：[列出2-3条关键原则]

✓ 2. memory/style-reference.md - 风格参考
   → 风格要点：[提取关键风格要求]

✓ 3. stories/xxx/specification.md - 故事规格
   → 故事类型：[言情/悬疑/历史等]
   → P0元素：[必须包含的元素]

✓ 4. stories/xxx/creative-plan.md - 创作计划
   → 当前阶段：[第X卷/第X章]
   → 本章目标：[情节/情感目标]

✓ 5. stories/xxx/tasks.md - 当前任务
   → 待写章节：[第X章]
   → 任务状态：[pending/in_progress]

✓ 6. spec/tracking/character-state.json - 角色状态
   → 主要角色：[列出角色名和当前状态]

✓ 7. spec/tracking/relationships.json - 关系网络
   → 核心关系：[主角与谁的关系变化]

✓ 8. spec/tracking/plot-tracker.json - 情节追踪
   → 活跃线索：[当前进行中的情节线]

✓ 9. spec/tracking/validation-rules.json - 验证规则
   → 自动修复：[启用/禁用]

📊 上下文加载状态：✅ 完成（加载9个文件，约XXXX tokens）

🎯 准备写作第X章...

部分文件缺失时

📋 写作前检查清单（部分完成）：

✓ 1. memory/constitution.md - 创作宪法
✓ 2. ⚠️ memory/style-reference.md - 不存在（可选文件，跳过）
✓ 3. stories/xxx/specification.md - 故事规格
✓ 4. stories/xxx/creative-plan.md - 创作计划
✓ 5. stories/xxx/tasks.md - 当前任务
✓ 6. spec/tracking/character-state.json - 角色状态
✓ 7. spec/tracking/relationships.json - 关系网络
✓ 8. ⚠️ spec/tracking/plot-tracker.json - 不存在（可选文件，跳过）
✓ 9. ⚠️ spec/tracking/validation-rules.json - 不存在（可选文件，跳过）

📊 上下文加载状态：✅ 完成（加载6个必须文件 + 0个可选文件）

💡 建议：运行 `/track-init` 初始化完整追踪系统

关键文件缺失时（阻止写作）

📋 写作前检查清单（失败）：

✓ 1. memory/constitution.md - 创作宪法
✓ 2. memory/style-reference.md - 风格参考
❌ 3. stories/xxx/specification.md - **文件不存在**
❌ 4. stories/xxx/creative-plan.md - **文件不存在**
❌ 5. stories/xxx/tasks.md - **文件不存在**

⛔ 错误：缺少必需文件，无法继续写作

必须先完成：
1. 运行 `/constitution` 创建创作宪法
2. 运行 `/specify` 定义故事规格
3. 运行 `/plan` 制定创作计划
4. 运行 `/tasks` 分解任务清单

然后才能执行 `/write`

这是seven-step methodology的推荐流程。

---

与Commands集成

`/write` 命令

**必须先执行检查清单，才能写作**：

执行顺序：
1. pre-write-checklist（本Skill）→ 读取所有文件
2. 输出确认报告
3. 检查setting-detector → 是否需要激活知识库
4. 开始实际写作

`/analyze` 命令

分析时也建议执行检查清单：

分析前先确保context完整：
1. pre-write-checklist → 重新加载所有文件
2. 基于最新状态执行分析

`/track` 命令

追踪更新后触发检查清单：

更新流程：
1. 用户修改tracking文件
2. 运行 `/track` 更新
3. pre-write-checklist → 重新读取验证

---

文件重要性分类

必须文件（缺失则阻止写作）

1. memory/constitution.md - 创作原则
3. stories/*/specification.md - 故事规格
4. stories/*/creative-plan.md - 创作计划
5. stories/*/tasks.md - 当前任务
6. spec/tracking/character-state.json - 角色状态
7. spec/tracking/relationships.json - 关系网络

**逻辑**：没有这些文件，AI不知道：

• 要遵循什么原则
• 故事是关于什么的
• 当前写到哪里了
• 角色是谁、什么状态

可选文件（缺失时警告但允许继续）

2. memory/style-reference.md - 风格参考
8. spec/tracking/plot-tracker.json - 情节追踪
9. spec/tracking/validation-rules.json - 验证规则

**逻辑**：这些文件增强质量，但不是最低要求：

• style-reference：某些用户不用/book-internalize
• plot-tracker：简单故事可能不需要
• validation-rules：非必需的自动化

---

防失焦机制

问题场景

第1章写作：
- AI记得所有设定
- 质量很好

第10章写作：
- 对话已经很长
- AI开始遗忘第1章的设定

第30章写作：
- 完全忘记早期设定
- 角色性格走样
- 情节自相矛盾

解决机制

每次写作前：
- 强制重读所有核心文件
- 重新加载完整context
- 像写第1章一样对待第30章

结果：
- 第30章质量 ≈ 第1章质量
- 一致性保持
- 不再失焦

效果对比

| 对比维度 | 无检查清单 | 有检查清单 | |---------|----------|----------| | 第1-10章 | ✓ 质量好 | ✓ 质量好 | | 第11-30章 | ⚠️ 开始不稳定 | ✓ 保持稳定 | | 第31-50章 | ❌ 明显失焦 | ✓ 依然稳定 | | 第51+章 | ❌ 严重失焦 | ✓ 长期稳定 |

---

配置选项

调整严格度

**默认：严格模式**（推荐）

"使用严格检查清单模式"
→ 缺少必需文件则阻止写作

**宽松模式**（不推荐）

"使用宽松检查清单模式"
→ 允许跳过部分文件（不推荐，可能失焦）

自定义检查项

如果你有额外的重要文件：

"检查清单请额外包含：
- spec/knowledge/worldbuilding/magic-system.md
- spec/knowledge/characters/protagonist-profile.md"

---

性能优化

Token消耗

每次写作的额外token成本：

9个文件读取：
- constitution.md：~200 tokens
- specification.md：~500 tokens
- creative-plan.md：~300 tokens
- tasks.md：~150 tokens
- character-state.json：~200 tokens
- relationships.json：~150 tokens
- 其他：~200 tokens

总计：约1700 tokens/次写作

收益：
- 避免失焦导致的重写（节省数万tokens）
- 保持质量一致（用户满意度）
- 长篇项目的可持续性

**ROI极高**：1700 tokens换来长期稳定质量。

缓存策略

同一写作会话中：
第1次写作：读取所有文件（1700 tokens）
第2次写作（1小时内）：检查文件是否修改
- 未修改：使用缓存（0 tokens）
- 已修改：重新读取（部分tokens）

---

常见问题

Q: 每次写作都要读这么多文件，会不会很慢？

**A**: 不会。

• 文件读取很快（毫秒级）
• token消耗合理（~1700 tokens）
• 换来的是长期质量保证

**对比**：

• 不用检查清单：第30章质量差 → 用户要求重写10章 → 浪费数万tokens
• 用检查清单：每章+1700 tokens → 50章也只+85000 tokens → 但质量稳定

Q: 我能跳过检查清单吗？

**A**: 技术上可以，但**强烈不推荐**。

"跳过检查清单，直接写作"
→ AI会警告："不推荐，可能导致失焦"
→ 但