@oh-story/dsh 0.1.14 → 0.1.16

package/lib/oh-story/skills/story-review/references/review-quality.md

@@ -10,14 +10,14 @@
 ## 一、通用检查
 
 ### 章节结构
-- [ ] 开头有钩子（不是天气/风景/日常开场）
+- [ ] 开头有具体人物、处境或问题形成钩子，日常开场也须有阅读理由
 - [ ] 中段有推进（快节奏题材要有可见事件；慢热题材状态变化即可）
 - [ ] 局势有变化（读完这章，世界跟之前不一样了）
 - [ ] 结尾落在变化上（不是总结）
 
 ### 开篇检查（前 300-500 字）
 - [ ] 有钩子，能抓住注意力
-- [ ] 不从天气/风景/日常开始
+- [ ] 天气、风景或日常若出现在开头，已与人物处境、麻烦或期待相连
 - [ ] 主角快速出场
 - [ ] 卖点或危机可见
 - [ ] 开局不与同题材默认套路撞车（有钩子≠不同质；能整体换到任意同类书就是同质化）
@@ -37,7 +37,7 @@
 - [ ] 场景有目标（人物要什么）
 - [ ] 场景有阻碍（什么挡着）
 - [ ] 场景有变化（结束后跟之前不同）
-- [ ] 人物在做事情，不是在感觉事情
+- [ ] 人物的行动、判断或情绪变化影响场景，不只重复感觉
 - [ ] 没有可删除的段落
 
 ### 章尾
@@ -50,7 +50,7 @@
 - [ ] 没有空洞的抒情段落
 - [ ] 没有连续多段同一情绪
 - [ ] 对话符合人物身份（不同人说话方式不同）
-- [ ] 标点节奏符合语气和人物声线：没有通篇句号化，也没有随机堆砌问号/感叹号；正文（含对话）不残留 `……`/`——`，迟疑或打断已改为动作、短句、逗号或句号
+- [ ] 标点节奏符合语气和人物声线：没有通篇句号化或随机堆砌问号/感叹号；`……`/`——` 按本书文风裁决，缺少功能的停顿再建议改为动作、短句、逗号或句号
 - [ ] 情绪词有落点（融进动作句、当对话提示语、结句后直接换事或接场内物件），不是接更多情绪
 - [ ] 标题行以外没有章节/写作元信息：不得出现 `第[一二三四五六七八九十百千万两0-9]+章|上一章|上章|前一章|本章|这一章|前文|后文|伏笔|细纲|读者` 这类词；需要承接前文时改成角色能感知的事件锚点或相对时间；故事内真实阅读/讨论“第X章”或真实读者身份语境除外
 
@@ -61,7 +61,7 @@
 - [ ] 故事引擎还在运转
 
 ### 水（filler）检测
-以下信号出现 = 可能水了：
+出现下列信号时，回查是否缺少信息、行动或关系变化：
 - 全章对话没有任何新信息
 - 同一个情绪写了 3 段以上
 - 场景描写超过 500 字但不推进剧情
@@ -96,8 +96,7 @@
 
 ### 五维评分标准
 
-每个维度 0-100 分，根据评分结果选择精修策略。
-严重度：critical、high＝必须修；medium＝建议看；low＝仅提示。
+每个维度按 0-100 分诊断薄弱处，再选精修策略。表中 critical、high 对应必须修，medium 对应建议看，low 对应仅提示；输出仍转为统一 Findings Schema。
 
 ### 维度 1：核心一致度
 检查：关键冲突、关键行动、人物动机是否前后一致。
@@ -110,7 +109,7 @@
 | 次要矛盾遗忘 | medium | 回收或弱化 |
 
 ### 维度 2：表层重写度
-检查：句式与措辞是否足够原创，避免套路化表达。
+检查：句式与措辞是否机械复用模板，影响本书声线。
 
 | 问题 | 严重度 | 修复 |
 |------|--------|------|
@@ -125,7 +124,7 @@
 | 问题 | 严重度 | 修复 |
 |------|--------|------|
 | 机械按字数切段或主语过密 | medium | 按戏剧单元重排段落，段首点名、段中代词/省略、关键转折再点名 |
-| 字数不在目标范围 | medium（长篇欠字交作者定）；短篇 **high** | 先核对情节点是否都写到；都写到就不为字数加戏。长篇欠字交作者选、超字最多净删一次；短篇整篇须进入锁定范围，缺情节点才补；去AI味已有正文时不得新增剧情 |
+| 字数不在目标范围 | medium（长篇带外交作者定）；短篇 **high** | 先核对情节点是否都写到；都写到就不为字数加戏。长篇欠字交作者选，超字最多净删一次后仍带外也交作者；短篇整篇须进入锁定范围，缺情节点才补；去AI味已有正文时不得新增剧情 |
 | 格式混乱（对话/描写不统一）| low | 统一格式 |
 
 ### 维度 4：可读性
@@ -151,14 +150,12 @@
 
 ### 精修策略
 
-根据五维评分结果，选择精修策略：
-
 | 主要问题 | 策略 | 说明 |
 |----------|------|------|
 | 核心一致度低 | rewrite | 围绕核心冲突重写相关段落 |
 | 字数超标 | compress | 删减不推动剧情的内容 |
 | 无意义卡点 | compress | 保留卡出的变化，压掉流程 |
-| AI 腔重 | de_ai | 替换禁用词、改写句式 |
+| AI 腔重 | de_ai | 按表达、用笔、故事三层定位，给出有依据的改法 |
 | 小问题多 | polish | 打磨语言细节 |
 
 ### 读者契约审查
@@ -175,7 +172,7 @@
 
 ### 虐爽节奏检查
 
