dsh-openwrite 0.2.8

package/presets/openwrite/skills/dog-import-query/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: dog-import-query
+description: Query a smart-import DoG graph after a novel has been split into chapters. Use to inspect import completeness, AI precheck errors, and pending outline/asset/canonical setup.
+user-invocable: false
+---
+
+# 拆书导入 DoG 验收
+
+`conductor/smart_import.py` 完成导入后会生成 `dog-graph.json`。这张图只验收导入
+结果，不负责写入章节、资产或大纲。
+
+## 工作流
+
+1. 从导入输出中找到 `data/novels/{id}/data/dog/imports/{IMPORT_ID}/dog-graph.json`。
+2. 依次调用 `dog_validate`、`dog_create`、`dog_run`、`dog_wait`，直到终态。
+3. 用 `dog_status` 查看 `manifest` 和每个 `chapter-ch_*` 节点的 evidence。
+4. 根节点通过后，读取 manifest 的 `construction.nextActions`，再调用规划和资产工具建立大纲、角色、世界观、进度和正典事件。
+5. 资产/大纲建立完成后重新运行 `novel_review_chapter`，再用 `dog-review-query`
+   查询六域评审和 37 个 legacy leaf。
+
+## 约束
+
+- DoG 失败只说明导入文件缺失、为空或 manifest 不一致；不要直接修改正文。
+- `status=partial|failed` 表示导入中途出错；先读取 manifest 的 `error` 和已完成的章节，再修复或重试导入。
+- `aiCheck.status=failed` 要如实报告，不能当成“无问题”。
+- `construction` 中的 `pending` 是后续建模待办，不是导入失败。
+- 不要让 DoG verifier 再调用 Studio 导入接口或重新读取原始整本小说。

package/presets/openwrite/skills/dog-review-query/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: dog-review-query
+description: Query an existing hierarchical OpenWrite review-v2 artifact through dsh-dog. Use after novel_review_chapter or when inspecting six quality domains, evidence, coverage, blockers, delivery status, or the 37 legacy checks. Never rerun model review from DoG.
+user-invocable: false
+---
+
+# 分层评审 DoG 查询
+
+这个 Skill 只查询 OpenWrite 已物化的 review-v2 artifact。OpenWrite 的
+`novel_review_chapter` / conductor 是评审真源；DoG 读取 47 节点分层图：上下文、
+六个质量域、硬门禁、确定性聚合和 37 个兼容查询 leaf。DoG 不调用评审模型。
+
+## 工作流
+
+1. 如果本轮还没有评审结果，先按 OpenWrite 写作流程调用 `novel_review_chapter`。
+2. 找到评审输出目录中的 `dog-graph.json`。graph 与 `review.json`、`context.json`、
+   `domain-*.json`、`gate.json`、`aggregate.json` 和 `dim_01.json` …
+   `dim_37.json` 在同一目录。
+3. 读取 graph 后依次调用 `dog_validate`、`dog_create`、`dog_run`、`dog_wait`。
+   所有节点均使用 programmatic `review-record` verifier；`dog_run` 后必须等到终态。
+4. 用 `dog_status` 分别汇报 `qualityScore`、`coverage`、`gateStatus` 和
+   `deliveryStatus`，再按需展开域、criterion、evidence、issue 和 legacy ID。
+   `inconclusive` 表示覆盖不足、未请求或 artifact 不可判定，不能描述为通过。
+5. 只有 OpenWrite 的审查问题才能进入 `novel_revisions_*` 回炉闭环。应用修订后
+   必须复评，再用 `dog-delivery-query` 确认 `closure.closed`。DoG 的 `failure`
+   只负责定位问题，不直接改正文或资产。
+
+## 状态约定
+
+- `qualityScore` 是有可定位正文证据的正向累加分；issue 不直接扣分。
+- `coverage` 单独表达实际完成的评审范围；`inconclusive` 会降低覆盖率。
+- `gateStatus=blocked` 来自 hard-gate 或 critical finding，不改写质量分。
+- `deliveryStatus` 综合质量、覆盖、门禁和正文 SHA 新鲜度；它不是 `passed` 的别名。
+- 37 个 leaf 是 `legacy_check_ids` 查询入口，不是 37 个顶层计分维度。
+
+## 边界
+
+- 不要用 DoG verifier 直接调用 Studio 写入接口。
+- 不要把 warning 自动升级成失败；先展示 evidence，由 `review_gate` 和作者决定。
+- 不要用 `dog_run` 生成、补写或刷新评审；artifact 缺失或 stale 时回到 OpenWrite 流程。

