dsh-openwrite 0.2.27 → 0.2.33

package/presets/openwrite/skills/delivery-artifact-query/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: delivery-artifact-query
+description: Query a chapter delivery record across manuscript, review, revision application, and re-review closure. Use after writing or reviewing a chapter, after revision actions, or when the user asks whether a chapter is truly ready to deliver.
+user-invocable: false
+---
+
+Language: follow the author's current conversation language for responses and help; preserve the manuscript language. Translate these instructions when presenting them.
+
+# 章节交付状态查询
+
+章节写作、评审和修订工具会直接返回交付状态，并把同一份记录落盘：
+`data/novels/{id}/data/dog/deliveries/{chapter}/dog-graph.json`。
+它覆盖六个阶段：`writing → review → revision → application → rereview → closure`。
+它不替代 OpenWrite 的写章、六域累加评审或修订服务。
+
+## 查询流程
+
+1. 从最近一次 `novel_write_chapter`、`novel_review_chapter`、`novel_revision`
+   或 `novel_task(action="get")` 结果里的 `dog_delivery` 读状态；需要完整阶段明细时再读
+   上面的 `dog-graph.json`（`stages` 里有每一阶段的 verdict 与 evidence）。
+2. 按 `closure` 的状态给结论（见下表），不要自行推断。
+3. 修订应用后必须重新调用 `novel_review_chapter`；只有复评对应当前正文 SHA 且门禁通过，
+   `closure` 才能成为 `closed`。
+
+## 状态解释
+
+- `review.missing`：正文存在但尚未评审。
+- `closure.review_failed`：当前正文已评审但未通过门禁，进入修订闭环。
+- `revision.proposal_pending`：提案已生成，等待作者确认应用或驳回。
+- `revision.applied_requires_rereview`：修订已写入正文，但不能视为问题已解决。
+- `closure.rereview_required`：必须对修订后的正文重新跑六域评审。
+- `closure.closed`：当前正文的最新评审通过，可以交付。
+
+`readyForDelivery=true` 等价于「当前正文 SHA 的最新复评通过且门禁通过」，
+可以直接作为交付结论；为 `false` 时说明上面某一项未满足。
+
+## 约束
+
+- 只查询 canonical manuscript/review/revision 文件，不直接修改它们。
+- 不因提案状态为 `applied` 就宣称问题关闭；必须以当前正文 SHA 对应的复评为准。
+- 记录缺失时回到 OpenWrite 流程重新评审，不要把上一次的结论说成最新。

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

@@ -19,14 +19,15 @@ Language: follow the author's current conversation language for responses and he
 3. `data/style/composed.md` — 当前作品风格约束
 4. `src/outline.md` / canonical packet — 本章戏剧位置与章节目标
 
-如果需要完整判断某章对白是否失真，优先结合 `review_chapter` 或章节 packet，而不是只看几行台词。
+如果需要完整判断某章对白是否失真，优先结合 `novel_review_chapter` 或 `novel_chapter_work` 的章节 packet，而不是只看几行台词。
 
 ## 可用工具
 
 | 工具 | 说明 |
 |------|------|
-| `extract_dialogue_fingerprint` | 提取角色对白指纹 |
-| `review_chapter` | 对整章做审查，可发现台词失真、解释性对话、套路对白 |
+| `novel_manuscript_metrics(chapter_id=…)` | 章节可量化信号：字数、句长、对白占比等 |
+| `novel_review_chapter(chapter_id=…, domains=["prose","character"])` | 对整章做审查，可发现台词失真、解释性对话、套路对白 |
+| `novel_chapter_work(chapter_id=…)` | 章节工作 brief：戏剧位置、出场角色、章节目标 |
 
 ## 什么时候用
 
@@ -37,26 +38,24 @@ Language: follow the author's current conversation language for responses and he
 
 ## 工作方式
 
-### 1. 提取对白指纹
+### 1. 读取章节信号
 
-先定位章节和角色，再提取：
+先定位章节，再读可量化指标：
 
 ```text
 用户: 分析一下林月在第六章的对话风格
 
-AI:
-[COMMAND] extract_dialogue_fingerprint {
-  "chapter_id": "ch_006",
-  "character_names": ["林月"]
-}
+AI: 调用 novel_manuscript_metrics(chapter_id="ch_006")
 ```
 
-重点观察：
+重点观察返回里的：
 