-短篇特有的检查项——虐点和爽点的分布是否合理：
+虐爽路线检查虐点与爽点的铺垫、间隔和兑现；下方示意不作为全部短篇的固定分布：
 
 ```
 理想分布：虐1 → 虐2 → 虐3 → 爽1(小) → 虐4 → 爽2(大)
@@ -220,7 +217,7 @@
 
 ### 毒点/代入感/震惊/开头/结尾/情绪/期待感速查
 
-> 详细的毒点分类、识别方法和修复方案见 `anti-ai-writing.md`。
+> AI 味与代入感问题按 `expression.md`、`narrative-focus.md`、`story-logic.md` 三层诊断，只报告有原文依据的问题与建议，不执行改写。
 
 | 检查项 | 标准 |
 |--------|------|
@@ -236,11 +233,11 @@
 | 震惊分层 | 点→网→深度，不能只写点震惊 |
 | 震惊阶梯递进 | 阶梯式上升，非直线 |
 | 震惊有广度 | 关系网都要有反应 |
-| 前50字有冲突/异常 | 不能是背景铺垫 |
-| 前100字知核心矛盾 | 必须知道 |
-| 开头情绪强度 | ≥7（1-10） |
-| 结尾是具体的 | 动作/对话/画面，禁止总结/反思 |
+| 前50字有冲突/异常 | 强开局路线的参考；其他路线先建立具体人物与阅读问题 |
+| 前100字知核心矛盾 | 强开局路线检查矛盾是否可见；悬疑可先展示核心异常 |
+| 开头情绪强度 | 强情绪虐爽路线可参考 ≥7（1-10），判断须附原文依据 |
+| 结尾是具体的 | 动作、对话、画面或有依据的主观判断形成收口，空泛复述才需改 |
 | 结尾有余韵 | 读者还想往下看 |
-| 结尾情绪强度 | 虐≥8，爽≥7，治愈≥6 |
+| 结尾情绪强度 | 对应路线参考：虐≥8，爽≥7，治愈≥6；不作跨题材通过线 |
 | 情绪对等释放 | 虐多少补多少，反派结局关联主角 |
 | 期待管理 | 两长一短不断，核心卖点贯穿 |

package/lib/oh-story/skills/story-review/references/review-tracking.md

@@ -1,10 +1,10 @@
 # story-review：审查收尾的追踪文件维护
 
-新追踪协议只有一个写入口：本 skill 的 `scripts/tracking_commit.py`；完整事务字段和命令见 `references/tracking-transaction.md`。**full / lean 模式只允许通过该工具修改 `追踪/`；solo 模式不修改任何 `追踪/` 文件。**不得直接 Edit/Write/追加 `伏笔.md`、角色快照、时间线视图、摘要或 `上下文.md`。
+追踪维护通过本 skill 的 `scripts/tracking_commit.py` 提交事务，字段与命令见 `references/tracking-transaction.md`。**full / lean 模式只允许通过该工具修改 `追踪/`；solo 模式不修改任何 `追踪/` 文件。**不得直接 Edit/Write/追加 `伏笔.md`、角色快照、时间线视图、摘要或 `上下文.md`。
 
-1. **先检查状态**：执行 `tracking_commit.py check --project {项目根}`，确认 `_tracking-state.json` 与全部派生视图一致。失败时重跑产生当前目标状态的原事务，不得猜测、手改 Markdown 或另造事务覆盖。
-2. **判定是否需要修订**：只有正文证据表明现有追踪事实错误或缺失时才维护。过期伏笔、漏登记开放钩子、角色当前状态、客观时间线、读者认知都归入其证据所在章的 `mode=revision` 事务。普通审查意见和未来写作建议不进追踪。
-3. **构造完整同章事务**：先跑 `tracking_commit.py draft --project {项目根} --chapter {N}`，草稿已按该章现有记录预填；保留该章原有紧凑增量中仍成立的字段，只修改有证据的变化；核心角色变化同时提交截至当前最后已写章的完整 `character_snapshots`。伏笔对同一 ID `upsert` 当前状态，不增加重复行；时间线同时提交客观事实、读者当前认知和实际揭示状态。
-4. **提交并复检**：执行 `tracking_commit.py commit`，再执行 `check`。确认逐章记录规范且未超限、`上下文.md` 恰好固定 7 栏且 ≤12288 字节、作者/读者时间线及全部派生视图与 state 一致。
+1. **先检查状态**：执行 `tracking_commit.py check --project {项目根}`，确认 `_tracking-state.json` 与全部派生视图一致。失败时按 tracking-transaction.md 的错误类型处理；提交后派生视图不一致，用新的同章 revision 事务重建，不重跑已清理的旧输入，也不手改 Markdown。
+2. **判定是否需要修订**：只有正文证据表明现有追踪事实错误或缺失时才维护。过期伏笔、漏登记开放钩子、角色当前状态、客观时间线、读者认知都归入其证据所在章的 `mode=revision` 事务。审查意见与未来写作建议不进事实追踪。
+3. **构造完整同章事务**：先跑 `tracking_commit.py draft --project {项目根} --chapter {N}`，草稿已按该章现有记录预填；保留该章原记录中仍成立的内容，只修改有正文证据的变化；核心角色变化同时提交截至当前最后已写章的完整 `character_snapshots`。伏笔对同一 ID `upsert` 当前状态，不增加重复行；时间线同时提交客观事实、读者当前认知和实际揭示状态。
+4. **提交并复检**：执行 `tracking_commit.py commit --project {项目根} --input {事务文件}`，再执行 `tracking_commit.py check --project {项目根}`。确认逐章记录规范且未超限、`上下文.md` 恰好固定 7 栏且 ≤12288 字节、作者/读者时间线及全部派生视图与 state 一致。
 
 例如审查 demo 第 10 章时，若正文明确显示周薄森说专业重拍版“缺了灵魂”、张耀祖拍板继续用江晨手机原版，修订事务可以把该结果写进客观事实和读者已知；钟嘉嘉“只猜对了一半”背后的培养安排如果正文尚未揭示，只能留在作者真相，不能写入读者视图。

package/lib/oh-story/skills/story-review/references/rubrics/fanqie.md

@@ -2,17 +2,18 @@
 
 ## 评分标准
 
+下列阈值用于快节奏、强情绪写法的初筛，不代表平台算法；先对照本书题材与已定节奏。
+
 | 指标 | PASS 标准 | FAIL 标准 |
 |------|----------|----------|
 | 开头吸引力 | 前 3 段包含冲突/悬念/钩子 | 前 3 段纯描写/背景介绍 |
 | 读者留存 | 每章结尾有"翻页动力"（悬念/反转/新信息） | 连续 3 章结尾无翻页动力 |
 | 题材匹配 | 内容符合标签类型（如甜宠/逆袭/重生） | 偏离标签类型超过 3 章 |
-| 算法友好 | 短段落、快节奏、高信息密度 | 大段落、慢节奏、低信息密度 |
+| 阅读节奏 | 段落便于手机阅读，节奏和信息量支撑核心卖点 | 机械切段或拖沓，信息不足以支撑阅读期待 |
 | 情绪节点 | 每 1000 字有情绪起伏 | 连续 2000 字情绪平直 |
-| 完读率预估 | 3 章 Hook 有效 + 节奏不拖 → 预估完读 >40% | 前 3 章无 Hook 或连续拖沓 → 预估完读 <20% |
+| 完读风险 | 前 3 章 Hook 有效，节奏不拖 | 前 3 章无 Hook 或连续拖沓；完读率须用实际数据验证 |
 
 ## 使用方式
 
-- story-review 的 story-architect 视角引用此标准
-- advisory only，不 blocking
-- 番茄算法偏好快节奏、强情绪
+- story-architect 用本表检查番茄题材的开局、节奏与情绪交付。
+- 本表只作 advisory，不 blocking；具体判断须有原文证据。

package/lib/oh-story/skills/story-review/references/rubrics/qidian.md

@@ -2,18 +2,19 @@
 
 ## 评分标准
 
+成长与金手指项用于对应题材；没有等级或金手指的作品不据此判缺失。其余阈值按本书节奏与更新计划选用。
+
 | 指标 | PASS 标准 | FAIL 标准 |
 |------|----------|----------|
 | 爽点密度 | 每 3000 字 ≥1 情绪节点（升级/打脸/获宝） | 连续 5000 字无情绪节点 |
 | 升级节奏 | 每 50 章有等级/实力突破 | 100 章无任何升级 |
 | 金手指使用 | 每章提及或使用金手指（系统/戒指/功法） | 连续 5 章未提及金手指 |
-| 日更支持 | 大纲支持 4000 字/天节奏（每章 2000 字，每天 2 章） | 无日更计划，章节长度不规律 |
+| 日更支持 | 大纲支持本书更新计划，如 4000 字/天（每章 2000 字，每天 2 章） | 既定更新量与大纲可交付内容不匹配 |
 | 钩子密度 | 每章结尾有悬念/钩子 | 连续 3 章结尾无钩子 |
 | 角色存在感 | 主角每章出场并推进 | 连续 2 章主角不出场或无推进 |
-| 追读比 | 章尾钩子 + 情绪连续性 → 追读比预估 >30% | 连续 3 章无钩子或情绪断裂 → 追读比预估 <15% |
+| 追读风险 | 章尾钩子与情绪连续性支撑后续期待 | 连续 3 章无钩子或情绪断裂；追读比须用实际数据验证 |
 
 ## 使用方式
 
-- story-review 的 story-architect 视角引用此标准
-- advisory only，不 blocking
-- 用户可自定义阈值
+- story-architect 用本表核对起点作品的成长线、金手指和连载期待。
+- 本表只作 advisory，不 blocking；作者可按本书目标调整阈值。

package/lib/oh-story/skills/story-review/references/rubrics/zhihu.md

@@ -4,17 +4,16 @@
 
 | 指标 | PASS 标准 | FAIL 标准 |
 |------|----------|----------|
-| 第一人称 | 全文使用「我」视角 | 使用第三人称（除非多视角设计） |
-| 情绪拉扯 | 每段有情绪变化（期待→失望→惊喜等） | 连续 3 段情绪无变化 |
+| 第一人称 | 采用「我」视角时，所知信息与叙述姿态一致 | 已定第一人称却无依据换视角；明确采用其他视角不据此判错 |
+| 情绪拉扯 | 关键场景有期待→失望→惊喜等情绪变化，承接段服务于变化 | 连续 3 段重复同一情绪且无新信息或行动 |
 | 反转设计 | 至少 1 个有效反转（前文有伏笔） | 无反转或反转无伏笔支撑 |
-| 结尾余韵 | 结尾留有思考空间/情感余韵 | 结尾完全封闭无回味 |
+| 结尾余韵 | 兑现本篇情绪目标，收口有具体后果或情感余韵 | 只有空泛总结，或承诺的情绪没有落点 |
 | 格式合规 | 段落以短为主（有长短/疏密变化）、无空行、对话格式正确 | 通篇同长度或连续超长段落/空行/对话标签 |
 | 开头钩子 | 第一句话包含信息量（动作/冲突/悬念） | 第一句话纯描写/背景 |
-| 字数控制 | 8000-13000 字（盐言标准） | 超出或不足 |
-| 开头跳失率 | 第一句包含动作/冲突/悬念 → 跳失率预估 <30% | 第一句纯描写/背景 → 跳失率预估 >50% |
+| 字数控制 | 全文在本次锁定的字数范围内，并符合已核实的投稿要求 | 超出或不足，且作者未变更范围 |
+| 开头跳失风险 | 第一句用动作、冲突或悬念建立阅读理由 | 纯描写/背景未建立阅读理由；跳失率须用实际数据验证 |
 
 ## 使用方式
 
-- story-review 的 story-architect 和 character-designer 视角引用此标准
-- advisory only，不 blocking
-- 盐言故事注重第一人称代入感和情绪拉扯
+- story-architect 与 character-designer 用本表核对盐言故事的钩子、反转和情绪交付。
+- 本表只作 advisory，不 blocking；叙述视角与收口按本篇已定文风检查。

package/lib/oh-story/skills/story-review/references/solo.md

@@ -1,12 +1,12 @@
 # story-review：solo 模式
 
-不 spawn Agent。先按 Phase 1 第 4 步识别目标平台并加载对应 rubric；即使是 solo，也必须用平台 rubric、`story-review/references/quality-rubric.md` 或内置审查基准包校准判断。
+当前会话直接审查，不 spawn Agent。先按 Phase 1 第 4 步识别平台，加载对应 rubric；平台不明用 `story-review/references/quality-rubric.md`，文件不可读用内置基准包。
 
-solo 必须执行基础检查：
-1. 格式合规性检查：按戏剧单元/画面分段而非机械按字数切分（偶发稍长的完整推理、氛围或情绪链不算违规，通篇同阈值切段或碎成提纲才算）；段首建立主语、段中用代词或省略，连续无必要重复同一角色名才算主语过密；无段间空行；对话独立成行；具体数字须确认统计正确且有叙事必要。
+逐项完成基础检查：
+1. 格式合规性检查：按戏剧单元/画面分段而非机械按字数切分（偶发稍长的完整推理、氛围或情绪链不算违规，通篇同阈值切段或碎成提纲才算）；段首建立主语、段中用代词或省略，连续无必要重复同一角色名才算主语过密；无段间空行；对话独立成行；正文评价台词、题字等所用的具体字数，须确认统计正确且有叙事必要。
 2. 简单的设定一致性 grep（角色名、属性、关键设定、伏笔关键词）+ 推理型一致性检查（规则边界、设定层级、跨章因果链、可滥用漏洞、代价一致性）。
-3. AI 味与禁用词检查：先读 `story-review/references/banned-words.md`，一级禁用词逐个核查、出现即报——预检脚本对高频套话只做密度统计、另查固定句式（否定翻转、破折号、章尾预告等），不会逐个报一级词，不能拿脚本结果代替。再读 `story-review/references/anti-ai-writing.md` 的「AI写作指纹」「10 种 AI 写作模式检测」两节，判断解释腔、告知式情绪、二级词滥用（该文件的改写顺序与范例是改稿用的，审稿不照做）。脚本命中逐条复核是不是功能性写法；两份文件不可读时用内置 AI 味 / 禁用词 fallback 速查。
-4. 通用网文内容评分（优先读取 `story-review/references/quality-rubric.md`，不可读时使用内置通用网文内容 rubric）。
+3. AI 味按表达、用笔、故事三层检查：完整读 `story-review/references/expression.md`、`story-review/references/narrative-focus.md`、`story-review/references/story-logic.md`，以及信号索引 `story-review/references/banned-words.md`。表层脚本只给候选，不替代三层诊断；词句干净也检查关键过程、详略失衡、行为依据与事件后果。每项报告原文位置、读者损失、建议与依据；缺少动机或事件设计时明确指出，不能以补动作代替。功能性写法按本书文风保留；只报告，不执行这些方法中的改写动作。参考不可读时用内置 AI 味 / 禁用词 fallback 速查并报告诊断限制。
+4. 按已选平台 rubric 或通用基准评估内容，不再另换一套通用评分。
 5. 按统一 Findings Schema 整理问题，再按下方模板写给作者。
 
 ### solo 模式输出格式

package/lib/oh-story/skills/story-review/references/story-logic.md

@@ -0,0 +1,65 @@
+# 故事成立与变化：诊断因果，按授权修复
+
+本文件检查事件、行为、信息和结果的关系。句段表达见 [expression.md](expression.md)，既有内容的详略见 [narrative-focus.md](narrative-focus.md)。执行范围由调用方确定，审稿只报告。
+
+## 沿事件检查，不套冲突公式
+
+先从原文和已有设计确认人物处境、所知信息、本场作用及结果，再追问结果怎样发生。人物可以被动、冲动、犯错、忍让；日常、沉淀和氛围场景也有价值。不要求每场戏都有对手、反转、代价或胜负。
+
+| 检查对象 | 可执行的问题 | 需要定位的缺口 |
+|---|---|---|
+| 行为依据 | 他根据当时所知，为什么会选这一步？害怕、习惯、误判有无文本支持？ | 只因作者需要就突然信任、反抗、原谅；人物为结果临时变性格 |
+| 因果承接 | 后件由前件的哪个条件触发？中间条件已经写过，还是根本不存在？ | “然后”连接一串事件，解释句宣称成功却没有成立过程 |
+| 他人立场 | 对方想保住什么，有什么限制？他为什么接受或改变策略？ | 所有人只负责帮忙、送线索、惊讶或认错，没有自己的理由 |
+| 办法与结果 | 解法、失误、收益是否有前文支撑？结果的分量与准备是否相称？ | 临时出现的证据或能力解决问题；一句请求就越过已建立的阻力 |
+| 变化与承接 | 经历之后，关系、认知、资源、期待、情绪或行动空间有什么变化？后文是否接住？ | 连续场景重置到原状，同一种办法反复奏效，已发生的事没有影响 |
+| 信息与时序 | 谁在何时知道什么，从何得知？读者何时获知？ | 人物提前知道答案、把回忆当现场、剧透尚未揭露的因果 |
+
+逐项有问题才记录，正常项可以略过，不为填满检查表回头加戏。判断“过平”要指出原文中的重复或缺失：例如连续求助被拒却从未调整办法，或已经设计的关系变化没有影响后来行为。一次没有冲突的照料不能据此判平。
+
+## 缺的是写法，还是成立条件
+
+遇到转变突兀，先检索本次提供的前文、设定与大纲。结论分三种：
+
+- **依据已有，正文没接上**：按既定信息边界恢复承接，避免重复解释。若已定承诺只在前文出现，可以让角色在当前交涉中使用它。
+- **资料不足，暂时不能判断**：明确哪一项未知，继续有依据的改稿；不能因为没给全书就判全书无铺垫，也不能替作者补出前情。
+- **当前设计确实缺条件**：说明原文的哪次选择或结果缺少什么支持，给最小设计方案及影响。增加“他终于被打动”这类解释不能补足对方立场。
+
+区分信息缺口与悬念：门外留下湿脚印，尚不知道谁来过，构成一个明确的问题；不应替作者猜出答案。读者连人物为何守着这扇门、当下要做什么都无从理解时，才回查并补已有的必要背景。
+
+## 诊断深度与执行权限分别确定
+
+| 可以在普通去味中落改 | 需要剧情设计授权的改动 |
+|---|---|
+| 修正可核实的指代、主体、时序笔误 | 多种解释均成立，需要替作者选定真实动机 |
+| 恢复已有因果、条件和信息来源的承接 | 新增承诺、证据、人物身份、能力、事件或信息来源 |
+| 展开已定交锋、权衡和反馈，调整同场详略 | 改变人物决定、胜负、关系走向、代价或事件顺序 |
+| 在既定揭露边界内呈现已知信息 | 提前揭底、搬动伏笔，或改变读者与人物获知顺序 |
+
+对白措辞和必要微连接可以为既定内容服务；不能借“一次性动作”新增威胁、承诺、拿到证据或改变人物策略。改换视角时只叙述该视角有依据的感知与认知，不能添加“进门时发现”“后来听说”等新经历来保留信息。
+
+作者已明确要求重写或允许调整剧情时，直接执行被授权部分，保留其余已定事实；不用再次请求同一授权。仍缺少关键选择依据时，提出可审阅的最小选项。修法要写到哪次行为、什么条件或什么结果上，说明会牵动哪些后文，不只说“加强冲突”。建议与推测放在报告，不悄悄成为正文事实。
+
+## 成组示例：结果需要可成立的过程
+
+以下为合成示例。
+
+**原文**：掌柜指认学徒改了账。学徒拿出一张抄本，众人立刻相信他，掌柜当众认错。
+
+**可定位的诊断**：抄本由谁保存、为何可信、众人凭什么有能力和立场核对，都未交代。仅仅有人拿出纸，不能证明其上内容成立；也不能靠增加旁人惊讶来补足。
+
+**普通去味**：清理空泛修饰，保留已定的澄清结果；查前文有无验账惯例、独立底稿或见证条件。当前资料没有时，把未修的缺口列入报告，提出最小方案及需要新增的条件，不把方案当作发生过的事。
+
+**已有前情且作者授权演出**：此前三位伙计各自封存过底稿，掌柜允许众人当面核账。
+
+> 学徒把自己的底稿放在柜上，请另两人拆开封存的那两页。三份末行都是同一个数，和掌柜手中的新账对不上。
+>
+> 掌柜拿着那几页纸，承认这一笔不是学徒改的。
+
+证据的分量来自已有的独立保存与核对条件，没有临时增加秘密证人。若前情已经写足，只需呈现核对；无需再制造一次失败来“增加波折”。
+
+**会改坏的方向**：突然增加录音、权势亲戚或暗中交易，让结果更热闹却改掉故事依据；或未经授权把澄清改为失败，以“增加代价”替作者决定后果。
+
+## 修后回读
+
+把本次修改前后放回事件链，核对人物知情顺序、选择依据、结果及下一场承接。报告区分已修的缺口、仍需设计的部分和因资料不足未作结论的部分。表达顺了不代表故事缺口已经消失。

package/lib/oh-story/skills/story-review/references/style-resolution.md

@@ -1,10 +1,10 @@
 # 文风与参考冲突裁决
 
-写正文、改写、去 AI 味和审稿都先做这一步；inline 与 agent 用同一份裁决。无需另建画像或要求作者填写配置。
+写正文、改写、去 AI 味和审稿前，先确定本次生效的文风要求。主会话与子代理共用本次裁决。
 
-## 按维度取值，不把整份文件互相覆盖
+## 按表达维度确定优先级
 
-表达选择按以下顺序取第一个明确、适用的要求：**当前请求 > 本书文风/设定 > 本书 active 作者记忆 > 题材、流程、全局 active 记忆 > 主对标文风 > 题材包与通用 references 默认值**。未声明的维度才向下补齐；本书例外不撤销全局习惯，临时要求不写回长期记忆。
+表达选择按以下顺序取第一个明确、适用的要求：**当前请求 > 本书文风/设定 > 写作流程传入的适用偏好 > 主对标文风 > 题材包与通用 references 默认值**。传入偏好中，本书要求优先于题材、流程和全局要求；未声明的维度才向下补齐。
 
 句长、视角、标点、对话落法、情绪直写、修辞、叙述者评论和收尾方式都是表达维度。reference 中的“必须”“禁用”“最高优先级”、示例和检测阈值不使默认写法升级为作者不可覆盖的规则。主对标的低置信观察不压过作者的明确选择。
 
@@ -14,7 +14,7 @@
 
 1. 从本次正文路径确定书目录（长篇为 `正文/` 的父目录，短篇为 `正文.md` 所在目录）。读该书 `设定/文风.md`；短篇同时读 `设定.md` 的文风约定。无文件就继续，不建占位文件、不猜其他书。文风无最低字数限制，一句可执行的偏好也有效；空白、纯标题、待补充不算。
 2. `_文风摘要.md` 只辅助定位，不替代全文。当前会话已读全文时无需反复读；摘要与全文不一致用全文，不让旧摘要压过作者的新修改。
-3. 有作者记忆时 query，显式传当前书名、已知题材和流程以及需要的 kind，避免只取到 global；没有就跳过。只用 active；同一维度窄范围覆盖宽范围，不拼成同时满足的清单。无法判定的同范围冲突才问作者，已能按优先级解决的不询问。
+3. 复用调用方传入的适用偏好与文风裁决，同一表达维度由窄到宽取值；同范围冲突不明才问作者。独立调用没有传入结果时，按当前请求与本书文风继续。
 4. 在现有 prompt 填 `style_resolution`：本次生效的表达要求及来源、被覆盖的默认条款、必须保留的事实/信息边界；只列与任务有关的冲突，无冲突可写“按本书文风”。原样传给正文、去味和文字 reviewer，并传文风全文路径。同批复用，当前请求或文风变动时更新。单独调用去味/审稿也执行本步骤，不靠上次会话的记忆。
 
 ## 检测器如何服从裁决
@@ -24,4 +24,4 @@
 - 本书文风明确允许某种停顿标点时，可登记 `——` 或 `……`；具体修辞登记完整的获准原句，不能登记“不是”“没有”等泛词来关闭整类检查。
 - 每项用上一行 `# 来源：…；用途：…` 说明当前请求或文风依据。只为执行作者已明确的选择登记，不因脚本报警自动放行。当前请求禁止某写法时移除相冲突的豁免；一次性保留只登记该句，不推断长期习惯。
 - 深扫、标点整理和写后/下一章检查读取同一白名单。豁免只影响对应字面片段的风格检查；同一行其他问题照报，事实、字数、占位、工程词、截断和文件结构检查不豁免。