package/presets/openwrite/skills/export-book/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: export-book
+description: 导出。Use when the author asks 导出, 备份, 出书, EPUB, or types /export-book. Preflight first; never use the host /export session-log command for the manuscript.
+---
+
+# 导出
+
+接到已有 `novel_*`。成稿导出与会话日志下载不是同一条命令。
+
+1. `novel_export_preflight`：阅读顺序、结构缺陷、写作目标、评审新鲜度、正文接纳、阻断项与警告。
+2. 向作者说明 `backup`（可带警告下载）与 `delivery`（门禁阻断则不可交付）。
+3. 作者确认后 `novel_export`，原样传入同一 `format`、`purpose` 与 `preflight_revision`。
+
+不要用宿主 `/export` 下载会话日志来代替成稿。完整项目档案走 `novel_project_archive_action`。

package/presets/openwrite/skills/foreshadow/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: foreshadow
+description: 查伏笔。Use when the author asks 查伏笔, 待回收, 超期伏笔, or types /foreshadow. Read chapter obligations and continuity; do not keep a second foreshadow store.
+---
+
+# 查伏笔
+
+接到已有 `novel_*`。伏笔真源是 OpenWrite DAG 与章节工作简报。
+
+1. `novel_status` 看全书待办。
+2. 当前章用 `novel_chapter_work`：到期 `must_resolve`、超期 `overdue`、待埋入 `to_plant`。
+3. 全书未回收与漂移用 `novel_continuity`。
+
+向作者报告分类清单，不要输出内部 JSON 当主界面。写入走 `novel_structured_change_plan(change_kind="foreshadowing")`；仅在作者本轮已授权精确变更时才用 `novel_foreshadowing`。

package/presets/openwrite/skills/foreshadowing-system/SKILL.md

@@ -0,0 +1,125 @@
+---
+name: foreshadowing-system
+description: Use when user wants to manage foreshadowing (伏笔), track story hooks, or check pending reveals. Triggers include "伏笔", "埋伏笔", "待回收", "伏笔状态".
+user-invocable: false
+---
+
+# 伏笔管理系统
+
+管理小说中的伏笔和悬念，确保故事线索连贯。
+
+## 核心概念
+
+伏笔（foreshadowing）是作者在前面章节埋下的线索，后面再回收。
+
+**伏笔状态**：
+- `埋伏` - 已埋下，等待回收
+- `待收` - 即将回收
+- `已收` - 已回收
+- `废弃` - 放弃的伏笔
+
+**伏笔层级**：
+- `主线` - 核心剧情伏笔
+- `支线` - 次要剧情伏笔
+- `彩蛋` - 趣味小彩蛋
+
+## 可用工具
+
+| 工具 | 说明 |
+|------|------|
+| `create_foreshadowing` | 创建伏笔节点 |
+| `list_foreshadowing` | 列出伏笔 |
+| `update_foreshadowing` | 更新伏笔状态 |
+| `validate_foreshadowing` | 验证伏笔DAG |
+
+## 使用示例
+
+### 创建伏笔
+
+```
+用户: 在第三章埋一个伏笔，关于主角的神秘身世
+
+AI: 好的，我来创建一个主线伏笔。
+[COMMAND] create_foreshadowing {
+  "node_id": "f001",
+  "content": "主角发现自己体内有一道封印的神秘力量",
+  "weight": 9,
+  "layer": "主线",
+  "created_at": "ch_003",
+  "target_chapter": "ch_015"
+}
+
+结果: ✅ 伏笔已创建
+- ID: f001
+- 内容: 主角发现自己体内有一道封印的神秘力量
+- 权重: 9
+- 层级: 主线
+- 预期回收: 第15章
+```
+
+### 查看待回收伏笔
+
+```
+用户: 有哪些待回收的伏笔？
+
+AI: 让我查询一下...
+[COMMAND] list_foreshadowing {
+  "status": "待收",
+  "min_weight": 5
+}
+
+结果:
+- f001: 主角身世之谜 (权重9, 主线)
+- f003: 师父的秘密 (权重7, 主线)
+- f005: 神秘玉佩 (权重6, 支线)
+```
+
+### 更新伏笔状态
+
+```
+用户: 第八章回收了 f003 的伏笔，更新状态
+
+AI: 好的
+[COMMAND] update_foreshadowing {
+  "node_id": "f003",
+  "status": "已收"
+}
+
+结果: ✅ f003 状态已更新为「已收」
+```
+
+### 验证伏笔DAG
+
+```
+用户: 检查伏笔有没有问题
+
+AI: 让我验证一下伏笔图...
+[COMMAND] validate_foreshadowing {}
+
+结果:
+- ✅ DAG有效，无环
+- ✅ 无孤立引用
+- ⚠️  提示: 有3个伏笔超期未收
+```
+
+## 创建伏笔的时机
+
+在写作时，AI 应该主动识别并建议创建伏笔：
+
+1. **建立悬念时** - "主角做了一个奇怪的梦..."
+2. **引入神秘元素时** - "某个配角的来历不明..."
+3. **埋下线索时** - "桌上放着一封未拆的信..."
+4. **暗示未来事件时** - "天气预报说三天后会下大雨..."
+
+## 伏笔设计原则
+
+1. **可识别性** - 伏笔要能被读者注意到
+2. **合理性** - 回收时要有合理的解释
+3. **权重分配** - 重要伏笔高权重，主线权重≥7
+4. **时机控制** - 埋设和回收之间要有足够铺垫
+
+## DAG验证规则
+
+1. **无环** - 伏笔之间不能循环依赖
+2. **有向** - 边必须从伏笔指向回收点
+3. **可达** - 每个待收伏笔必须有明确的回收章节