-- `avg_sentence_length`：句长偏短还是偏长
-- `question_ratio`：疑问句比例
-- `common_bigrams`：高频词组
-- `speech_patterns`：口头禅、重复习惯、语气特征
+- 字数与对白占比：这一章是谁在说话
+- 句长相关指标：偏短还是偏长
+- 出场角色：林月是否真的有戏份
+
+没有工具会直接给出"对白指纹"；上面的指标加上正文摘录就是判断依据。
+需要整章判断时再调用 `novel_review_chapter(chapter_id="ch_006", domains=["prose","character"])`。
 
 ### 2. 结合角色档案复核
 
@@ -163,6 +162,6 @@ AI:
 
 ## 注意
 
-- `extract_dialogue_fingerprint` 适合看“说话指纹”
-- `review_chapter` 适合看“对白放在整章里是否成立”
+- `novel_manuscript_metrics` 提供可量化信号，判断"说话指纹"要靠它加上正文摘录
+- `novel_review_chapter` 适合看“对白放在整章里是否成立”
 - 真要改对白，必须结合人物文档和章节戏剧位置一起判断

package/presets/openwrite/skills/dog-delivery-verification/SKILL.md

@@ -0,0 +1,113 @@
+---
+name: dog-delivery-verification
+description: 用宿主已安装的 dsh-dog（DoG）对 OpenWrite 章节或整书做独立验证。Use when the author asks for DoG / 独立验收 / second-opinion verification before delivery, or when dog_validate, dog_create and dog_run are available and the author wants a judgment that is not the author's own review.
+user-invocable: false
+---
+
+Language: follow the author's current conversation language for responses and help; preserve the manuscript language. Translate these instructions when presenting them.
+
+# DoG 独立验收（OpenWrite → dsh-dog）
+
+这条技能把 OpenWrite 的正文与评审证据交给宿主已安装的 `@dsh-external/dsh-dog`，
+由它用独立 verifier 再判断一次。它不是 OpenWrite 六域评审的替代品，也不修改正文。
+
+先确认工具面真的有 `dog_validate` / `dog_create` / `dog_run`。没有时不要假装跑过：
+说明 dsh-dog 未安装或当前宿主不放行，回到 `novel_review_chapter` 与
+`novel_export(action="preflight")` 的 OpenWrite 门禁。
+
+## 1. 收集被测对象与证据
+
+单章：
+
+1. `novel_outline_read` 与 `novel_status` 定位 `chapter_id`。
+2. `novel_chapter_work` 读取正文 revision、评审新鲜度、本章义务。
+3. `novel_review_chapter(action="versions", chapter_id=...)` 取最新评审；
+   若正文 revision 与评审 revision 不一致，先重新评审，不要把旧评审当证据。
+4. `novel_export(action="preflight", purpose="delivery")` 读取交付门禁和缺口。
+
+整书：先 `novel_status`，再对每个已写章节重复上面的 2–4；不要把未写章节算进范围。
+
+## 2. 建立不可变交付包
+
+在**当前工作区根目录**下创建 `.openwrite/dog-handoff/<handoff-id>/`（示例用 `1`），写入：
+
+- `manuscript.md`：被测正文的逐字副本（单章就是该章；整书按章节分隔）。
+- `evidence.md`：outline 摘要、最新评审的 revision/分数/门禁/问题、交付 preflight 缺口。
+- `graph.json`：下面的 0.9 图。`target` 必须是相对**会话工作区根目录**的路径，不是相对 handoff 目录；
+  root 指向 handoff 目录（dog 会把目录打包捕获），叶子分别指向其中的 `manuscript.md` / `evidence.md`。
+
+用文件工具写，不要用 `novel_doc` 写项目外路径。`handoff-id` 用时间戳或短随机串，
+保留目录供审计；不要把它放进 `data/manuscript/`。
+
+## 3. 图模板
+
+```json
+{
+  "schemaVersion": "0.9",
+  "id": "openwrite-delivery-1",
+  "root": "root",
+  "nodes": {
+    "root": {
+      "kind": "composite",
+      "title": "OpenWrite 交付整体判断",
+      "constraint": "hard",
+      "target": ".openwrite/dog-handoff/1/",
+      "completion": { "op": "all", "items": [
+        { "op": "ref", "id": "continuity" },
+        { "op": "ref", "id": "prose" },
+        { "op": "ref", "id": "canon" },
+        { "op": "ref", "id": "delivery-evidence" }
+      ] },
+      "verifier": {
+        "mode": "agentic",
+        "instruction": "Read manuscript.md and evidence.md in the captured handoff directory. Judge whether the chapter(s) hold together as a deliverable: continuity, prose quality, canon consistency and the claimed delivery evidence. Return pass only when the evidence supports every claim; otherwise fail with the exact gap."
+      }
+    },
+    "continuity": {
+      "kind": "leaf", "title": "连续性", "constraint": "hard", "target": ".openwrite/dog-handoff/1/manuscript.md",
+      "verifier": { "mode": "agentic", "instruction": "Check scene-to-scene continuity in manuscript.md: who is present, where, when, what changed, and whether any action contradicts the previous scene. Cite exact lines." }
+    },
+    "prose": {
+      "kind": "leaf", "title": "文笔", "constraint": "hard", "target": ".openwrite/dog-handoff/1/manuscript.md",
+      "verifier": { "mode": "agentic", "instruction": "Judge prose quality in manuscript.md: viewpoint discipline, concrete detail, dialogue that carries character, and absence of filler or repeated exposition. Cite exact lines." }
+    },
+    "canon": {
+      "kind": "leaf", "title": "正典一致性", "constraint": "hard", "target": ".openwrite/dog-handoff/1/manuscript.md",
+      "verifier": { "mode": "agentic", "instruction": "Check manuscript.md against the facts in evidence.md: names, world rules, timeline and stated canon. Report any contradiction with the exact conflicting lines." }
+    },
+    "delivery-evidence": {
+      "kind": "leaf", "title": "交付证据", "constraint": "hard", "target": ".openwrite/dog-handoff/1/evidence.md",
+      "verifier": { "mode": "agentic", "instruction": "Check whether evidence.md actually supports delivery: review revision matches the manuscript, gate status is pass, and no listed preflight gap remains. Do not accept a claim that is not backed by the evidence text." }
+    }
+  },
+  "contains": [
+    { "parent": "root", "child": "continuity", "required": true, "failure": "fatal" },
+    { "parent": "root", "child": "prose", "required": true, "failure": "fatal" },
+    { "parent": "root", "child": "canon", "required": true, "failure": "fatal" },
+    { "parent": "root", "child": "delivery-evidence", "required": true, "failure": "fatal" }
+  ],
+  "dependsOn": []
+}
+```
+
+每次 handoff 必须把示例里的 `1` 同时替换成同一个唯一值（graph.id 与所有 target），
+否则第二次 `dog_create` 会和上一张图撞 id。`dog_create` 在**会话工作区根目录**调用；
+上面的 target 已经带上 `.openwrite/dog-handoff/1/`，不需要先 cd 进 handoff 目录。
+如果只验单章，删掉整书范围描述即可，不要为了凑节点加空 verifier。
+
+## 4. 运行与报告
+
+1. `dog_validate(graph)`：先只校验，不运行；有 schema 错误按返回信息修。
+2. `dog_create(graph)`：捕获不可变副本，记下 graphId。
+3. `dog_run(graphId)`，然后 `dog_wait` 或轮询 `dog_status`，直到终态。
+4. 逐节点报告 verdict 与 evidence；`needs_human` 原样交给作者，不猜。
+5. 根节点通过才说“DoG 独立验收通过”。任何 fatal / needs_human 都必须说明具体子目标。
+
+## 约束
+
+- DoG 只读捕获副本；不要用 DoG 的结论直接改正文。要改稿走
+  `novel_change_plan` / `novel_revision` 的预览与确认流程。
+- 不把 OpenWrite 自己的 `dog_review` / `dog_delivery` 产物冒充 dsh-dog 的运行结果；
+  两者不是同一个引擎。
+- 不因 `dog_*` 工具存在就自动跑模型；先向作者说明将调用独立 verifier（会产生模型调用），
+  得到同意再运行。

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