-- 所选 Gate 仍执行：检查该写法是否重复、冗余、破坏节奏或越过信息边界；有这些具体问题才改。裁决与发现可简短写在正常交付报告中，不写进小说正文。
+- 当前任务的审查门禁（Gate）仍执行，检查重复、冗余、节奏和信息边界问题。裁决与发现写在交付报告中，不写进小说正文。

package/lib/oh-story/skills/story-review/references/tracking-initialization.md

@@ -2,7 +2,7 @@
 
 ## 初始化事务
 
-新书从第 0 章初始化：把下面的 JSON 写到 `{书目录}/.story/work/init.json`，跑 `{PYTHON} {skill 根}/scripts/tracking_commit.py init --project {书目录} --input {书目录}/.story/work/init.json`，成功后删掉临时文件。`story-import` 导入已有小说时把最后完整章写入 `last_chapter=N`；第 1..N 章不伪造日更记录，常规续写从 N+1 章开始。
+仅尚无追踪状态时初始化。新书从第 0 章开始：把下面的 JSON 写到 `{书目录}/.story/work/init.json`，跑 `{PYTHON} {skill 根}/scripts/tracking_commit.py init --project {书目录} --input {书目录}/.story/work/init.json`，成功后删掉临时文件。`story-import` 导入已有小说时把最后完整章写入 `last_chapter=N`；第 1..N 章不伪造日更记录，常规续写从 N+1 章开始。
 
 ```json
 {
@@ -28,4 +28,4 @@
 }
 ```
 