package/presets/openwrite/skills/learn/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: learn
+description: 写法记忆。Use when the author asks 记住写法, 成功钩子, 作者偏好, or types /learn. Store style, hooks, and preferences as Workspace-scoped OpenWrite assets; do not create a second memory store.
+---
+
+# 写法记忆
+
+接到已有 `novel_*`。风格、成功钩子和作者偏好是当前 Workspace 作品资产，不是会话本地文件，也不是第二套 RAG / lorebook。
+
+## 读取
+
+1. `novel_status` 确认当前作品。
+2. 风格与提取源：`novel_source_action`（`status_v2` / `profile_v2`）。
+3. 已登记钩子：`novel_assets_list`，必要时 `novel_asset_read`。
+
+没有 Workspace（session cwd 缺失）时这些工具返回 `WORKSPACE_CONTEXT_MISSING`，不要改写全局或别的项目。
+
+## 写入（预览/确认）
+
+- 作者偏好、必须保留/避免：`novel_structured_change_plan(change_kind="focus")`。
+- 成功钩子与可复用写法：`novel_source_action` extract/review，晋升用 `promote_v2` 且作者确认后 `confirm: true`；登记为资产时用 `novel_structured_change_plan(change_kind="asset")`。
+- 普通讨论不得写入。
+
+细则见 style-system。不要另建记忆文件。

package/presets/openwrite/skills/novel-creator/SKILL.md

