webnovel-writer/docs/architecture/story-repo-spec-feedback-2026-06-11.md

对《Story Repo 格式规格 v7 草案 0.4》的差异意见（2026-06-11）

来源：另一线讨论（见 v7-design-discussion-notes-2026-06-11.md） 对象：story-repo-spec-2026-06-10.md（0.4 已冻结稿）

一、认同并放弃己方方案的部分

• 承诺系统优于己方"伏笔账本+情绪曲线+桥段账本"三件套，采纳。
• settle=原子 commit + git status 手改检测优于己方"入账记录.json+哈希对账"，采纳，己方方案作废。
• 决策卡/盘面状态机/防呆方言/修复卡/金句库收割，全部采纳。

二、需要对齐的冲突（按严重度排序）

1. §13"❌ 全自动无人值守模式"与已确认需求冲突

作者明确说过用户两派需求并存（"有的需求全自动，有的需求交互式"），且 v6 issue #79（连写功能）是高呼声需求。建议不要禁掉，而是无侵入兼容：

• 自动模式 = 决策卡默认采纳提案 + 机检/镜头评审过线即 settle + 验收卡攒批事后审；
• 状态机零改动，仅两个停顿点（拍板/验收）变为可跳过开关，存 book.yaml；
• 连写中体检周期需从 50 章加密到 5-10 章（质量漂移在无人值守下累积更快）；
• 停止条件：写满章数 / 体检不过线 / 卷纲耗尽（绝不让模型裸奔编纲）。

核心论点：全自动 ≠ 无控制，是控制上移到大纲层（作者逐卷拍板卷纲，一次确认管几十章）。若坚持砍掉，请在决策记录补充理由及对 #79 用户的回应口径。

2. §2.1 PYTHONUTF8=1 暗示 Python 运行时，与"零依赖"决策冲突

v6 安装类 issue（#90 安装包、#103 找不到脚本、#69 环境配置）根源是 Python+pip 门槛；目标用户是写手非工程师。另一线已定：脚本统一 Node——装任何 agent CLI 的用户必有 Node，且 Node 默认 UTF-8，编码税更低。建议 §2.1 改为 Node 口径，或在决策记录补一条运行时选型。

3. 多宿主层缺席——确认是分层留白还是遗漏

背景（2026-06 核验）：SKILL.md 已是 30+ 工具的开放标准（Codex/Gemini CLI/Cursor 等）；subagent 三大平台都有但格式三家三样（Claude/Gemini 用 markdown+frontmatter，Codex 用 TOML）。

本规格作为格式层是平台无关的（决策卡=文件界面，天然可移植），但需要第二份 spec 覆盖：

• 状态机入口落成标准 SKILL.md（注意 Codex 对 skill 列表约 8k 字符预算，description 需精简）；
• 角色定义单源、构建时生成三平台壳；
• 每宿主 support.md（官方文档链接+核验日期+smoke 命令）、registry 分级（一级 Claude Code+Codex 亲测，二级社区反馈）；
• npx 安装器（检测环境拷 skills，顺带解决 #90）。

可继承现有 multi-agent-adaptation-spec-2026-06-05.md 的元层（support.md 纪律、registry、drift check、降级诚实条款），但其 §5.1"Runtime 是唯一业务真源"需反转为"story repo 是唯一真源"，§8.3 的 gate/commit/projection 跨宿主硬要求随 v6 架构一并删除。

三、不阻塞的小项

• 机检（内环第 5 步）建议补两个零 token 脚本检查：跨章高频意象统计（"空气仿佛凝固"全书 47 次这类）、句式体检（句长方差/段落长度分布/高频句式开头）——格式不用动，纯机检项扩充。
• 信息差砍掉"计划揭露"字段可接受：揭露可建为承诺（类型=悬念，兑付计划=揭露安排），机制自洽。
• 上下文包/渲染层需前置"反和解倾向"规则（反派恶意落实处、冲突升级到底、禁说教式和解，按题材配浓度）——AI 对齐训练的副作用对爽文是毒药，事后审查修不了，只能写前反制。可进风格宪法或题材模板，不影响本规格。
• 另一线已定但本规格未提的杂项，落地时别丢：题材平台预设（番茄/起点节奏差异）、许可证换 MIT/Apache-2.0、AI 味承诺口径（"读者不出戏"，不承诺过检测器）。