-导入初始化时直接传入当前核心角色快照、伏笔当前行、时间线事件和固定 7 栏状态输入。阶段/卷级回看按需查询正文，不作为每章强一致追踪产物。
+导入示例须按已读正文改写当前状态，不能照用第 0 章内容；全部导入批次完成后初始化一次，不重置已有 state。传入当前核心角色快照、伏笔当前行、时间线事件与 JSON 中六项 context 输入，由脚本生成七栏 `追踪/上下文.md`。阶段/卷级回看按需查询正文，不作为每章强一致追踪产物。

package/lib/oh-story/skills/story-review/references/tracking-transaction.md

@@ -1,6 +1,6 @@
 # 追踪状态协议
 
-`追踪/` 使用“一个结构化权威状态 + 多个确定性派生视图”。模型只提交一份语义 JSON，不分别 `Write/Edit/echo >>` 多个追踪文件。
+`追踪/` 以结构化 state 为权威，由脚本生成各 Markdown 视图。模型只提交一份语义 JSON，不分别 `Write/Edit/echo >>` 多个追踪文件。
 
 ## 权威层与派生层
 
@@ -118,7 +118,7 @@ Markdown 只负责给作者和 Agent 阅读，工具不再反向解析 Markdown
 约束：
 
 - 构造事务前运行 `check`，把当前 `state_revision` 原样写入 `expected_state_revision`；若状态已经变化，重新读取 state 并重构事务。