@@ -0,0 +1,88 @@
+---
+name: novel-creator
+description: Use when user wants to write chapters, generate drafts, or continue the story. Triggers include "写第", "生成章节", "续写", "草稿", "创作".
+user-invocable: false
+---
+
+# 小说创作编排
+
+通过 openwrite-bridge 的 `novel_*` 工具写章。不要调用 Python 模块、内置 Writer 类或已废弃的大纲命令。
+所有正文写入走预览/确认门控；已有正文不得覆盖。
+
+## 触发条件
+
+- "写第X章" / "写章节"
+- "生成章节" / "生成草稿"
+- "续写" / "继续创作"
+- "创作" + 章节相关
+
+## 工作流程
+
+1. `novel_status` 看项目阶段、资产缺口、待确认项。
+2. `novel_outline_read` 定位章纲：未指定章节时取大纲顺序中最早尚无正文的章；指定章节时校验章纲存在。已有正文则打开或审查，不得直接覆盖。
+3. `novel_context_preview` 预检写章上下文包（大纲窗口、出场角色、伏笔、风格、正典）。
+4. `novel_chapter_work` 读取本章到期/超期/待埋入伏笔与字数目标。
+5. `novel_write_chapter` 写下一章或指定章（可带 `outline_revision` 与 `guidance`）。
+6. 草稿出来后暂停，请作者选择：通过进入评审、按意见重写、或到创作页手工编辑。
+7. 作者通过后调用 `novel_review_chapter`；需要改稿时用 `novel_revision_create_from_review`，确认后再 `novel_revision_apply`。
+
+## 工具
+
+| 工具 | 用途 |
+|------|------|
+| `novel_status` | 项目快照、阶段、缺口 |
+| `novel_outline_read` | 大纲树与建议下一章 |
+| `novel_context_preview` | 写前上下文包 |
+| `novel_chapter_work` | 本章目标、伏笔义务、最近修改 |
+| `novel_write_chapter` | 写章（长耗时） |
+| `novel_review_chapter` | 六域累加评审 |
+| `novel_document_change_plan` | 已有正文的逐项预览/确认修改 |
+| `novel_structured_change_plan` | 大纲/资产/伏笔的逐项预览/确认 |
+
+`novel_doc_write` 与 `novel_outline_edit` 仅在作者本轮已明确授权精确变更时作为直接写入兼容入口。
+
+## 节拍
+
+从大纲读取本章 **dramatic_position**（起/承/转/合/过渡）和内容焦点。
+节拍数量由目标字数决定（3000 以下 2–3 个；3000–5000 为 3–4 个；5000+ 为 4–6 个），写入 `novel_write_chapter` 的 `guidance`。
+
+- **起** → 场景切入 + 悬念铺设 + 角色状态 + 衔接钩子
+- **承** → 推进 + 碰撞 + (伏笔) + 递进
+- **转** → 升级 + 核心决策 + 后果初现
+- **合** → 余波 + 变化确认 + 遗留
+
+## 用户审核（强制）
+
+草稿生成后必须暂停：
+
+```
+章节: {chapter_id}
+字数: {word_count}
+请选择：1 通过并评审  2 按意见重写  3 保存后手工编辑
+```
+
+## 前置条件
+
+| 数据 | 必须？ | 如何确认 |
+|------|--------|----------|
+| 大纲 | 必须 | `novel_outline_read` |
+| 本章出场角色 | 必须 | `novel_context_preview` / `novel_assets_list` |
+| 合成风格 | 建议 | 上下文包 |
+| 伏笔 | 可选 | `novel_chapter_work` 的分类义务 |
+
+资产不齐时先规划补齐，不切换会话。`novel_status` 若显示 `outline_scope` 待确认，先让作者确认大纲范围再写。
+
+## 错误处理
+
+| 情况 | 处理 |
+|------|------|
+| 上下文超限 | 报告 `novel_context_preview` 的压缩/保护原因，不静默丢掉正典 |
+| 章纲缺失 | 回到规划，用 `novel_structured_change_plan(change_kind="outline")` |
+| 已有正文 | 打开或审查；改稿走 `novel_document_change_plan` |
+| 写章失败 | 用 `novel_tasks_list` / `novel_task_get` 查看后台任务，可 `novel_task_retry` |
+
+## 与其他技能
+
+- **novel-reviewer**：写完后评审
+- **workflow-manager**：连写、后台任务、中断恢复
+- **foreshadowing-system**：伏笔 DAG 维护仍走 `novel_structured_change_plan` / `novel_foreshadowing`

package/presets/openwrite/skills/novel-creator/templates/beat_templates.yaml