@@ -9,8 +9,8 @@ Language: follow the author's current conversation language for responses and he
 
 接到已有 `novel_*`。成稿导出与会话日志下载不是同一条命令。
 
-1. `novel_export_preflight`：阅读顺序、结构缺陷、写作目标、评审新鲜度、正文接纳、阻断项与警告。
-2. 向作者说明 `backup`（可带警告下载）与 `delivery`（门禁阻断则不可交付）。
+1. `novel_export(action="preflight"`：阅读顺序、结构缺陷、写作目标、评审新鲜度、正文接纳、阻断项与警告。
+2. 向作者说明三种 `purpose`：`personal_archive`（作者自留，可带警告下载，**不代表通过交付门禁**）、`backup`、`delivery`（门禁阻断则不可交付）。
 3. 作者确认后 `novel_export`，原样传入同一 `format`、`purpose` 与 `preflight_revision`。
 
-不要用宿主 `/export` 下载会话日志来代替成稿。完整项目档案走 `novel_project_archive_action`。
+不要用宿主 `/export` 下载会话日志来代替成稿。完整项目档案走 `novel_project(action="archive", archive_op="preflight"` → `archive_op="create"`（需带 `expected_preflight_revision`）→ 需要时 `archive_op="restore_preview"` / `archive_op="restore"`。

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