-- `context` 的允许字段随子命令不同：`init` 收 `position`、`long_term_constraints`、`active_character_names`、`continuity_risks`、`recent_chapters`、`next_chapter_commitments` 六项；`commit` 只收前四项。`recent_chapters` 与 `next_chapter_commitments` 在 commit 时由工具从当前视图和本章 `delta` 派生，手填会在任何写入前被拒（`context contains unsupported fields: ...`，exit 2）。照 init 示例套 commit 事务是最容易踩的一处。
+- `context` 的允许字段随子命令不同：`init` 收 `position`、`long_term_constraints`、`active_character_names`、`continuity_risks`、`recent_chapters`、`next_chapter_commitments` 六项；`commit` 只收前四项。`recent_chapters` 与 `next_chapter_commitments` 在 commit 时由工具从当前视图和本章 `delta` 派生，手填会在任何写入前被拒（`context contains unsupported fields: ...`，exit 2）。commit 事务须使用自身允许字段，不能照搬 init 示例。
 - `character_snapshots` 中出现的角色视为核心复用角色，必须同时出现在 `character_changes`；已经建立快照的核心角色再次变化时必须提交新快照。
 - 角色快照的四个列表不限制条数，只限制单项长度和最终文件总字节：目标 ≤4096 字节，超过警告；硬上限 8192 字节，超过则在任何写入前拒绝。
 - 没有快照的角色变化视为临时角色，不建立状态文件；`context.active_character_names` 最多 6 人且必须已有当前快照。