@@ -0,0 +1,179 @@
+# 节拍模板（章内微结构）
+# 路径: skills/novel-creator/templates/beat_templates.yaml
+#
+# 设计理念:
+#   起承转合在「节」或「篇」层面完成。
+#   章节只是按字数切的最小写作单元，每章 3000-5000 字。
+#   节拍描述的是「这几千字的内部微结构」，
+#   而非独立的开场→高潮→收束（那是节的事）。
+#
+#   章节通过 dramatic_position 字段知道自己在节弧线中的角色:
+#     起 / 承 / 转 / 合 / 过渡
+#   节拍模板按 dramatic_position 选择。
+
+# ── 按戏剧位置选择的节拍模板 ──────────────────────────
+
+# 「起」— 节弧线的开端章节
+position_起:
+  - beat: "场景切入"
+    template: "建立新场景/新时空，{protagonist}进入{setting}"
+    purpose: "让读者快速进入新阶段"
+    length: 400-600
+
+  - beat: "悬念铺设"
+    template: "引入本节核心问题/冲突的端倪"
+    purpose: "让读者产生好奇心"
+    length: 500-800
+
+  - beat: "角色状态"
+    template: "{protagonist}的当前状态与目标，承接前节余韵"
+    purpose: "建立情感基线"
+    length: 300-500
+
+  - beat: "衔接钩子"
+    template: "留下一个引向下一章的小钩子"
+    purpose: "保证读者继续读"
+    length: 200-300
+
+# 「承」— 节弧线的发展章节
+position_承:
+  - beat: "推进"
+    template: "{protagonist}围绕本节目标采取行动"
+    purpose: "推动剧情向前"
+    length: 600-900
+
+  - beat: "碰撞"
+    template: "角色互动/信息揭示/小型冲突"
+    purpose: "制造张力，丰富内容"
+    length: 500-800
+
+  - beat: "伏笔"
+    template: "自然融入伏笔元素{foreshadowing_element}"
+    purpose: "为后续节/篇埋下线索"
+    length: 200-400
+    optional: true
+
+  - beat: "递进"
+    template: "情势变化，比章首更紧张/更复杂/更深入"
+    purpose: "保证信息密度，避免平淡"
+    length: 400-600
+
+# 「转」— 节弧线的转折章节
+position_转:
+  - beat: "升级"
+    template: "局势急剧变化，超出{protagonist}的预期"
+    purpose: "打破读者预期"
+    length: 500-800
+
+  - beat: "核心决策"
+    template: "{protagonist}被迫做出关键选择，付出代价"
+    purpose: "展现角色弧线"
+    length: 600-1000
+
+  - beat: "后果初现"
+    template: "决策的直接后果立刻显现"
+    purpose: "给读者情绪冲击"
+    length: 400-600
+
+# 「合」— 节弧线的收束章节
+position_合:
+  - beat: "余波"
+    template: "核心事件的结果扩散，{protagonist}消化影响"
+    purpose: "让情绪落地"
+    length: 400-600
+
+  - beat: "变化确认"
+    template: "角色/关系/局势的变化被明确"
+    purpose: "让读者确认剧情推进"
+    length: 300-500
+
+  - beat: "遗留"
+    template: "留下未解决的问题或新悬念{cliffhanger}"
+    purpose: "衔接下一节"
+    length: 200-400
+
+# 「过渡」— 节与节之间的过渡章节
+position_过渡:
+  - beat: "收尾"
+    template: "上一节最后的松散线索收拢"
+    purpose: "给读者喘息"
+    length: 300-500
+
+  - beat: "转场"
+    template: "时间/空间/视角的切换"
+    purpose: "自然过渡到新阶段"
+    length: 400-600
+
+  - beat: "预示"
+    template: "暗示下一节的方向"
+    purpose: "保持好奇心"
+    length: 200-400
+
+
+# ── 场景类型覆盖（可叠加在任何 position 上）───────────
+
+scene_overlays:
+  combat:
+    - beat: "对峙"
+      template: "双方对峙，{antagonist}率先发难"
+    - beat: "交锋"
+      template: "激烈战斗，{protagonist}陷入困境"
+    - beat: "决胜"
+      template: "{protagonist}找到破绽或付出代价"
+
+  dialogue:
+    - beat: "交流"
+      template: "{character_a}与{character_b}信息交换"
+    - beat: "交锋"
+      template: "观点分歧，产生矛盾或暗流"
+
+  exploration:
+    - beat: "发现"
+      template: "发现{discovery}，获得线索"
+    - beat: "危险"
+      template: "遭遇{danger}，险象环生"
+
+  revelation:
+    - beat: "线索汇聚"
+      template: "之前的碎片信息拼合"
+    - beat: "真相揭示"
+      template: "核心秘密/真相浮出水面"
+
+
+# ── 生成规则 ──────────────────────────────────────────
+
+generation_rules:
+  # 节拍数量由章节字数决定，不由戏剧结构决定
+  beats_per_chapter:
+    "3000字以下": 2-3
+    "3000-5000字": 3-4
+    "5000字以上": 4-6
+
+  # 伏笔融入规则
+  foreshadowing_rules:
+    - 每章最多融入 1 个待回收伏笔（自然为主）
+    - 伏笔融入位置由 dramatic_position 影响:
+        起/承: 适合埋设伏笔
+        转/合: 适合回收伏笔
+
+  # 节奏控制（章内微观）
+  rhythm_control:
+    - 长短句交替
+    - 对话与叙述平衡
+    - 避免连续 3 个以上长段落
+    - 「转」位置的章节节奏应比「承」更快
+
+
+# ── 变量说明 ──────────────────────────────────────────
+
+variables:
+  protagonist: "主角名称"
+  antagonist: "反派名称"
+  setting: "场景环境"
+  obstacle: "障碍"
+  foreshadowing_element: "伏笔元素"
+  cliffhanger: "悬念/钩子"
+  character_a: "角色A"
+  character_b: "角色B"
+  discovery: "发现内容"
+  danger: "危险"