@@ -13,4 +13,4 @@ Language: follow the author's current conversation language for responses and he
 2. 当前章用 `novel_chapter_work`：到期 `must_resolve`、超期 `overdue`、待埋入 `to_plant`。
 3. 全书未回收与漂移用 `novel_continuity`。
 
-向作者报告分类清单，不要输出内部 JSON 当主界面。写入走 `novel_structured_change_plan(change_kind="foreshadowing")`；仅在作者本轮已授权精确变更时才用 `novel_foreshadowing`。
+向作者报告分类清单，不要输出内部 JSON 当主界面。写入走 `novel_change_plan(action="structured"(change_kind="foreshadowing")`；仅在作者本轮已授权精确变更时才用 `novel_foreshadowing`。

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

@@ -29,10 +29,10 @@ Language: follow the author's current conversation language for responses and he
 
 | 工具 | 说明 |
 |------|------|
-| `create_foreshadowing` | 创建伏笔节点 |
-| `list_foreshadowing` | 列出伏笔 |
-| `update_foreshadowing` | 更新伏笔状态 |
-| `validate_foreshadowing` | 验证伏笔DAG |
+| `novel_foreshadowing(action="create")` | 创建伏笔节点（仅作者本轮已授权该精确变更时的一次性写入） |
+| `novel_foreshadowing(action="update")` | 更新伏笔状态 |
+| `novel_change_plan(action="structured", change_kind="foreshadowing", step="preview"/"apply")` | 伏笔 DAG 的逐项预览/确认维护（**默认路径**） |
+| `novel_continuity` | 未回收伏笔、人物状态漂移、时间线一致性报告 |
 
 ## 使用示例
 
@@ -41,15 +41,11 @@ Language: follow the author's current conversation language for responses and he
 ```
 用户: 在第三章埋一个伏笔，关于主角的神秘身世
 
-AI: 好的，我来创建一个主线伏笔。
-[COMMAND] create_foreshadowing {
-  "node_id": "f001",
-  "content": "主角发现自己体内有一道封印的神秘力量",
-  "weight": 9,
-  "layer": "主线",
-  "created_at": "ch_003",
-  "target_chapter": "ch_015"
-}
+AI: 好的，伏笔 DAG 的维护走变更计划两阶段确认。
+先 `novel_change_plan(action="structured", change_kind="foreshadowing", step="preview", change={…})`，
+把 diff 展示给作者；作者确认后才 `step="apply"` 并传回 `preview_token`。
+仅当作者在本轮已明确授权这条精确变更时，才可用直接入口
+`novel_foreshadowing(action="create", node_id="f001", content="主角发现自己体内有一道封印的神秘力量", weight=9, layer="主线", target_chapter="ch_015")`。
 
 结果: ✅ 伏笔已创建
 - ID: f001
@@ -64,11 +60,8 @@ AI: 好的，我来创建一个主线伏笔。
 ```
 用户: 有哪些待回收的伏笔？
 
-AI: 让我查询一下...
-[COMMAND] list_foreshadowing {
-  "status": "待收",
-  "min_weight": 5
-}
+AI: 让我读一下连续性报告……
+调用 `novel_continuity`（无参数，项目级）。
 
 结果:
 - f001: 主角身世之谜 (权重9, 主线)
@@ -81,11 +74,9 @@ AI: 让我查询一下...
 ```
 用户: 第八章回收了 f003 的伏笔，更新状态
 
-AI: 好的
-[COMMAND] update_foreshadowing {
-  "node_id": "f003",
-  "status": "已收"
-}
+AI: 同样走两阶段确认：`novel_change_plan(action="structured", change_kind="foreshadowing", step="preview", change={…})`
+→ 展示 → `step="apply"`。作者本轮已授权时可用
+`novel_foreshadowing(action="update", node_id="f003", status="paid-off")`。
 
 结果: ✅ f003 状态已更新为「已收」
 ```