package/lib/oh-story/skills/story-setup/SKILL.md

@@ -1,16 +1,16 @@
 ---
 name: story-setup
-version: 1.3.2
+version: 1.3.3
 description: "网文写作工具集基础设施部署与检查。为 Claude Code / OpenCode / Codex / Google Antigravity / ZCode / OpenClaw / Reasonix 提供内置适配；Web AI / 通用 Agent 可走 skills + AGENTS.md 文件模式。触发方式：/story-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」「检查写作环境」。"
 metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudecode"}}
 ---
 # story-setup：网文写作工具集基础设施部署
 
-你是写作基础设施部署器。将网文写作工具集部署到用户项目目录：已适配的 CLI 走专用 hooks/agents/config；NarraFork、Web AI、自定义 Agent 等环境走通用文件模式。
+你负责把网文写作工具集部署到用户项目目录：已适配的 CLI 使用专用 hooks/agents/config；NarraFork、Web AI、自定义 Agent 等使用通用文件模式。
 
-**执行铁律：不覆盖用户已有配置，合并而非替换。**
+**保留用户配置；受管文件按清单更新，共同维护的文件按管理块合并。**
 
-作者第一次部署的顺序：判断当前宿主 → 确认项目根 → 按宿主部署 → 验收 → 告诉作者下一步。本文件只写各宿主通用的流程；每个宿主专属的部署清单、算法、校验和安装报告提示在各自的部署文件里，**只读本次目标宿主的那一份**（见 Phase 2）。
+作者第一次部署的顺序：判断当前宿主 → 确认项目根 → 按宿主部署 → 验收 → 告诉作者下一步。本文件写公共流程；各宿主的部署清单、算法、校验和报告提示见 Phase 2 对应文件，**只读本次目标宿主的那一份**。
 
 ## 选择模式
 
@@ -26,9 +26,9 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 > 判据是「有没有 `SKILL.md`」：只看正在执行的 `SKILL.md` 同级的 `references/`。项目内 `.claude/skills/story-setup/`、`.codex/skills/story-setup/` 和 OpenCode 的 `skills/story-setup/` 只有 `references/agent-references/`、不含 `SKILL.md`，不会是执行目录，也不要拿它们核对。Antigravity / ZCode / OpenClaw / Reasonix / generic 的项目副本是整份 skill 拷贝、自带 `SKILL.md`，9 个子目录本就齐全，照常核对即可。
 
 1. 检查当前目录是否已部署过（存在 `.story-deployed`）
-   - `agents_version` 缺失、非整数或小于 `34` → 标记为待更新，继续执行当前部署
-   - `agents_version: 34` → 使用 AskUserQuestion 确认是否重新部署；提示里写明重新部署只用**当前本地 skill 包**刷新项目文件，要拿 skill 本身的新版本得先更新 oh-story-claudecode（`npx skills add` 或 marketplace），再回来重跑
-   - `agents_version` 大于 `34` → 当前 story-setup 比项目部署旧；停止以避免降级覆盖，提示先更新 oh-story-claudecode，不写任何部署文件
+   - `agents_version` 缺失、非整数或小于 `35` → 标记为待更新，继续执行当前部署
+   - `agents_version: 35` → 使用 AskUserQuestion 确认是否重新部署；提示里写明重新部署只用**当前本地 skill 包**刷新项目文件，要拿 skill 本身的新版本得先更新 oh-story-claudecode（`npx skills add` 或 marketplace），再回来重跑
+   - `agents_version` 大于 `35` → 当前 story-setup 比项目部署旧；停止以避免降级覆盖，提示先更新 oh-story-claudecode，不写任何部署文件
    - 同时读 `target_cli` 字段。**已部署项目以 sentinel 里的值为准**：非空时（逗号分隔的多端组合原样保留）这些端照常重新部署，不再让作者选；第 4 步仍判断当前宿主：判断出来且不在其中（作者换了软件）→ AskUserQuestion 问「这个文件夹之前是给 {已部署宿主名} 装的，你现在用的是 {当前宿主名}，要一起装上吗？」（「一起装上（推荐）」「只更新原来的」），选前者就加进 `target_cli`；判断不出不问。字段缺失或为空才走第 4-6 步。用户明确要求增删目标端时，用 AskUserQuestion 在现有值基础上改，改完的值写回 sentinel。
    - `target_cli` 不含 opencode、但项目里有 `.opencode/plugins/story-hooks.ts` 或 `.opencode/agents/`（多端部署时 OpenCode 曾被版本门拦下）→ 用 AskUserQuestion 问是否把 OpenCode 加回来；选加回则先过 [references/deploy-opencode.md](references/deploy-opencode.md) 的「部署前置」，通过后写回 `target_cli`
 2. 检查是否有书名目录（包含 `追踪/` 子目录的目录，或用户自定义结构）