package/presets/openwrite/skills/novel-creator/templates/example_usage.yaml

@@ -0,0 +1,74 @@
+# 节拍模板使用示例
+# 文件路径: skills/novel-creator/templates/example_usage.yaml
+#
+# 演示如何根据 dramatic_position 选择并填充节拍模板。
+# 实际使用时由 Agent 根据章节大纲的 dramatic_position 字段自动选取。
+
+# ── 示例 1: 「转」位置的章节 ────────────────────────
+
+chapter_example_turn:
+  chapter_id: ch_004
+  title: "第四章：真相大白"
+  dramatic_position: "转"
+  content_focus: "主角发现师门秘密，信念崩塌"
+  estimated_words: 5000
+
+  # 从 position_转 选择的节拍
+  selected_beats:
+    - beat: "升级"
+      filled_template: "陈明发现服务器异常超出预期，数据传输量是平时的百倍——有人在偷偷上传海量文件。"
+      target_length: 500-800
+
+    - beat: "核心决策"
+      filled_template: "陈明必须在举报和沉默之间做出选择。举报意味着得罪整个部门，沉默意味着成为共犯。他握紧了手中的U盘。"
+      target_length: 600-1000
+
+    - beat: "后果初现"
+      filled_template: "消息发出的瞬间，走廊尽头传来急促的脚步声。陈明知道，一切已经不可逆了。"
+      target_length: 400-600
+
+  # 可选：叠加场景类型覆盖
+  scene_overlay: revelation
+  overlay_beats:
+    - beat: "线索汇聚"
+      filled_template: "之前不经意间看到的几份报告，此刻在脑海中拼合成一幅完整的图画。"
+    - beat: "真相揭示"
+      filled_template: "所谓的'系统升级'，不过是一场精心策划的数据窃取。而主导者，正是他最信任的导师。"
+
+
+# ── 示例 2: 「起」位置的章节 ────────────────────────
+
+chapter_example_start:
+  chapter_id: ch_001
+  title: "第一章：平凡的早晨"
+  dramatic_position: "起"
+  content_focus: "建立主角日常，暗示异常"
+  estimated_words: 4000
+
+  selected_beats:
+    - beat: "场景切入"
+      filled_template: "陈明推开宿舍门，走廊里弥漫着食堂的早餐味道。一切和往常没什么两样——至少现在看来是这样。"
+      target_length: 400-600
+
+    - beat: "悬念铺设"
+      filled_template: "手机上有三条未读消息，全来自一个没存过的号码。他随手删掉了前两条，却在第三条的内容前停住了。"
+      target_length: 500-800
+
+    - beat: "角色状态"
+      filled_template: "距离毕业还有三个月，论文进度拉下一大截。陈明边走边想着怎么跟导师解释，完全没注意到身后跟着的那个人影。"
+      target_length: 300-500
+
+    - beat: "衔接钩子"
+      filled_template: "实验楼的门禁记录显示，昨晚两点十七分有人刷了他的卡。但他昨晚十一点就睡了。"
+      target_length: 200-300
+
+
+# ── 使用流程说明 ────────────────────────────────────
+
+usage_guide:
+  step_1: "从章节大纲获取 dramatic_position（起/承/转/合/过渡）"
+  step_2: "查询 beat_templates.yaml 中对应的 position_{位置} 模板列表"
+  step_3: "根据章节目标和角色选取 3-5 个节拍"
+  step_4: "填充模板变量（{protagonist}, {setting}, {foreshadowing_element} 等）"
+  step_5: "可选叠加 scene_overlays（combat/dialogue/exploration/revelation）"
+  step_6: "按节拍顺序写作，每个节拍的长度参考 length 字段"

