pre-write-checklist

執筆前の必須チェックリスト

コア機能

AIが長編で焦点を失う問題を解決 — これがNovel Writer Skills v1.0のコアとなる革新です。

問題の根本原因

ユーザーからのフィードバック：novel-writerを使って創作すると、最初の30章は品質が高いものの、30章を過ぎるとAIは次のような状態になります：

• 前の内容で設定したことを忘れる
• 登場人物の性格に一貫性がなくなる
• 筋書きが重複したり、矛盾したりする
• 創作憲法の原則を無視する

根本原因：長い会話によってAIは初期のコンテキストを忘れてしまいます。specification.mdをどれだけ詳細に記述しても、忘れられてしまいます。

解決策

執筆前に毎回、重要なファイルをすべて強制的に再読する → AIが完全なコンテキストを再読み込みする → 一貫性を保つ

---

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成本：

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トークンで、長期にわたる安定した品質が得られます。

キャッシュ戦略

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

---

よくある質問

Q: 執筆のたびにこれほど多くのファイルを読む必要がありますが、時間がかかりませんか？

A: かかりません。

• ファイルの読み込みは非常に高速です（ミリ秒単位）
• トークン消費量も妥当です（約1700トークン）
• その代わり、長期にわたる品質が保証されます

比較：

• チェックリストを使わない場合：第30章の品質が低下 → ユーザーが10章分の書き直しを要求 → 数万トークンを浪費
• チェックリストを使う場合：各章につき+1700トークン → 50章でも合計+85000トークン → ただし品質は安定

Q: チェックリストをスキップできますか？

A: 技術的には可能ですが、強くおすすめしません。

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

結果は自己責任です：30章を過ぎて焦点を失っても、忠告しなかったとは言わないでください😊

Q: どうしても持っていないファイルがある場合はどうすればよいですか？

A: 2つのケースに分かれます：

必須ファイルがない場合（constitution、specificationなど）： → 執筆を阻止し、まず対応するコマンドを実行して作成するよう案内します

任意ファイルがない場合（style-reference、plot-tracker）： → 警告しますが続行できます。後で作成することをおすすめします

Q: チェックリストとsetting-detectorの関係は？

A: 相互に補完します：

pre-write-checklist：
- 加载项目特定文件（你的故事数据）

setting-detector：
- 加载通用知识库（类型惯例、写作技巧）

两者结合 = 完整context：
你的故事设定 + 类型专业知识

Q: 100章の長編小説でも、毎回読み込む必要がありますか？

A: はい、しかもより必要です。

长篇小说的挑战：
- 设定更复杂
- 角色更多
- 情节线更多
- AI更容易忘记

检查清单的作用：
- 确保第100章和第1章质量一致
- 防止角色性格突变
- 防止情节自相矛盾

这是长篇小说质量保证的基石。

---

ベストプラクティス

1. ファイルを最新の状態に保つ

チェックリストで保証できるのはAIがファイルを読み込むことだけです。ファイルの内容は正確に保つ必要があります：

✓ 角色状态变化 → 更新 character-state.json
✓ 关系变化 → 更新 relationships.json
✓ 新情节线 → 更新 plot-tracker.json

2. /track を定期的に実行する

建议频率：每5-10章运行一次 `/track`
作用：
- 更新tracking文件
- 验证一致性
- 发现潜在问题

3. 重要な変更後に手動で実行する

如果你手动修改了关键文件：
"请重新执行检查清单，重新加载所有文件"

确保AI看到最新状态。

4. consistency-checkerと併用する

pre-write-checklist（写前）：
- 加载所有context
- 准备写作

consistency-checker（写中/写后）：
- 监控一致性
- 发现矛盾

二重の保証 = 最高の品質。

---

技術的な実装

ファイルの読み込み順序

优先级排序（重要的先读）：
1. constitution（最高原则）
2. specification（故事核心）
3. creative-plan（技术方案）
4. tasks（当前任务）
5. character-state（角色数据）
6. relationships（关系数据）
7. plot-tracker（情节追踪）
8. validation-rules（验证规则）
9. style-reference（风格参考）

エラー処理

文件不存在：
→ 必需文件：阻止写作，提示创建
→ 可选文件：警告，允许继续

文件格式错误：
→ JSON解析失败：显示错误，建议修复
→ Markdown格式问题：尽力读取，标记问题

文件过大：
→ 超过10000行：警告（可能影响性能）
→ 建议拆分文件

---

まとめ

pre-write-checklistはNovel Writer Skills v1.0のコアとなる革新です：

✓ AIが長編で焦点を失う問題を解決 ✓ 重要なファイルを強制的に再読 ✓ コンテキストの完全性を確保 ✓ 長期にわたって安定した品質を維持 ✓ プロの作家による長編の創作に最適

30章を過ぎても焦点を失わない = 長期的な競争力 🎯

---

このSkillのバージョン: v1.0 最終更新日: 2025-10-18 解決する課題: 30章を過ぎた後にAIが焦点を失う問題 連携先: write.md, setting-detector, consistency-checker