Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →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
.claude/skills/microck-pre-write-checklist/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-01 | ✗→✓ | ▲ Improved | 180% | 0% |
| case-02 | ✗→✓ | ▲ Improved | 331% | 0% |
| case-03 | ✗→✓ | ▲ Improved | 249% | 0% |
| case-04 | ✗→✓ | ▲ Improved | 258% | 0% |
| case-05 | ✗→✓ | ▲ Improved | 319% | 0% |
解决AI长篇失焦问题 - 这是Novel Writer Skills v1.0的核心创新。
用户反馈：使用novel-writer创作，前30章质量很好，但30章后AI开始：
根本原因：长对话导致AI遗忘早期context，即使specification.md写得再详细也会被忘记。
每次写作前强制重读所有关键文件 → AI重新加载完整context → 保持一致性
每次执行/write命令时，必须先完成此检查清单：
markdown📋 写作前检查清单（必须完成）： ✓ 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 - 验证规则（如有） 📊 上下文加载状态：✅ 完成
/write 命令用户: /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章...markdown📋 写作前检查清单（已完成）： ✓ 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章...
markdown📋 写作前检查清单（部分完成）： ✓ 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` 初始化完整追踪系统
markdown📋 写作前检查清单（失败）： ✓ 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的推荐流程。
/write 命令必须先执行检查清单，才能写作：
yaml执行顺序： 1. pre-write-checklist（本Skill）→ 读取所有文件 2. 输出确认报告 3. 检查setting-detector → 是否需要激活知识库 4. 开始实际写作
/analyze 命令分析时也建议执行检查清单：
yaml分析前先确保context完整： 1. pre-write-checklist → 重新加载所有文件 2. 基于最新状态执行分析
/track 命令追踪更新后触发检查清单：
yaml更新流程： 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 - 验证规则逻辑：这些文件增强质量，但不是最低要求：
第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 tokens换来长期稳定质量。
同一写作会话中：
第1次写作：读取所有文件（1700 tokens）
第2次写作（1小时内）：检查文件是否修改
- 未修改：使用缓存（0 tokens）
- 已修改：重新读取（部分tokens）A: 不会。
对比：
A: 技术上可以，但强烈不推荐。
"跳过检查清单，直接写作"
→ AI会警告："不推荐，可能导致失焦"
→ 但会尊重你的选择后果自负：30章后失焦了别说我没提醒你😊
A: 分两种情况：
必需文件缺失（constitution、specification等）： → 阻止写作，提示先运行对应命令创建
可选文件缺失（style-reference、plot-tracker）： → 警告但允许继续，建议后续创建
A: 互补工作：
pre-write-checklist：
- 加载项目特定文件（你的故事数据）
setting-detector：
- 加载通用知识库（类型惯例、写作技巧）
两者结合 = 完整context：
你的故事设定 + 类型专业知识A: 是的，而且更需要。
长篇小说的挑战：
- 设定更复杂
- 角色更多
- 情节线更多
- AI更容易忘记
检查清单的作用：
- 确保第100章和第1章质量一致
- 防止角色性格突变
- 防止情节自相矛盾
这是长篇小说质量保证的基石。检查清单只能确保AI读取文件，但文件内容要准确：
✓ 角色状态变化 → 更新 character-state.json
✓ 关系变化 → 更新 relationships.json
✓ 新情节线 → 更新 plot-tracker.json/track建议频率：每5-10章运行一次 `/track`
作用：
- 更新tracking文件
- 验证一致性
- 发现潜在问题如果你手动修改了关键文件：
"请重新执行检查清单，重新加载所有文件"
确保AI看到最新状态。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长篇失焦问题 ✓ 强制重读关键文件 ✓ 确保context完整性 ✓ 保持质量长期稳定 ✓ 适合专业作者长篇创作
30章后不再失焦 = 长期竞争力 🎯
本Skill版本: v1.0 最后更新: 2025-10-18 核心问题: 解决30章后AI失焦 配合: write.md, setting-detector, consistency-checker
| Case | Status | Duration (ms) | Turns | Tokens | Tool calls | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Without | With | Δ | Without | With | Δ | Without | With | Δ | Without | With | Δ | ||
case-07 | pass→pass | 6,672 | 9,131 | +37% | 1 | 1 | 0% | 1,119 | 5,122 | +358% | 0 | 0 | — |
case-01 | fail→pass | 11,405 | 8,033 | -30% | 1 | 1 | 0% | 1,761 | 4,934 | +180% | 0 | 0 | — |
case-02 | fail→pass | 7,118 | 8,717 | +22% | 1 | 1 | 0% | 1,157 | 4,986 | +331% | 0 | 0 | — |
case-03 | fail→pass | 10,524 | 10,004 | -5% | 1 | 1 | 0% | 1,503 | 5,242 | +249% | 0 | 0 | — |
case-04 | fail→pass | 9,376 | 8,524 | -9% | 1 | 1 | 0% | 1,387 | 4,965 | +258% | 0 | 0 | — |
case-05 | fail→pass | 7,357 | 6,710 | -9% | 1 | 1 | 0% | 1,128 | 4,729 | +319% | 0 | 0 | — |
case-06 | fail→pass | 8,905 | 5,490 | -38% | 1 | 1 | 0% | 1,350 | 4,636 | +243% | 0 | 0 | — |
case-08 | fail→pass | 14,518 | 12,189 | -16% | 1 | 1 | 0% | 2,221 | 5,648 | +154% | 0 | 0 | — |
case-09 | pass→pass | 12,471 | 10,753 | -14% | 1 | 1 | 0% | 2,021 | 5,400 | +167% | 0 | 0 | — |
case-10 | pass→pass | 13,162 | 7,073 | -46% | 1 | 1 | 0% | 2,129 | 4,724 | +122% | 0 | 0 | — |
case-11 | fail→pass | 6,347 | 7,715 | +22% | 1 | 1 | 0% | 1,070 | 4,783 | +347% | 0 | 0 | — |
case-12 | fail→fail | 9,745 | 10,658 | +9% | 1 | 1 | 0% | 1,373 | 5,160 | +276% | 0 | 0 | — |
case-13 | pass→pass | 8,741 | 8,804 | +1% | 1 | 1 | 0% | 1,337 | 5,022 | +276% | 0 | 0 | — |
case-14 | fail→pass | 13,199 | 13,486 | +2% | 1 | 1 | 0% | 2,211 | 5,881 | +166% | 0 | 0 | — |
case-15 | fail→pass | 12,367 | 9,829 | -21% | 1 | 1 | 0% | 1,937 | 5,249 | +171% | 0 | 0 | — |
case-16 | pass→pass | 13,517 | 13,153 | -3% | 1 | 1 | 0% | 1,938 | 5,518 | +185% | 0 | 0 | — |
case-17 | fail→pass | 4,822 | 5,011 | +4% | 1 | 1 | 0% | 835 | 4,444 | +432% | 0 | 0 | — |
case-18 | pass→pass | 10,643 | 4,404 | -59% | 1 | 1 | 0% | 1,567 | 4,332 | +176% | 0 | 0 | — |
case-19 | pass→pass | 5,982 | 6,382 | +7% | 1 | 1 | 0% | 931 | 4,715 | +406% | 0 | 0 | — |
case-20 | pass→pass | 9,033 | 8,196 | -9% | 1 | 1 | 0% | 1,436 | 4,843 | +237% | 0 | 0 | — |
case-21 | pass→pass | 6,791 | 10,206 | +50% | 1 | 1 | 0% | 1,050 | 5,107 | +386% | 0 | 0 | — |
case-22 | pass→pass | 21,193 | 21,447 | +1% | 1 | 1 | 0% | 3,055 | 6,488 | +112% | 0 | 0 | — |
DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 22 cases were attempted. The headline lift of +50 percentage points is the difference between those two pass rates over the 22 comparable cases.
Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.
Other measured skills in the registry, with their headline benchmark lift.