chapter-room

name	chapter-room
description	根据 published views 与 chapter planning source 生成章节 proposal；必要时调用 discussion agents，并通过 confirm-stage chapter_planning 生效。Use when chapter_planning is ready or a chapter plan needs revision.
argument-hint	<project-id> [chapter-id] [plan-source-path] [proposal-scope]
disable-model-invocation	false

章节规划

参数

• $0：project_id
• $1：可选，chapter_id，默认 ch001
• $2：可选，chapter_plan_source 路径；为空时默认使用 projects/$0/chapters/${1:-ch001}/chapter_plan_source.json
• $3：可选，proposal_scope，默认 bundle；可选 alignment / bundle / outline-patch

执行步骤

1. 先运行 python app.py ensure-prereq "$0" chapter_planning --chapter-id "${1:-ch001}"。
2. 如果本轮是新规划或用户需求还未结构化，先让 chapter-requirement-analyst 收口 user_intent_summary、must_hit_events、must_keep_constraints、ending_hook_options。
3. 再让 chapter-architect 基于 story_view、progression_view、authoring_view、recent_summary 与需求摘要产出 proposal-only chapter_plan_source 字段；已有方案回修统一交给 plan-reviser 输出 field patch 与建议 proposal_scope。
4. 整理或更新 projects/$0/chapters/${1:-ch001}/chapter_plan_source.json，并保留 source_discussion_ref、revision_notes、planning_trace。
5. 运行 python app.py chapter-room "$0" --chapter-id "${1:-ch001}" --plan-source "${2:-projects/$0/chapters/${1:-ch001}/chapter_plan_source.json}" --proposal-scope "${3:-bundle}" 生成章节 proposal。
6. 读取 projects/$0/workflow/pending_confirmations/chapter_planning_${1:-ch001}.json，先核对 planning_manifest.json、chapter_plan_source.json 与 chapter_alignment_card.json，再核对 chapter_goal.json 与 chapter_outline.json；必须显式检查 proposal_scope、chapter_plan_source_ready、chapter_projector_primary_source、chapter_template_fallback_used。
7. 只有在用户明确确认后，运行 python app.py confirm-stage "$0" chapter_planning --chapter-id "${1:-ch001}" --scope "${3:-bundle}"。
8. 读取 projects/$0/chapters/${1:-ch001}/planning_manifest.json、chapter_plan_source.json、chapter_goal.json 与 chapter_outline.json，确认 chapter contract 已进入正式态。
9. 返回中文摘要，并建议进入 /scene-room。

阶段产物契约

• 输入文件：projects/$0/published/effective_views/story_view.json、projects/$0/published/effective_views/progression_view.json、projects/$0/published/effective_views/authoring_view.json、projects/$0/logs/recent_summary.md、projects/$0/chapters/${1:-ch001}/chapter_plan_source.json 或用户提供的 plan source。
• 输出文件：先生成 projects/$0/workflow/pending_confirmations/chapter_planning_${1:-ch001}.json；只有在 confirm-stage 后，才正式落 projects/$0/chapters/${1:-ch001}/planning_manifest.json、chapter_plan_source.json、chapter_alignment_card.json、chapter_goal.json、chapter_outline.json。
• 禁止行为：不要跳过 chapter_alignment_card.json 直接下正式章纲；不要让 discussion agents 直接写正式 chapter_goal.json 或 chapter_outline.json；不要把自由文本讨论直接当 canonical contract；只使用 story_view、progression_view、authoring_view、recent_summary 和 chapter planning source 规划本章；不要回退到 source_assets/story_setup/story_core_asset.json 或 source_assets/authoring_setup/*.json；不要在 chapter_plan_source 已给出结构化决策时再覆盖回固定模板；不要直接进入 /scene-room。