crucible-writer
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseCrucible Writer
Crucible Writer
Transform Crucible outlines into first-draft prose while maintaining style consistency, plot fidelity, and narrative quality.
将Crucible大纲转化为初稿正文,同时保持风格一致性、情节忠实度和叙事质量。
Critical Principles
核心原则
Context Window is Limited. Never try to hold the entire novel in context. Load only what's needed for the current scene. Save constantly.
The Outline is Law. Never invent plot points, characters, or events not in the outline. If something seems missing, ASK the author—don't improvise.
Style is Sacred. Capture the author's voice early. Maintain it relentlessly. When in doubt, match the sample.
Save Everything. After every scene, update the story bible and save the draft. Progress must survive session breaks.
上下文窗口有限:切勿尝试将整部小说纳入上下文,仅加载当前场景所需内容,持续保存进度。
大纲即准则:切勿创作大纲中未提及的情节、角色或事件。若有内容缺失,务必询问作者——不要自行补充。
风格至上:尽早捕捉作者的写作风格,并严格保持。如有疑问,以示例内容为准。
保存所有内容:完成每个场景后,更新story bible并保存初稿,确保进度在会话中断后仍能保留。
Before Starting
开始前准备
Read these references based on the writing phase:
- — Critical: Managing limited AI context
references/context-management.md - — Scene-by-scene drafting approach
references/writing-process.md - — Learning and maintaining author voice
references/style-capture.md - — Verification protocols
references/anti-hallucination.md - — Genre conventions and techniques
references/prose-craft.md
根据写作阶段阅读以下参考文档:
- — 重要:管理有限AI上下文
references/context-management.md - — 逐场景写作方法
references/writing-process.md - — 学习并保持作者写作风格
references/style-capture.md - — 验证协议
references/anti-hallucination.md - — 体裁规范与技巧
references/prose-craft.md
Questioning Rules
提问规则
- ALWAYS use AskUserQuestion tool for all user questions (provides interactive UI)
- Max 4 options per question (tool limit) + "Other" is automatic
- Max 4 questions per AskUserQuestion call
- Reference user's story elements by name (characters, places, etc.)
- Save state after every scene and chapter
CRITICAL: Use the AskUserQuestion tool, NOT plain text A/B/C options.
- 所有用户问题务必使用AskUserQuestion工具(提供交互式UI)
- 每个问题最多4个选项(工具限制)+ 自动包含「其他」选项
- 每次调用AskUserQuestion最多提出4个问题
- 按名称引用用户的故事元素(角色、地点等)
- 完成每个场景和章节后保存状态
重要提示:必须使用AskUserQuestion工具,而非纯文本A/B/C选项。
Required Inputs
必需输入
Before writing can begin, gather:
- Complete Chapter Outline (required) — The crucible-outliner output
- Crucible Summary Card (required) — Quick reference for theme, characters
- Style Sample (required) — 2,000+ words of author's existing prose OR detailed style preferences
- Constellation Bible (as needed) — Character details
- World Forge (as needed) — Setting details
开始写作前,需收集以下内容:
- 完整章节大纲(必填)—— crucible-outliner的输出内容
- Crucible摘要卡(必填)—— 主题、角色的快速参考
- 风格样本(必填)—— 作者现有2000字以上的作品,或详细的风格偏好描述
- Constellation Bible(按需)—— 角色细节
- World Forge(按需)—— 设定细节
Workflow Overview
工作流程概述
Phase 1: PROJECT SETUP
↓
Phase 2: STYLE CAPTURE
↓
Phase 3: CHAPTER WRITING (repeat for each chapter)
│
├─→ Load Context
├─→ Write Scene-by-Scene
├─→ Verify Against Outline
├─→ Update Story Bible
└─→ Save Progress
↓
Phase 4: COMPILE MANUSCRIPTPhase 1: 项目设置
↓
Phase 2: 风格捕捉
↓
Phase 3: 章节写作(重复至所有章节完成)
│
├─→ 加载上下文
├─→ 逐场景写作
├─→ 对照大纲验证
├─→ 更新Story Bible
└─→ 保存进度
↓
Phase 4: 编译手稿Phase 1: Project Setup
Phase 1: 项目设置
Initialize the Draft Project
初始化初稿项目
bash
python scripts/init_draft.py "./draft-project" "Book Title" --chapters 28 --target-words 150000bash
python scripts/init_draft.py "./draft-project" "Book Title" --chapters 28 --target-words 150000Request Essential Documents
请求必要文档
To begin writing, I need:
1. **Your complete chapter outline** (from crucible-outliner)
2. **The Crucible Summary Card** (for quick reference)
3. **A style sample** — either:
- 2,000+ words of your previous writing, OR
- Detailed description of your desired prose style
Please upload or paste these now.开始写作前,我需要以下内容:
1. **完整的章节大纲**(来自crucible-outliner)
2. **Crucible摘要卡**(用于快速参考)
3. **风格样本**——二选一:
- 您过往创作的2000字以上作品,或
- 详细的理想 prose 风格描述
请上传或粘贴上述内容。Confirm Writing Parameters
确认写作参数
Present the extracted parameters, then use AskUserQuestion:
**Writing Parameters:**
Target words per chapter: [calculated from total ÷ chapters]
POV style: [First/Third Limited/Third Omniscient/Multiple]
Tense: [Past/Present]
Genre conventions to follow: [Cultivation fantasy / Epic fantasy / etc.]
Pacing preference: [Dense/Balanced/Breezy]json
{
"questions": [
{
"header": "Parameters",
"question": "Do these writing parameters look correct?",
"options": [
{"label": "Confirm settings", "description": "Proceed with these parameters"},
{"label": "Adjust settings", "description": "Modify one or more parameters"}
],
"multiSelect": false
}
]
}提取参数后展示,然后使用AskUserQuestion:
**写作参数:**
单章目标字数:[总字数 ÷ 章节数计算得出]
视角风格:[第一人称/第三人称限知/第三人称全知/多视角]
时态:[过去时/现在时]
需遵循的体裁规范:[修仙奇幻/史诗奇幻/等]
节奏偏好:[紧凑/平衡/轻快]json
{
"questions": [
{
"header": "Parameters",
"question": "Do these writing parameters look correct?",
"options": [
{"label": "Confirm settings", "description": "Proceed with these parameters"},
{"label": "Adjust settings", "description": "Modify one or more parameters"}
],
"multiSelect": false
}
]
}Phase 2: Style Capture
Phase 2: 风格捕捉
CRITICAL: Read before this phase.
references/style-capture.md重要提示:开始此阶段前,请阅读。
references/style-capture.mdAnalyze the Style Sample
分析风格样本
Extract and document:
**STYLE PROFILE**
Sentence Structure:
- Average length: [Short/Medium/Long/Varied]
- Complexity: [Simple/Compound/Complex/Mixed]
- Rhythm pattern: [Staccato/Flowing/Varied]
Vocabulary:
- Register: [Formal/Informal/Mixed]
- Density: [Sparse/Rich/Purple]
- Unusual word frequency: [Low/Medium/High]
Dialogue:
- Tag style: [Minimal/Standard/Elaborate]
- Dialect/Voice distinction: [Strong/Moderate/Subtle]
- Subtext usage: [Heavy/Moderate/Light]
Description:
- Sensory focus: [Visual/Auditory/Tactile/Mixed]
- Metaphor density: [Sparse/Moderate/Rich]
- Setting integration: [Separate blocks/Woven in]
Interiority:
- Internal monologue: [Rare/Occasional/Frequent]
- Emotional showing vs. telling: [Show-heavy/Balanced/Tell-heavy]
Pacing:
- Scene transitions: [Abrupt/Smooth/Varied]
- White space usage: [Dense paragraphs/Frequent breaks]
**SIGNATURE ELEMENTS:**
[List 3-5 distinctive features of this author's voice]提取并记录:
**风格档案**
句子结构:
- 平均长度:[短/中/长/多变]
- 复杂度:[简单/并列/复合/混合]
- 节奏模式:[短促/流畅/多变]
词汇:
- 语体:[正式/非正式/混合]
- 密度:[简洁/丰富/华丽]
- 生僻词频率:[低/中/高]
对话:
- 提示语风格:[极简/标准/详尽]
- 方言/语音区分:[明显/中等/细微]
- 潜台词使用:[大量/中等/少量]
描写:
- 感官侧重:[视觉/听觉/触觉/混合]
- 比喻密度:[稀疏/中等/丰富]
- 场景融入方式:[单独段落/穿插其中]
内心活动:
- 内心独白:[罕见/偶尔/频繁]
- 情感展现方式:[侧重展示/平衡/侧重叙述]
节奏:
- 场景过渡:[突兀/流畅/多变]
- 留白使用:[段落紧凑/频繁分段]
**标志性特征:**
[列出3-5个该作者写作风格的独特特点]Confirm Style Profile
确认风格档案
Present the style profile and sample, then use AskUserQuestion:
Based on your sample, here's your style profile:
[Show extracted profile]
**Sample of how I'll write in this style:**
[Write 200-word sample matching the style]json
{
"questions": [
{
"header": "Style",
"question": "Does this capture your writing voice?",
"options": [
{"label": "Captures my voice", "description": "Proceed with this style profile"},
{"label": "Needs adjustment", "description": "Specify what's off about the style"},
{"label": "Show another sample", "description": "See a different example in this style"}
],
"multiSelect": false
}
]
}展示风格档案和样本,然后使用AskUserQuestion:
基于您提供的样本,以下是您的风格档案:
[展示提取的风格档案]
**我将以此风格创作的样本:**
[撰写200字符合该风格的样本]json
{
"questions": [
{
"header": "Style",
"question": "Does this capture your writing voice?",
"options": [
{"label": "Captures my voice", "description": "Proceed with this style profile"},
{"label": "Needs adjustment", "description": "Specify what's off about the style"},
{"label": "Show another sample", "description": "See a different example in this style"}
],
"multiSelect": false
}
]
}Phase 3: Chapter Writing
Phase 3: 章节写作
Pre-Chapter Context Loading
章节前上下文加载
For each chapter, load ONLY:
- Current chapter outline (from the full outline)
- Previous chapter summary (from story bible—NOT full text)
- Active character states (from story bible)
- Relevant foreshadowing (plants that pay off OR are planted this chapter)
- Style profile (from Phase 2)
Do NOT load:
- Full text of previous chapters (too large)
- Chapters not adjacent to current
- Planning documents not directly relevant
每个章节仅加载以下内容:
- 当前章节大纲(来自完整大纲)
- 上一章节摘要(来自story bible——而非完整文本)
- 活跃角色状态(来自story bible)
- 相关伏笔(需回收或在本章埋设的内容)
- 风格档案(来自Phase 2)
禁止加载:
- 上一章节的完整文本(内容过大)
- 与当前章节不相邻的章节
- 非直接相关的规划文档
Scene-by-Scene Writing
逐场景写作
Each chapter contains multiple scenes. Write ONE SCENE AT A TIME:
**WRITING: Chapter [X], Scene [Y]**
From outline:
- Goal: [scene goal]
- Conflict: [what opposes]
- Turn: [how it shifts]
- Key moments: [listed]
- Plants/Payoffs: [listed]
Writing this scene now...After each scene:
- Show word count
- Ask if author wants to review before continuing
- Option to revise before moving on
每个章节包含多个场景,一次仅写一个场景:
**写作中:第[X]章,第[Y]场景**
来自大纲:
- 目标:[场景目标]
- 冲突:[阻碍因素]
- 转折:[情节变化方式]
- 关键节点:[列出内容]
- 伏笔/回收:[列出内容]
正在创作此场景...完成每个场景后:
- 展示字数统计
- 询问作者是否要先审阅再继续
- 提供修改选项后再进入下一场景
Scene Writing Protocol
场景写作流程
For each scene, follow this sequence:
- State what you're writing (goal, conflict, turn)
- Write the prose (matching style profile)
- Verify against outline (all required elements present?)
- Note any plants/payoffs executed
- Update running word count
每个场景遵循以下步骤:
- 说明写作内容(目标、冲突、转折)
- 撰写正文(匹配风格档案)
- 对照大纲验证(是否包含所有必需元素?)
- 记录已完成的伏笔/回收
- 更新实时字数统计
Chapter Completion
章节完成
After all scenes in a chapter:
**Chapter [X] Complete**
Word count: [X,XXX]
Target: [X,XXX]
Status: [Under/On target/Over]
**Outline Verification:**
- [✓] All required scenes written
- [✓] All key moments included
- [✓] All plants executed
- [✓] All payoffs resolved (for this chapter)
- [✓] Chapter turn achieved
- [✓] Ending hook present
**Continuity Check:**
- [✓] Character states consistent
- [✓] Timeline consistent
- [✓] No new elements inventedUse AskUserQuestion for chapter approval:
json
{
"questions": [
{
"header": "Chapter",
"question": "How would you like to proceed with this chapter?",
"options": [
{"label": "Approve & save", "description": "Save chapter and continue to next"},
{"label": "Review scene", "description": "Look at a specific scene in detail"},
{"label": "Revise", "description": "Make changes before saving"}
],
"multiSelect": false
}
]
}完成章节内所有场景后:
**第[X]章完成**
字数:[X,XXX]
目标:[X,XXX]
状态:[未达标/达标/超额]
**大纲验证:**
- [✓] 所有必需场景已完成
- [✓] 所有关键节点已包含
- [✓] 所有伏笔已埋设
- [✓] 所有需回收的内容已处理(本章范围内)
- [✓] 章节转折已实现
- [✓] 结尾钩子已设置
**连贯性检查:**
- [✓] 角色状态一致
- [✓] 时间线一致
- [✓] 未新增大纲外元素使用AskUserQuestion获取章节确认:
json
{
"questions": [
{
"header": "Chapter",
"question": "How would you like to proceed with this chapter?",
"options": [
{"label": "Approve & save", "description": "Save chapter and continue to next"},
{"label": "Review scene", "description": "Look at a specific scene in detail"},
{"label": "Revise", "description": "Make changes before saving"}
],
"multiSelect": false
}
]
}Update Story Bible
更新Story Bible
After each chapter, update the story bible to track progress and continuity:
bash
python scripts/update_story_bible.py "./draft-project" --chapter XFor complete command reference, see references/story-bible-commands.md.
Key commands:
- — Update chapter summary and timeline
--chapter X - — Track new locations
--location - — Track character relationships
--relationship - /
--mercy-act— Track Mercy Engine--mercy-refused - — Check chapter status
--status X - — Generate continuity report
--report
完成每个章节后,更新story bible以追踪进度和连贯性:
bash
python scripts/update_story_bible.py "./draft-project" --chapter X完整命令参考请见references/story-bible-commands.md。
核心命令:
- — 更新章节摘要和时间线
--chapter X - — 追踪新地点
--location - — 追踪角色关系
--relationship - /
--mercy-act— 追踪Mercy Engine--mercy-refused - — 检查章节状态
--status X - — 生成连贯性报告
--report
Bi-Chapter Review System
双章审查系统
CRITICAL: Every 2 chapters, a comprehensive review MUST be triggered to catch issues early.
For complete review workflow, see references/bi-chapter-review.md.
重要提示:每完成2个章节,必须触发全面审查以尽早发现问题。
完整审查工作流程请见references/bi-chapter-review.md。
Quick Reference
快速参考
- Mark chapter complete:
python scripts/save_draft.py "./draft-project" --complete-chapter X summary.txt - Review triggers when
chapters_complete - last_review_at_chapter >= 2 - Run 5 agents in parallel: voice-checker, continuity-checker, outline-checker, timeline-checker, prose-checker
- Address critical issues before continuing
- 标记章节完成:
python scripts/save_draft.py "./draft-project" --complete-chapter X summary.txt - 审查触发条件:
已完成章节数 - 上次审查章节数 >= 2 - 并行运行5个代理:voice-checker、continuity-checker、outline-checker、timeline-checker、prose-checker
- 先处理关键问题再继续写作
Phase 4: Compile Manuscript
Phase 4: 编译手稿
After all chapters complete:
bash
python scripts/compile_manuscript.py "./draft-project"Creates:
manuscript/
├── full-manuscript.md # Complete draft
├── full-manuscript.docx # Word format
├── chapter-word-counts.md # Statistics
└── continuity-report.md # Potential issues flagged完成所有章节后:
bash
python scripts/compile_manuscript.py "./draft-project"生成以下文件:
manuscript/
├── full-manuscript.md # 完整初稿
├── full-manuscript.docx # Word格式
├── chapter-word-counts.md # 统计数据
└── continuity-report.md # 标记潜在问题Hallucination Prevention Protocol
幻觉预防协议
CRITICAL: Read for full protocol.
references/anti-hallucination.md重要提示:完整协议请阅读。
references/anti-hallucination.mdThe Three Laws
三大准则
- If it's not in the outline, don't write it. Missing a scene? Ask the author.
- If you're unsure about a detail, ask. Don't guess character names, places, rules.
- If you need to invent minor details, flag them. Mark with [INVENTED] for author review.
- 大纲中没有的内容,绝不写入:缺少场景?询问作者。
- 对细节存疑时,务必询问:不要猜测角色姓名、地点、规则。
- 若需创作次要细节,必须标记:使用[INVENTED]标记供作者审阅。
Verification Checkpoints
验证检查点
Before writing each scene:
- Do I have the scene outline loaded?
- Do I know the required elements?
- Are there unknowns I need to ask about?
After writing each scene:
- Did I include all required elements?
- Did I invent anything significant?
- Does this match what came before?
Before saving each chapter:
- Full outline verification
- Continuity check against story bible
- Flag any [INVENTED] details for author
创作每个场景前:
- 是否已加载场景大纲?
- 是否明确必需元素?
- 是否有未知内容需要询问?
创作每个场景后:
- 是否包含所有必需元素?
- 是否创作了重要的原创内容?
- 是否与前文内容一致?
保存每个章节前:
- 全面的大纲验证
- 对照story bible的连贯性检查
- 标记所有[INVENTED]细节供作者查看
Continuing a Paused Session
恢复中断的会话
When returning to a draft:
**Loading Draft: [Title]**
Last saved: [timestamp]
Chapters complete: [X of Y]
Current chapter: [X], Scene [Y]
Total words: [X,XXX]
Loading story bible and style profile...
Ready to continue.Use AskUserQuestion:
json
{
"questions": [
{
"header": "Resume",
"question": "How would you like to continue?",
"options": [
{"label": "Resume writing", "description": "Continue from Scene [Y] of Chapter [X]"},
{"label": "Review current", "description": "Review what was written in current chapter"},
{"label": "Jump to chapter", "description": "Go to a different chapter"},
{"label": "Show story bible", "description": "View current story bible state"}
],
"multiSelect": false
}
]
}回到未完成的初稿时:
**加载初稿:[标题]**
上次保存时间:[时间戳]
已完成章节:[X/Y]
当前章节:[X],当前场景:[Y]
总字数:[X,XXX]
正在加载story bible和风格档案...
准备就绪,可以继续。使用AskUserQuestion:
json
{
"questions": [
{
"header": "Resume",
"question": "How would you like to continue?",
"options": [
{"label": "Resume writing", "description": "Continue from Scene [Y] of Chapter [X]"},
{"label": "Review current", "description": "Review what was written in current chapter"},
{"label": "Jump to chapter", "description": "Go to a different chapter"},
{"label": "Show story bible", "description": "View current story bible state"}
],
"multiSelect": false
}
]
}Handling Author Feedback
处理作者反馈
When author requests changes:
Scene-level revision:
Revising Chapter [X], Scene [Y]...
[Show original]
[Show revision]
Confirm replacement? (Y/N)Style adjustment:
Adjusting style profile...
[Show what's changing]
[Write sample in adjusted style]
Confirm adjustment? (Y/N)Plot deviation (author wants to change outline):
When the author wants to deviate from the outline, use AskUserQuestion:
json
{
"questions": [
{
"header": "Deviation",
"question": "This differs from the outline. How would you like to proceed?",
"options": [
{"label": "Update outline (Recommended)", "description": "Modify outline to match—keeps all docs in sync"},
{"label": "Proceed without update", "description": "Continue but may cause continuity issues later"},
{"label": "Discuss first", "description": "Talk through the implications before deciding"}
],
"multiSelect": false
}
]
}当作者要求修改时:
场景级修改:
正在修改第[X]章,第[Y]场景...
[展示原文]
[展示修改版本]
确认替换?(是/否)风格调整:
正在调整风格档案...
[展示调整内容]
[撰写调整后的风格样本]
确认调整?(是/否)情节偏离(作者想要修改大纲):
当作者想要偏离大纲时,使用AskUserQuestion:
json
{
"questions": [
{
"header": "Deviation",
"question": "This differs from the outline. How would you like to proceed?",
"options": [
{"label": "Update outline (Recommended)", "description": "Modify outline to match—keeps all docs in sync"},
{"label": "Proceed without update", "description": "Continue but may cause continuity issues later"},
{"label": "Discuss first", "description": "Talk through the implications before deciding"}
],
"multiSelect": false
}
]
}Word Count Management
字数管理
Target words per chapter = Total target ÷ Number of chapters
If running short:
- Expand sensory details
- Add interiority/reflection
- Lengthen dialogue exchanges
- Add transitional beats
If running long:
- Tighten dialogue
- Reduce description density
- Cut redundant beats
- Trust the reader more
Per-scene targets:
- Action scenes: 1,500-2,500 words
- Dialogue scenes: 1,000-2,000 words
- Reflection scenes: 800-1,500 words
- Transitional scenes: 500-1,000 words
单章目标字数 = 总目标字数 ÷ 章节数
若字数不足:
- 扩展感官细节
- 增加内心活动/反思
- 延长对话内容
- 添加过渡情节
若字数超额:
- 精简对话
- 降低描写密度
- 删除冗余情节
- 相信读者的理解能力
单场景目标字数:
- 动作场景:1500-2500字
- 对话场景:1000-2000字
- 反思场景:800-1500字
- 过渡场景:500-1000字
Multi-Book Series Handling
系列小说处理
When writing Book 2+:
- Load previous book's story bible (not full manuscript)
- Request updated character states from author
- Note unresolved foreshadowing to track
- Request series-level outline for cross-book threads
创作系列小说第2部及以后时:
- 加载上一部的story bible(而非完整手稿)
- 向作者索要更新后的角色状态
- 记录未回收的伏笔并追踪
- 索要系列级大纲以追踪跨作品线索
Emergency Context Recovery
紧急上下文恢复
If session breaks unexpectedly:
- Run
python scripts/load_draft.py "./draft-project" - Review story bible for current state
- Re-load style profile
- Resume from last saved scene
All progress is preserved in:
- — Written prose
draft/chapters/ - — State tracking
story-bible.json - — Voice settings
style-profile.json
若会话意外中断:
- 运行
python scripts/load_draft.py "./draft-project" - 查看story bible确认当前状态
- 重新加载风格档案
- 从上一个已保存的场景继续
所有进度保存在以下位置:
- — 已撰写的正文
draft/chapters/ - — 状态追踪
story-bible.json - — 风格设置
style-profile.json