@@ -59,9 +59,9 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ## Phase 2：部署基础设施
 
-整个 Phase 2 幂等：目录复制、文件写入和各宿主部署文件里的合并算法重复执行结果一致。因环境原因（工具不可用、权限被拒、网络失败）中途失败时，直接从头重跑本 Phase，不需要先清理半成品；`create only if absent` 的用户状态文件（见各部署清单的 Owner class）不会被二次覆盖。
+Phase 2 幂等：复制、写入与各宿主合并重复执行结果一致。工具、权限或网络问题中断后，从头重跑即可，不另清理半成品；`create only if absent` 的用户状态文件（见清单 Owner class）不会被覆盖。
 
-**两列基准目录不同**：部署清单里 `Source path` 相对正在执行的这份 skill 包，`Target path` 相对用户项目根。执行每一行（以及各宿主部署算法里的每个递归复制步骤）之前，先把通配符具体化为单个源/目标，再用本 `SKILL.md` 同级的 `scripts/copy-path-safety.py` 检查。该脚本按 `Path.resolve` / `realpath` 语义跟随已有 symlink，并在两侧都存在时用 `samefile` 核对文件系统对象；**只转绝对路径或比较字符串不算检查完成**。读取其 JSON：`status: same` 时 no-op，禁止复制；仅 `copy_allowed: true` 时可以复制；`source_missing`、`unsafe_target_within_source` 或 `filesystem_identity_error` 必须停止该步骤并报告。无法运行脚本时只能用当前环境的文件系统 API 做完全相同的 canonical realpath、same-object 与 target-descendant 检查；无法确认就停止，不得尝试复制。OpenClaw / Reasonix / generic 的项目副本是整份 skill 拷贝，重跑时执行的就是项目里那份；Reasonix / Codex 还可能经 `.agents/skills → ../skills` symlink 加载，路径文本不同也可能指向同一目录，照字面复制会把目录嵌进自身并撑满磁盘。
+**两列基准目录不同**：`Source path` 是包内来源，story-setup 内的路径以当前 `SKILL.md` 所在目录定位；`Target path` 相对用户项目根。执行每一行（以及各宿主部署算法里的每个递归复制步骤）之前，先把通配符具体化为单个源/目标，再用本 `SKILL.md` 同级的 `scripts/copy-path-safety.py` 检查。该脚本按 `Path.resolve` / `realpath` 语义跟随已有 symlink，并在两侧都存在时用 `samefile` 核对文件系统对象；**只转绝对路径或比较字符串不算检查完成**。读取其 JSON：`status: same` 时 no-op，禁止复制；仅 `copy_allowed: true` 时可以复制；`source_missing`、`unsafe_target_within_source` 或 `filesystem_identity_error` 必须停止该步骤并报告。无法运行脚本时只能用当前环境的文件系统 API 做完全相同的 canonical realpath、same-object 与 target-descendant 检查；无法确认就停止，不得尝试复制。OpenClaw / Reasonix / generic 的项目副本是整份 skill 拷贝，重跑时执行的就是项目里那份；Reasonix / Codex 还可能经 `.agents/skills → ../skills` symlink 加载，路径文本不同也可能指向同一目录，照字面复制会把目录嵌进自身并撑满磁盘。
 
 **部署前清理自嵌套残留**：`{.claude,.codex,.zcode}/skills/story-setup/references/agent-references/` 与项目根 `skills/story-setup/references/agent-references/` 里若多出 `agent-references/` 层（可能嵌了多层），以及 `skills/story-setup/skills/`，整段删掉再部署，并在安装报告里列出删掉的路径。
 
@@ -84,19 +84,19 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ### Step 2：创建部署标记
 
-- 创建 `.story-deployed` 文件（sentinel file）
+- 仅为本次成功部署的目标创建或更新 `.story-deployed`（sentinel file）；全部目标停止时保留旧标记，不创建新标记。
 - 写入以下字段（YAML `key: value` 格式，hook 用 `references/templates/hooks/lib/sentinel.sh` 读取）：
   ```
   deployed_at: <date -u +"%Y-%m-%dT%H:%M:%SZ">
-  agents_version: 34
-  setup_skill_version: 1.3.2
+  agents_version: 35
+  setup_skill_version: 1.3.3
   target_cli: claude-code（或 opencode、codex、antigravity、zcode、openclaw、reasonix、generic，或其任意组合）
   resolver_strategy: project-local-skill-reference
   references_dir: .claude/skills/story-setup/references/agent-references（Codex 写 .codex/skills/...；Antigravity 写 .agents/skills/...；ZCode 写 .zcode/skills/...；OpenCode / OpenClaw / Reasonix / generic 写 skills/...；多端用逗号分隔）
   ```
 - 此文件供 session-start.sh 和写作 skill 检测部署状态，避免重复提示
 - 宿主部署文件里「部署标记补充」要求的额外标记一并创建（如 Claude Code 的重启确认标记）
-- 如果 `.story-deployed` 已存在但 `agents_version` 缺失、非整数或小于 `34`，按本次流程更新 hooks/agents/rules/reference bundle（具体变更见 `UPGRADING.md`）；大于 `34` 时已在 Phase 1 停止，不得降级覆盖
+- 如果 `.story-deployed` 已存在但 `agents_version` 缺失、非整数或小于 `35`，按本次流程更新 hooks/agents/rules/reference bundle（具体变更见 `UPGRADING.md`）；大于 `35` 时已在 Phase 1 停止，不得降级覆盖
 
 ## Phase 3：验证安装
 
@@ -104,7 +104,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 1. 对 `target_cli` 里的每个宿主，执行其部署文件的「验证」一节。
 2. 验证部署标记：
-   - 检查 `.story-deployed` 是否存在且包含时间戳、`agents_version: 34`、`setup_skill_version: 1.3.2`、`target_cli`、`resolver_strategy`、`references_dir`
+   - 检查 `.story-deployed` 是否存在且包含时间戳、`agents_version: 35`、`setup_skill_version: 1.3.3`、`target_cli`、`resolver_strategy`、`references_dir`
 3. 输出安装报告。读者是不懂编程的作者，按这个顺序写：
    - **先写「现在可以做什么」**：用写书的话列本次部署后真正可用的事（如「可以开新书、续写：说 /story-long-write」「可以拆一本对标书」），端的限制如实翻译（如「这个工具里审稿由我一个人完成，没有分工助手」）。
    - **再写「你还需要做的事」**：逐条可照做，如「新开一个会话」「在 Codex 里打开 /hooks，把 oh-story 的几条信任一下」「先安装 Node」；没有就写「无需其他操作」。这两段不出现脚本名、字段名、状态名或文件路径；各宿主部署文件「安装报告必须提示」的内容先翻译进这两段。
