muse-agent-example/docs/write-chapter/step2_setup_chapter3.py
zizi 091b66a9bb 重构: 收敛 Agent/Skill 运行时与创作质量闭环
将角色与 Skill 从 .claude 迁入 .agent,移除 Claude CLI 运行时并接入固定 Opus 角色 profile、完整 schema、预算 deadline、raw 与回执证据链。

同步拆分 Skill 职责、复利 lesson、Gate 回放、Dashboard 人审入口、数据库登记和机械门禁;候选设计正文不包含在本提交中。
2026-08-22 02:12:32 +08:00

109 lines
6.8 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

#!/usr/bin/env python3
"""真写一章 · 阶段二前置:建第 3 章 + 章级细纲(规划落库)。
镜像 step2_setup_chapter2.py 的建章 + persist_planning 模式。第 3 章细纲接第 2 章
结尾硬钩子(「茧」自己撕开舱门出击、裴朔下达出击授权、它要吃掉更强的核心),按
总纲「机甲养成升级线 + 污染不可逆」展开:首次实战、吞食更强异种核心完成第一次
升级、链接加深、污染同步恶化、脑内声音与林深自我边界开始模糊。
细纲 payload 形状与第 2 章一致(合同形状):
- 合同四件套(sourceRef/hardConstraints/adjustableBeats/declaredNewFacts)满足
assemble 的 _outline_contract 与 WriterContext 严格校验;declaredNewFacts 是
{factId,text,sourceRef} 对象。
- chapterGoal/keyEvents/mustAppearEntities/chapterEndHook 是规划侧字段,assemble 会裁剪,
留给人工审查与机械门的锚点映射。
- entities 供 build_retrieval_plan 生成检索查询(新书无卡,检索会诚实返空)。
"""
import sys
from pathlib import Path
SCRIPT_DIR = Path(__file__).resolve().parent
PLANNING_SCRIPTS = SCRIPT_DIR.parents[1] / ".agent" / "skills" / "plan-story" / "scripts"
if str(PLANNING_SCRIPTS) not in sys.path:
sys.path.insert(0, str(PLANNING_SCRIPTS))
from muse_db import connect # noqa: E402
from persist_planning import write_section, confirm_section # noqa: E402
WORK_ID = 12
CHAPTER3_TITLE = "进食"
FINE_OUTLINE_PAYLOAD = {
"targetChapter": 3,
"targetChars": 4000,
"chapterGoal": ("「茧」撕开舱门出击后的首次实战。林深驾驶茧拦截一头更强的异种,"
"在近乎被压制的搏杀中,茧吞食了它的异种核心,完成第一次升级;"
"链接随之加深,林深获得跨层感知(能直接'读'深渊的波纹),"
"代价是污染不可逆地恶化——左眼黑纹继续扩散,脑内的声音越来越像"
"他自己,人与机甲、与异种之间的边界开始模糊。"),
"hardConstraints": [
"衔接第2章结尾:茧未经弹射自行撕开实验舰外舱门出击,裴朔已下出击授权,机甲饥饿直接、没有谎言,目标是吃掉一个更强的核心。",
"首次实战对象是一个比第1章杂兵更强的异种单位;搏杀有真实的压制与险情,不是碾压。",
"茧通过吞食更强异种核心完成第一次升级,链接加深,林深获得新的感知或力量(升级线落地,不只是变强数字)。",
"污染随这次吞食不可逆加深:左眼黑纹扩散,脑内声音与林深的自我边界模糊(他开始分不清哪个念头是自己的)。",
"舰队在后方通过链路监控这次出击,裴朔/何岚至少一方观察到茧的异常成长与林深的污染读数。",
"章末钩子:升级后的茧/林深引来了深渊更深处的注意,或核心指向下一个更强的猎物——饥饿没有止境。",
],
"keyEvents": [
{"id": "event-1", "order": 1, "event": "茧冲入战场锁定更强异种,交手即被压制",
"participants": ["林深", "生物机甲茧"], "trigger": "茧循饥饿扑向更强核心",
"resultDirection": "暴露升级前的不足,陷入险境"},
{"id": "event-2", "order": 2, "event": "链接加深,林深首次主动读到深渊波纹找到破局点",
"participants": ["林深", "生物机甲茧"], "trigger": "搏杀逼迫人机链接深入",
"resultDirection": "扭转战局,污染随之加深"},
{"id": "event-3", "order": 3, "event": "茧吞噬异种核心完成第一次升级",
"participants": ["生物机甲茧"], "trigger": "异种被击败、核心暴露",
"resultDirection": "机体与感知同时蜕变,升级线落地"},
{"id": "event-4", "order": 4, "event": "污染恶化,脑内声音与林深边界模糊",
"participants": ["林深"], "trigger": "吞食更强核心使链接与污染同步加深",
"resultDirection": "林深分不清是谁在渴望,不可逆"},
{"id": "event-5", "order": 5, "event": "舰队侧观察到异常成长与污染读数",
"participants": ["裴朔"], "trigger": "链路监控回传升级与污染数据",
"resultDirection": "埋下后续裁决伏笔"},
],
"adjustableBeats": [
"搏杀的具体战术与险情设计可调整(须有真实压制,不许写成碾压)。",
"升级获得的具体能力可调整(须是'感知/链接'向,服务于深渊设定,不凭空给战力)。",
"舰队侧观察的视角(裴朔或何岚)与比重可调整。",
],
"declaredNewFacts": [
{"factId": "fact-ch3-1",
"text": "茧吞食更强异种核心即可升级:机体蜕变、链接加深,林深获得跨层感知,能直接读取深渊波纹。",
"sourceRef": {"sourceId": "outline:volume_1", "sourceVersion": "v1"}},
{"factId": "fact-ch3-2",
"text": "污染随每次吞食不可逆加深:左眼黑纹扩散,脑内声音与林深自我边界模糊,人与机甲、异种的界限开始溶解。",
"sourceRef": {"sourceId": "outline:volume_1", "sourceVersion": "v1"}},
],
"mustAppearEntities": ["林深", "生物机甲茧", "裴朔"],
"chapterEndHook": ("升级完成的茧在深空中安静下来,饥饿却没有消失。林深'听'见深渊"
"更深处有什么东西回应了这次的进食——更大的核心,更深的召唤。"
"它要的从来不止这一顿。"),
"sourceRef": {"sourceId": "outline:volume_1", "sourceVersion": "v1"},
"entities": [
{"id": "entity-ch3-char-linshen", "type": "character", "name": "林深"},
{"id": "entity-ch3-char-peishuo", "type": "character", "name": "裴朔"},
{"id": "entity-ch3-item-cocoon", "type": "item", "name": "生物机甲茧"},
{"id": "entity-ch3-loc-deepspace", "type": "location", "name": "深空战场"},
],
}
def main():
with connect() as conn:
chapter_id = conn.execute(
"INSERT INTO muse_content_chapter(work_id, title, order_no, status, revision, "
"creator, updater) VALUES (%s,%s,3,'draft',1,'setup','setup') RETURNING id",
(WORK_ID, CHAPTER3_TITLE)).fetchone()[0]
print(f"建第 3 章: id={chapter_id} 《{CHAPTER3_TITLE}》")
conn.commit()
fine = write_section(WORK_ID, section_type="fine_outline", schema_type="fine_outline",
target_chapter=3, payload=FINE_OUTLINE_PAYLOAD)
confirm_section(fine["id"])
print(f"第3章细纲: section id={fine['id']} → confirmed")
print(f"\nCHAPTER3_ID={chapter_id}\nFINE_SECTION_ID={fine['id']}")
if __name__ == "__main__":
main()