@@ -95,8 +86,8 @@ AI: 好的
 ```
 用户: 检查伏笔有没有问题
 
-AI: 让我验证一下伏笔图...
-[COMMAND] validate_foreshadowing {}
+AI: 让我读一下连续性报告……
+调用 `novel_continuity`（无参数，项目级）。
 
 结果:
 - ✅ DAG有效，无环

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

@@ -0,0 +1,30 @@
+---
+name: import-artifact-query
+description: Query a smart-import record 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
+---
+
+Language: follow the author's current conversation language for responses and help; preserve the manuscript language. Translate these instructions when presenting them.
+
+# 拆书导入结果查询
+
+`conductor/smart_import.py` 完成导入后会写出记录：
+`data/novels/{id}/data/dog/imports/{IMPORT_ID}/dog-graph.json`，
+以及同目录的 manifest。这份记录只描述导入结果，不负责写入章节、资产或大纲。
+
+## 工作流
+
+1. 从导入输出找到 `data/novels/{id}/data/dog/imports/{IMPORT_ID}/`，读 manifest。
+2. 按 manifest 的 `status` 汇报导入完整性：`partial|failed` 表示导入中途出错，
+   先读 `error` 和已完成的章节，再修复或重试导入。
+3. 读 `aiCheck.status`：`failed` 要如实报告，不能当成“无问题”。
+4. 根节点通过后，读 manifest 的 `construction.nextActions`，再调用规划和资产工具
+   建立大纲、角色、世界观、进度和正典事件。
+5. 资产/大纲建立完成后重新调用 `novel_review_chapter`，再用 `review-artifact-query`
+   查询六域评审和 37 个 legacy leaf。
+
+## 约束
+
+- 只读导入记录，不直接修改正文。
+- `construction` 中的 `pending` 是后续建模待办，不是导入失败。
+- 不要让任何验证步骤再调用 Studio 导入接口或重新读取原始整本小说。

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

@@ -13,14 +13,14 @@ Language: follow the author's current conversation language for responses and he
 
 1. `novel_status` 确认当前作品。
 2. 风格与提取源：`novel_source_action`（`status_v2` / `profile_v2`）。
-3. 已登记钩子：`novel_assets_list`，必要时 `novel_asset_read`。
+3. 已登记钩子：`novel_assets(action="list"`，必要时 `novel_assets(action="read", kind="character"|"world"|"progression", id=…)`。
 
 没有 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")`。
+- 作者偏好、必须保留/避免：`novel_change_plan(action="structured"(change_kind="focus")`。
+- 成功钩子与可复用写法：`novel_source_action` extract/review，晋升用 `promote_v2` 且作者确认后 `confirm: true`；登记为资产时用 `novel_change_plan(action="structured"(change_kind="asset")`。
 - 普通讨论不得写入。
 
 细则见 style-system。不要另建记忆文件。

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

@@ -21,12 +21,12 @@ Language: follow the author's current conversation language for responses and he
 ## 工作流程
 
 1. `novel_status` 看项目阶段、资产缺口、待确认项。
-2. `novel_outline_read` 定位章纲：未指定章节时取大纲顺序中最早尚无正文的章；指定章节时校验章纲存在。已有正文则打开或审查，不得直接覆盖。
+2. `novel_outline_read` 定位章纲并读 `recommendation`：未指定章节时省略 `chapter_id`，让服务端取推荐下一章（自行推算的 id 与推荐不一致会被拒绝）；作者点名章节时才传 `chapter_id`，并先用 `recommendation` 校验一致。已有正文则打开或审查，不得直接覆盖。
 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`。
+7. 作者通过后调用 `novel_review_chapter`；需要改稿时用 `novel_revision(action="create", source="review"`，确认后再 `novel_revision(action="apply"`。
 
 ## 工具
 
@@ -38,10 +38,10 @@ Language: follow the author's current conversation language for responses and he
 | `novel_chapter_work` | 本章目标、伏笔义务、最近修改 |
 | `novel_write_chapter` | 写章（长耗时） |
 | `novel_review_chapter` | 六域累加评审 |
-| `novel_document_change_plan` | 已有正文的逐项预览/确认修改 |
-| `novel_structured_change_plan` | 大纲/资产/伏笔的逐项预览/确认 |
+| `novel_change_plan(action="document"` | 已有正文的逐项预览/确认修改 |
+| `novel_change_plan(action="structured"` | 大纲/资产/伏笔的逐项预览/确认 |
 
-`novel_doc_write` 与 `novel_outline_edit` 仅在作者本轮已明确授权精确变更时作为直接写入兼容入口。
+`novel_doc(action="write"` 与 `novel_outline_edit` 仅在作者本轮已明确授权精确变更时作为直接写入兼容入口。
 
 ## 节拍
 
@@ -68,7 +68,7 @@ Language: follow the author's current conversation language for responses and he
 | 数据 | 必须？ | 如何确认 |
 |------|--------|----------|
 | 大纲 | 必须 | `novel_outline_read` |
-| 本章出场角色 | 必须 | `novel_context_preview` / `novel_assets_list` |
+| 本章出场角色 | 必须 | `novel_context_preview` / `novel_assets(action="list"` |
 | 合成风格 | 建议 | 上下文包 |
 | 伏笔 | 可选 | `novel_chapter_work` 的分类义务 |
 
@@ -79,12 +79,12 @@ Language: follow the author's current conversation language for responses and he
 | 情况 | 处理 |
 |------|------|
 | 上下文超限 | 报告 `novel_context_preview` 的压缩/保护原因，不静默丢掉正典 |
-| 章纲缺失 | 回到规划，用 `novel_structured_change_plan(change_kind="outline")` |
-| 已有正文 | 打开或审查；改稿走 `novel_document_change_plan` |
-| 写章失败 | 用 `novel_tasks_list` / `novel_task_get` 查看后台任务，可 `novel_task_retry` |
+| 章纲缺失 | 回到规划，用 `novel_change_plan(action="structured"(change_kind="outline")` |
+| 已有正文 | 打开或审查；改稿走 `novel_change_plan(action="document"` |
+| 写章失败 | 用 `novel_task(action="list"` / `novel_task(action="get"` 查看后台任务，可 `novel_task(action="retry"` |
 
 ## 与其他技能
 
 - **novel-reviewer**：写完后评审
 - **workflow-manager**：连写、后台任务、中断恢复
-- **foreshadowing-system**：伏笔 DAG 维护仍走 `novel_structured_change_plan` / `novel_foreshadowing`
+- **foreshadowing-system**：伏笔 DAG 维护仍走 `novel_change_plan(action="structured"` / `novel_foreshadowing`

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

@@ -8,7 +8,7 @@ Language: follow the author's current conversation language for responses and he
 
 # 小说审查润色
 
-通过 openwrite-bridge 的 `novel_*` 工具评审与修订。不要调用 Python 审查类或本地 33 维脚本。
+通过 openwrite-bridge 的 `novel_*` 工具评审与修订。不要调用 Python 审查类或本地 37 项脚本。
 正式评审是六域累加：质量分、覆盖率、硬门禁、交付状态分开判断；37 项只作展开查询。
 `novel_config.yaml` 的 `form: web_novel` 时，情节/节奏域额外检查钩子、黄金三章、追读力；这些准则 `max=0`，不另起一套评分。黄金三章只适用于第 1–3 章。
 
@@ -27,9 +27,9 @@ Language: follow the author's current conversation language for responses and he
 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`。
+6. 作者要改稿：`novel_revision(action="create", source="review"`（或选区 `novel_revision(action="create", source="selection"`）→ 展示 before/after → 确认后 `novel_revision(action="apply"`。
 7. 应用后必须 `novel_review_chapter` 复评；正文 SHA 变了旧评审即 stale。
-8. 润色类局部修改走 `novel_document_change_plan` 预览/确认，不直接整章覆盖。
+8. 润色类局部修改走 `novel_change_plan(action="document"` 预览/确认，不直接整章覆盖。
 
 ## 工具
 
@@ -38,11 +38,11 @@ Language: follow the author's current conversation language for responses and he
 | `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_revision(action="create", source="review"` | 从问题生成修订提案 |
+| `novel_revision(action="create", source="selection"` | 从选区生成修订 |
+| `novel_revision(action="list"` / `novel_revision(action="get"` | 查看提案 |
+| `novel_revision(action="apply"` / `novel_revision(action="reject"` / `novel_revision(action="regenerate"` | 应用、驳回、重生成 |
+| `novel_change_plan(action="document"` | 手工/润色类正文预览确认 |
 | `novel_continuity` | 连续性、关系、未回收伏笔 |
 
 ## 六域（计分）与硬门禁
@@ -77,11 +77,11 @@ Language: follow the author's current conversation language for responses and he
 |------|------|
 | 尚无正文 | 提示先写章，不要空审 |
 | 评审 stale | 先 `novel_review_chapter`，禁止对旧问题直接 apply |
-| 提案源 revision 不匹配 | `novel_revision_regenerate` 或重新预览 |
-| 后台任务进行中 | `novel_task_get` 轮询，不要重复提交 |
+| 提案源 revision 不匹配 | `novel_revision(action="regenerate"` 或重新预览 |
+| 后台任务进行中 | `novel_task(action="get"` 轮询，不要重复提交 |
 
 ## 与其他技能
 
 - **novel-creator**：写章后进入本技能
-- **dog-review-query** / **dog-delivery-query**：查询已物化评审/交付图，不重新调用模型
+- **review-artifact-query** / **delivery-artifact-query**：查询已物化评审/交付记录，不重新调用模型
 - **truth-validation**：正典与事实核对

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

@@ -11,7 +11,7 @@ Language: follow the author's current conversation language for responses and he
 
 1. `novel_status`：当前作品、阶段、资产缺口、待确认项。
 2. 需要章级细节时 `novel_chapter_work`。
-3. 后台工作 `novel_tasks_list`；进行中或待确认的任务 `novel_task_get`。
+3. 后台工作 `novel_task(action="list"`；进行中或待确认的任务 `novel_task(action="get"`。
 
 向作者报告：当前章、正文是否存在、评审是否新鲜、任务 phase、伏笔到期/超期/待埋入计数。不要把内部 JSON 当主界面。
 

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

@@ -0,0 +1,41 @@
+---
+name: review-artifact-query
+description: Query an existing hierarchical OpenWrite review-v2 artifact. 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 this skill.
+user-invocable: false
+---
+
+Language: follow the author's current conversation language for responses and help; preserve the manuscript language. Translate these instructions when presenting them.
+
+# 分层评审产物查询
+
+这个 Skill 只查询 OpenWrite 已物化的 review-v2 artifact。OpenWrite 的
+`novel_review_chapter` / conductor 是评审真源；本 Skill 直接读同一批产物：
+`review.json`、`context.json`、`domain-*.json`、`gate.json`、`aggregate.json` 和
+`dim_01.json` … `dim_37.json`。它不调用评审模型，也不改写任何产物。
+
+## 查询流程
+
+1. 如果本轮还没有评审结果，先按 OpenWrite 写作流程调用 `novel_review_chapter`。
+2. 从评审输出（或工具响应里的 `dog_review`）找到产物目录；`review.json` 与
+   `domain-*.json`、`gate.json`、`aggregate.json`、`dim_01.json` … `dim_37.json`
+   在同一目录。
+3. 读取 `aggregate.json` 汇报 `qualityScore`、`coverage`、`gateStatus` 和
+   `deliveryStatus`，再按需展开域、criterion、evidence、issue 和 legacy ID。
+   `inconclusive` 表示覆盖不足、未请求或 artifact 不可判定，不能描述为通过。
+4. 只有 OpenWrite 的审查问题才能进入 `novel_revision` 回炉闭环。应用修订后
+   必须复评，再用 `delivery-artifact-query` 确认 closure 已关闭。评审的 `failure`
+   只负责定位问题，不直接改正文或资产。
+
+## 状态约定
+
+- `qualityScore` 是有可定位正文证据的正向累加分；issue 不直接扣分。
+- `coverage` 单独表达实际完成的评审范围；`inconclusive` 会降低覆盖率。
+- `gateStatus=blocked` 来自 hard-gate 或 critical finding，不改写质量分。
+- `deliveryStatus` 综合质量、覆盖、门禁和正文 SHA 新鲜度；它不是 `passed` 的别名。
+- 37 个 leaf 是 `legacy_check_ids` 查询入口，不是 37 个顶层计分维度。
+
+## 边界
+
+- 只读：不调用 Studio 写入接口，不重新生成、补写或刷新评审。
+- artifact 缺失或 stale 时回到 OpenWrite 流程重新评审，不要把旧结果说成最新。
+- 不要把 warning 自动升级成失败；先展示 evidence，由 `gate.json` / `aggregate.json` 里的 `gateStatus` 和作者决定。

package/presets/openwrite/skills/review-chapter/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: review-chapter
-description: 审这一章。Use when the author asks 审这一章, 审查, 检查逻辑, or types /review-chapter. Run six-domain novel_review_chapter; do not rerun review from DoG.
+description: 审这一章。Use when the author asks 审这一章, 审查, 检查逻辑, or types /review-chapter. Run six-domain novel_review_chapter; do not rerun review from the query skills.
 ---
 
 Language: follow the author's current conversation language for responses and help; preserve the manuscript language. Translate these instructions when presenting them.
@@ -16,4 +16,4 @@ Language: follow the author's current conversation language for responses and he
 4. `novel_review_chapter` 跑六域评审。
 5. 向作者报告质量分、覆盖率、门禁、交付状态，以及带正文证据的问题。
 
-作者要改稿时转到 /revise-span。查询已物化评审图用 dog-review-query，不要让 DoG 再调模型。细则见 novel-reviewer。
+作者要改稿时转到 /revise-span。查询已物化评审图用 review-artifact-query，它只读产物、不会再调模型。细则见 novel-reviewer。

package/presets/openwrite/skills/revise-span/SKILL.md

@@ -9,10 +9,10 @@ Language: follow the author's current conversation language for responses and he
 
 接到已有 `novel_*`。改稿只走修订提案，不直接整章覆盖。
 
-1. 选区扩写/缩写/去 AI 味：`novel_revision_create_selection`。
-2. 按审稿改：`novel_revision_create_from_review`（带 issue 与期望 revision）。
-3. 展示 before/after；作者确认后 `novel_revision_apply`（可带 `selected_hunk_ids`）。
-4. 提案 `source_revision` 与当前正文不一致时拒绝覆盖，改为 `novel_revision_regenerate` 或重新预览。
+1. 选区扩写/缩写/去 AI 味：`novel_revision(action="create", source="selection"`。
+2. 按审稿改：`novel_revision(action="create", source="review"`（带 issue 与期望 revision）。
+3. 展示 before/after；作者确认后 `novel_revision(action="apply"`（可带 `selected_hunk_ids`）。
+4. 提案的 `source_revision` 与当前正文不一致时拒绝覆盖，改为 `novel_revision(action="regenerate", proposal_id=…)`；仍不匹配就用 `novel_revision(action="create", source="review"/"selection", …)` 生成新提案。该工具没有「重新预览」这一步。
 5. 应用后必须 `novel_review_chapter` 复评。
 
-手工/润色类正文预览用 `novel_document_change_plan`。没有当前评审时，按审稿改失败闭合。细则见 novel-reviewer。
+手工/润色类正文预览用 `novel_change_plan(action="document"`。没有当前评审时，按审稿改失败闭合。细则见 novel-reviewer。

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

@@ -121,13 +121,20 @@ front matter 放：
 - negative_rules
 - promotion_notes
 
-## 当前命令口径
+## 当前工具口径
 
-- `openwrite style extract <source_id> --source <file>`
-- `openwrite setting extract <source_id> --source <file>`
-- `openwrite source review <source_id>`
-- `openwrite source promote <source_id> --target all`
-- `openwrite style synthesize`
+一律走 `novel_source_action`，没有 `openwrite` 命令行（本插件只发行
+`openwrite-maintenance` 与 `openwrite-safe-upgrade` 两个维护脚本）：
+
+- 提取风格信号：`novel_source_action(action="analyze_v2", source_id=…, content=<原文>, focus=["style"])`
+- 提取设定提要：`novel_source_action(action="analyze_v2", source_id=…, content=<原文>, focus=["setting"])`
+- 查看提取状态：`novel_source_action(action="status_v2", source_id=…)`
+- 复审：`novel_source_action(action="review", source_id=…)`
+- 晋升预览：`novel_source_action(action="promotion_preview_v2", profile_id=…, target=…)`
+- 执行晋升：`novel_source_action(action="promote_v2", preview_id=…, confirm=true)`
+- 综合风格：`novel_source_action(action="synthesize_v2", source_ids=[…])`
+
+带 `confirm` 的动作必须先预览再执行；模型侧动作是长时的，见任务页。
 
 其中 `source promote --target all` 会把：
 - style 信号晋升到当前 `style_id`