package/presets/openwrite/skills/novel-reviewer/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: novel-reviewer
+description: Use when user wants to check logic consistency, polish style, find plot holes, or review existing chapters. Triggers include "检查", "润色", "逻辑", "伏笔漏洞", "审查".
+user-invocable: false
+---
+
+# 小说审查润色
+
+通过 openwrite-bridge 的 `novel_*` 工具评审与修订。不要调用 Python 审查类或本地 33 维脚本。
+正式评审是六域累加：质量分、覆盖率、硬门禁、交付状态分开判断；37 项只作展开查询。
+`novel_config.yaml` 的 `form: web_novel` 时，情节/节奏域额外检查钩子、黄金三章、追读力；这些准则 `max=0`，不另起一套评分。黄金三章只适用于第 1–3 章。
+
+## 触发条件
+
+- "检查逻辑" / "逻辑检查"
+- "润色" / "润色风格"
+- "找伏笔漏洞" / "伏笔检查"
+- "审查章节" / "审查"
+- "风格问题"
+
+## 工作流程
+
+1. `novel_outline_read` 与 `novel_status` 确认章节与项目阶段。
+2. `novel_chapter_work` 读取正文 revision、已有评审新鲜度、本章伏笔义务。
+3. `novel_review_framework` 需要时查看六域与 37 项映射。
+4. `novel_review_chapter` 对已有正文跑六域评审（可传 `chapter_id` 或稿件路径）。
+5. 向作者报告质量分、覆盖率、门禁、交付状态，以及带正文证据的问题。
+6. 作者要改稿：`novel_revision_create_from_review`（或选区 `novel_revision_create_selection`）→ 展示 before/after → 确认后 `novel_revision_apply`。
+7. 应用后必须 `novel_review_chapter` 复评；正文 SHA 变了旧评审即 stale。
+8. 润色类局部修改走 `novel_document_change_plan` 预览/确认，不直接整章覆盖。
+
+## 工具
+
+| 工具 | 用途 |
+|------|------|
+| `novel_review_framework` | 六域 / 37 项框架 |
+| `novel_review_chapter` | 正式评审（长耗时） |
+| `novel_chapter_work` | 评审新鲜度、闭合结果、伏笔 |
+| `novel_revision_create_from_review` | 从问题生成修订提案 |
+| `novel_revision_create_selection` | 从选区生成修订 |
+| `novel_revisions_list` / `novel_revision_get` | 查看提案 |
+| `novel_revision_apply` / `novel_revision_reject` / `novel_revision_regenerate` | 应用、驳回、重生成 |
+| `novel_document_change_plan` | 手工/润色类正文预览确认 |
+| `novel_continuity` | 连续性、关系、未回收伏笔 |
+
+## 六域（计分）与硬门禁
+
+| 域 | 权重 | 关注 |
+|---|---:|------|
+| 连贯与逻辑 | 20 | 时间线、因果、信息传播 |
+| 人物与关系 | 15 | 动机、声音、关系 |
+| 情节与承诺 | 20 | 伏笔、支线、情感账单 |
+| 节奏与场景 | 15 | 章内节奏、场景完成度 |
+| 文笔与表达 | 15 | AI 痕迹、信息倾倒、句式 |
+| 正典与引用 | 15 | 设定、专名、前文事实 |
+| 硬门禁 | 不计分 | 严重 blocker；只改 `gate_status` |
+
+问题不扣质量分。`inconclusive` 降低覆盖率。交付要求：质量与覆盖达阈值、门禁未阻断、评审源 SHA 等于当前正文 SHA。
+
+## 报告给作者看的结构
+
+```
+章节 / 字数 / 评审 revision
+质量分 · 覆盖率 · 门禁 · 交付
+证据条目（原文定位 + 建议）
+本章伏笔：到期 / 超期 / 待埋入（来自 novel_chapter_work）
+下一步：生成修订 / 驳回 / 复评
+```
+
+定位不唯一时标记失效，不要把错误原文高亮成证据。过期评审必须先复评。
+
+## 错误处理
+
+| 情况 | 处理 |
+|------|------|
+| 尚无正文 | 提示先写章，不要空审 |
+| 评审 stale | 先 `novel_review_chapter`，禁止对旧问题直接 apply |
+| 提案源 revision 不匹配 | `novel_revision_regenerate` 或重新预览 |
+| 后台任务进行中 | `novel_task_get` 轮询，不要重复提交 |
+
+## 与其他技能
+
+- **novel-creator**：写章后进入本技能
+- **dog-review-query** / **dog-delivery-query**：查询已物化评审/交付图，不重新调用模型
+- **truth-validation**：正典与事实核对