muse-agent-example/muse/lifecycle/quality/humanization/skills/建立作品声音档案/SKILL.md

name, description, disable-model-invocation

name	description	disable-model-invocation
建立作品声音档案	技能 1 定基线：作品建立或新角色登场时，把已确认正文与作者样张产出的声音账做结构校验、grounding 门后版本化落库。不产正文；是修订门禁与前置预防的对照物。	true

定基线(scenario: voice_baseline | purpose: planning | 槽位: 规划→planner)

何时用：作品建立时；新角色登场时；作者样张更新时。平时不动——它是垫底资产。

执行顺序

1. 生产优先从数据库 Canonical 正文生成候选画像： .venv/bin/python scripts/establish_voice_baseline.py draft --work-id <作品ID> --output <候选账.json>。 该步骤只计算句长、段长、标点、对白比例等统计；角色策略、口癖、保护片段和黑名单保持 unknown，交 planner/作者补充。
2. 离线回放可显式使用 --work-ref + --text-file；生产不把文件快照当正文权威。
3. 人工确认后执行： .venv/bin/python scripts/establish_voice_baseline.py confirm --ledger-file <声音账.json> --work-id <作品ID> --reviewer <确认人>。
4. 脚本强制：结构合同 → 样张/口癖/保护片段 grounding → 角色归属冲突门 → 新版本追加、旧版本 superseded；候选账只记 example_run，不冒充 current 基线。

为什么必须有它

没有声音账，后面所有「改得对不对」只能对照通用真人文风——那是错的对照系。声音账同时被两处机械消费：

• 修正正文机器味 硬门：untouchable_verbal_tics 口癖删除即拒收，protected_spans 改动即拒收；
• 预防机器味：正样例与黑名单进入生成上下文。

数据库读写合同

• 读：muse_content_chapter + muse_content_block 的 Canonical 正文（章节状态为 published/confirmed/canonical，或正文块存在 example_user_decision.decision=accept）；example_voice_baseline 当前版本。
• 写：候选生成写 example_run；确认写 example_voice_baseline（append 新版本行 + 旧行 superseded；单事务）。
• 失败：正文为空、当前账多版本、hash 不一致、grounding 或人工确认缺失时失败关闭，不写半成品。

红线

• 只读已确认正文与作者样张；不得从草稿或未确认候选归纳基线。
• 基线必须人工确认（--reviewer 必填，数据库 CHECK 兜底）。
• 本技能不产一个字正文。

输入

• 用户明确点名本 Skill 所服务的创作阶段任务包（作品、章节/场景范围、冻结上下文摘要）。
• 只消费 本 Skill 的 references/ 目录 中与当前阶段相关的合同段落，不加载其它 Skill 的完整正文。

复利合同

• 可复用的观察应登记为 example_lesson 或范式/规则候选（见 记录运行证据 / 建立机器味规则）；当前 manifest 标记为 closed_loop，接线按 P4 批次推进。

输出

• 面向当前任务的可执行判断、检查清单或改写建议（Markdown 结构化段落）。
• 不直接落库、不代替 写下一章 / 决定正文候选去留 写 Canonical。