@@ -121,7 +121,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 | `{目标平台}` | 目标发布平台 | 起点、番茄、晋江、知乎盐言 |
 | `{作者名}` | 用户笔名或昵称 | 未指定时用「作者」 |
 
-替换时去掉花括号。如果用户未指定项目名，用当前目录名。未指定的占位符保留原样不替换。CLAUDE.md 的合并策略在 Claude Code 部署文件里。
+替换时去掉花括号。未指定项目名用当前目录名；其余先按表中默认值处理，没有默认值的占位符保留原样。CLAUDE.md 的合并策略在 Claude Code 部署文件里。
 
 ## AGENTS.md 合并策略（OpenCode / Codex / ZCode / OpenClaw / Reasonix / generic）
 
@@ -135,9 +135,9 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 ## 重新部署
 
 - `.story-deployed` 不存在 → 全新安装，Phase 2 全部执行
-- `.story-deployed` 存在且 `agents_version: 34` → 提示已部署，AskUserQuestion 确认是否重新部署；提示里写明重新部署只用当前本地 skill 包刷新项目文件，skill 本身的更新走 `npx skills add` 或 marketplace
-- `.story-deployed` 存在但 `agents_version` 缺失、非整数或小于 `34` → 提示需要更新，重新执行 Phase 2 覆盖 agents/hooks/rules/reference bundle，CLAUDE.md / AGENTS.md / settings.local.json / .codex/hooks.json / `.agents/hooks.json` / .zcode/config.json 走合并策略
-- `.story-deployed` 存在且 `agents_version` 大于 `34` → 当前 skill 版本过旧，停止并提示先更新 oh-story-claudecode；不覆盖项目中的更新部署
+- `.story-deployed` 存在且 `agents_version: 35` → 提示已部署，AskUserQuestion 确认是否重新部署；提示里写明重新部署只用当前本地 skill 包刷新项目文件，skill 本身的更新走 `npx skills add` 或 marketplace
+- `.story-deployed` 存在但 `agents_version` 缺失、非整数或小于 `35` → 提示需要更新，重新执行 Phase 2 覆盖 agents/hooks/rules/reference bundle，CLAUDE.md / AGENTS.md / settings.local.json / .codex/hooks.json / `.agents/hooks.json` / .zcode/config.json 走合并策略
+- `.story-deployed` 存在且 `agents_version` 大于 `35` → 当前 skill 版本过旧，停止并提示先更新 oh-story-claudecode；不覆盖项目中的更新部署
 
 ---
 

package/lib/oh-story/skills/story-setup/references/agent-references/agent-quality.md

@@ -1,6 +1,6 @@
 # Agent 通用质量核心
 
-> 只放长篇与短篇都成立的判断。审查时必须再按 `agent-reference-profiles.md` 加载当前 profile 的质量覆盖文件；本文件不提供篇幅、密度或揭示位置阈值。
+> 本文件提供跨体裁判断；审查时必须按 `agent-reference-profiles.md` 加载当前 profile 的质量覆盖，篇幅、密度和揭示位置由该 profile 判断。
 
 ## 叙事单元推进
 
@@ -15,7 +15,7 @@
 - [ ] 每个场景有目标、阻碍和结束后的状态变化。
 - [ ] 设定跟着行动、冲突或证据出现，没有连续说明文。
 - [ ] 人物在选择、行动或承受后果，不是连续几段重复感觉同一情绪。
-- [ ] 新概念数量与当前场景的理解负荷匹配；必要概念给可验证的使用边界。
+- [ ] 新概念数量与当前场景的理解负荷匹配；必要概念交代可核对的适用条件。
 
 ## 语言与格式
 
@@ -26,7 +26,7 @@
 
 ## 五维评分
 
-每个维度 0–100 分。分数必须附证据和失败影响，不凭整体印象打分。
+每个维度 0–100 分，须附证据及问题影响，不凭整体印象打分。
 
 ### 核心一致度
 

package/lib/oh-story/skills/story-setup/references/agent-references/agent-reference-profiles.md

@@ -1,6 +1,6 @@
 # Agent 参考资料 Profile 契约
 
-> 本文件是 story-architect 的唯一资料清单。story-architect 自身只描述任务能力，不复制文件清单。每次任务选择 `long` 或 `short` 后，只能加载 `Common + 当前 profile`；表外文件即使存在也不读取。其他 agent 按各自模板的参考表读取，只用本文件的 long / short 选择规则和质量覆盖表。
+> 本文件是 story-architect 的唯一资料清单，agent 模板不重复列出。任务包未覆盖的问题选择 `long` 或 `short` 后，只加载 `Common + 当前 profile`；不自行加读表外文件，表内索引点名的题材卡按索引读取。其他 agent 按自身模板读取，沿用这里的 long / short 选择规则和质量覆盖。
 
 ## 选择规则
 
@@ -45,10 +45,9 @@ Long profile 禁止读取 `short-*` 文件，不得采用“6 章”“每节 50
 |---|---|
 | [short-genre-formulas.md](short-genre-formulas.md) | 需要短篇题材结构骨架时 |
 | [short-paragraph-hooks.md](short-paragraph-hooks.md) | 设计段落留存、付费断点与小节内钩子 |
-| [short-chapter-hooks.md](short-chapter-hooks.md) | 设计节首/节尾钩子与高密度接力 |
+| [short-chapter-hooks.md](short-chapter-hooks.md) | 设计节首/节尾钩子、主悬念承接与全文收束 |
 | [short-emotional-methods.md](short-emotional-methods.md) | 设计单篇内的羁绊、撕裂、拉扯与余韵 |
-| [short-suspense.md](short-suspense.md) | 编排主悬念、副悬念、节间钩子和全文回收 |
-| [short-reversal.md](short-reversal.md) | 设计短篇线索、误导、揭示位置与两层反转 |
+| [short-reversal.md](short-reversal.md) | 设计短篇线索、误导与揭示；两层反转按所选方案使用 |
 | [short-quality.md](short-quality.md) | 审查全文密度、付费点、反转证据链和结尾兑现 |
 
 Short profile 禁止读取 `long-*`、`outline-*`、`opening-design.md` 或 `genre-prose-cards.md`；不得把卷级、日更或跨十几章指标当硬门槛。