dsh-openwrite 0.2.8

package/plugin.d.ts

@@ -0,0 +1,3 @@
+import type { Context } from '@deepseek-ai/cordis'
+export declare const name: 'dsh-openwrite'
+export declare function apply(ctx: Context): Promise<void>

package/plugin.mjs

@@ -0,0 +1,80 @@
+import { cp, lstat, mkdir, readFile, readdir, rename, rm, writeFile } from 'node:fs/promises'
+import { createHash, randomUUID } from 'node:crypto'
+import { lock } from 'proper-lockfile'
+import { resolveDshHome } from '@deepseek-ai/dsh-home-paths'
+import { join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+export const name = 'dsh-openwrite'
+
+async function digestTree(dir) {
+  const hash = createHash('sha256')
+  async function visit(path, prefix = '') {
+    for (const entry of (await readdir(path, { withFileTypes: true })).sort((a, b) => a.name.localeCompare(b.name))) {
+      if (entry.name === '.openwrite-managed.json') continue
+      const key = prefix + entry.name
+      hash.update(key)
+      if (entry.isDirectory()) await visit(join(path, entry.name), key + '/')
+      else hash.update(await readFile(join(path, entry.name)))
+    }
+  }
+  await visit(dir)
+  return hash.digest('hex')
+}
+
+/** A versioned preset leaves existing authored copies and session identities alone. */
+export async function apply(ctx) {
+  const home = resolveDshHome()
+  const source = fileURLToPath(new URL('./presets/openwrite/', import.meta.url))
+  const version = JSON.parse(await readFile(new URL('./package.json', import.meta.url), 'utf8')).version
+  const id = `openwrite-${version.replace(/[^a-z0-9-]/g, '-')}`
+  const destination = join(home, '.agent-presets', id)
+  const managedRoot = join(home, 'openwrite')
+  const leases = join(managedRoot, 'preset-leases', id)
+  await mkdir(leases, { recursive: true })
+  await mkdir(join(home, '.agent-presets'), { recursive: true })
+  const lease = join(leases, `${process.pid}-${randomUUID()}.json`)
+  const withLock = async operation => {
+    const release = await lock(leases, { realpath: false, stale: 30_000, retries: { retries: 30, minTimeout: 100, maxTimeout: 500 } })
+    try { return await operation() } finally { await release() }
+  }
+  const expected = await digestTree(source)
+  const marker = join(destination, '.openwrite-managed.json')
+  await withLock(async () => {
+    const existing = await readFile(marker, 'utf8').then(JSON.parse).catch(() => null)
+    if (existing && (existing.source !== expected || existing.tree !== await digestTree(destination))) {
+      throw new Error(`OpenWrite preset ${id} was modified; copy it to a custom preset before reinstalling this version`)
+    }
+    if (!existing) {
+      if (await lstat(destination).then(() => true).catch(error => { if (error.code === 'ENOENT') return false; throw error })) {
+        throw new Error(`OpenWrite preset ${id} already exists without an ownership marker; preserve it under a custom preset name first`)
+      }
+      const staging = join(managedRoot, 'preset-' + randomUUID())
+      await mkdir(staging, { recursive: true })
+      try {
+        await cp(source, staging, { recursive: true })
+        await writeFile(join(staging, '.openwrite-managed.json'), JSON.stringify({ source: expected, tree: expected, version }))
+        await rename(staging, destination)
+      } finally { await rm(staging, { recursive: true, force: true }) }
+    }
+    await writeFile(lease, JSON.stringify({ pid: process.pid }), { mode: 0o600 })
+  })
+  // Preset files are package-managed UI entries. Remove only our unmodified
+  // copy after its last live host stops; authored copies and session logs remain.
+  ctx.effect(() => async () => withLock(async () => {
+    await rm(lease, { force: true })
+    for (const entry of await readdir(leases)) {
+      const file = join(leases, entry)
+      try {
+        const record = JSON.parse(await readFile(file, 'utf8'))
+        try { process.kill(record.pid, 0) }
+        catch (error) { if (error.code === 'ESRCH') await rm(file, { force: true }) }
+      } catch { /* unknown files never grant deletion authority */ }
+    }
+    if ((await readdir(leases)).length !== 0) return
+    const owned = await readFile(marker, 'utf8').then(JSON.parse).catch(() => null)
+    if (owned?.source === expected && owned.tree === await digestTree(destination).catch(() => null)) {
+      await rm(destination, { recursive: true })
+    }
+  }))
+}

package/presets/README.md

@@ -0,0 +1,32 @@
+# dsh agent 预设：OpenWrite 创作
+
+本目录存放 dsh-Openwrite 的 OpenWrite 创作 agent 预设，把原先的 Goethe 规划与 Dante
+写作职责合并到一个长期会话中。
+
+## 预设说明
+
+- `openwrite/`（OpenWrite 创作，order 10）：统一的长期会话 Agent。按项目阶段在
+  规划、资产维护、正文写作、评审与修订之间切换；所有写入仍走预览/确认门控。
+
+统一预设以 dsh shipped `standard` 预设的组合为基座（保留文件/Shell/检索/
+todo/plan/compaction/委派能力），叠加：
+
+- persona 行（`@deepseek-ai/dsh-persona`，移植自 OpenWrite 的
+  `DEFAULT_GOETHE_SYSTEM_PROMPT` / `DEFAULT_DANTE_SYSTEM_PROMPT`，
+  大纲写入契约、内联批注契约、角色文档契约已内联全文）；
+- host profile 统一挂载的 `openwrite-bridge`（`@dsh-novel/openwrite-bridge`，注册
+  `novel_*` 工具）；它不再重复写入每个 preset，否则会触发 `novelDomain` 服务冲突；
+- `skill-filesystem` 的 `customSkillDirs` 指向预设自带的 `skills/` 目录
+  （`!!js new URL('skills/', baseUrl)` 写法，预设被复制后仍能解析）；
+  斜杠菜单只保留作者入口（`progress` 看进度、`write-next` 写下一章、
+  `review-chapter` 审这一章、`revise-span` 改这段、`foreshadow` 查伏笔、
+  `canon` 查设定、`learn` 写法记忆、`export-book` 导出），其余技能 `user-invocable: false`。
+
+## 安装与修改
+
+预设由 `scripts/install.sh` 复制到 dsh 的用户预设根 `~/.dsh/.agent-presets/`。
+dsh 预设是 **copy-only** 语义：安装后请在**本仓库**里修改，再重新运行
+`scripts/install.sh` 安装；不要直接编辑 `~/.dsh/.agent-presets/` 下的副本。
+会话已产生内容后不能切换预设，改动对新会话生效。
+
+`openwrite/skills/` 是原 Goethe/Dante 技能的并集副本（非符号链接），保证复制安装后自包含。

package/presets/openwrite/agent.cordis.yml

@@ -0,0 +1,317 @@
+# The `openwrite` agent preset: OpenWrite 全流程创作 Agent（长期会话），合并
+# 原 Goethe 规划与 Dante 写作职责。组合结构以 dsh shipped `standard` 预设为基座，
+# 使用 host profile 已注册的 openwrite-bridge（novel_* 工具）和本预设自带的技能目录。
+#
+# 规则提醒（来自 dsh agent-presets README）：任何发布服务的行必须放在带
+# `isolate` realm 的 cordis:group 内；本文件中的 planning/compaction/delegation
+# 分组原样沿用 standard 的写法。persona / skill 等行只向注册表登记，
+# 不发布服务，无需 realm。
+
+# ── identity ────────────────────────────────────────────────────────────────
+
+# 预设自己的 persona，遮蔽部署默认 persona（complete 默认 false，叠加在
+# harness 身份开场之上，与 standard 预设的用法一致）。
+- id: persona
+  name: '@deepseek-ai/dsh-persona'
+  config:
+    text: &openwrite_persona |-
+      你是 OpenWrite 创作 Agent，运行在 DeepSeek Harness（dsh）的统一 OpenWrite 预设中。
+      你通过 openwrite-bridge 插件提供的 novel_* 工具读写 OpenWrite 小说项目
+      （底层走 OpenWrite Studio 的 HTTP 动作面），同时保留 dsh 的文件、Shell、检索等基础能力。
+
+      你同时承担规划与正文创作职责。根据项目阶段在“规划模式”和“写作模式”之间切换，
+      不要求用户切换会话或 Agent。领域读写只用 openwrite-bridge 的 novel_* 工具，
+      不另建进度、伏笔或设定存储。
+
+      默认工作流与作者入口（斜杠命令与口语同义）：
+      - /progress 看进度
+      - /write-next 写下一章
+      - /review-chapter 审这一章
+      - /revise-span 改这段
+      - /foreshadow 查伏笔
+      - /canon 查设定
+      - /learn 写法记忆
+      - /export-book 导出
+      顺序：看进度 → 写下一章 → 审这一章 → 必要时改这段；查伏笔/查设定/写法记忆按需；导出前先预检。
+      用户说出这些说法或键入对应斜杠时，先加载同名技能再行动。宿主 /export 是会话日志，不是成稿导出。
+      写法记忆随当前 Workspace 的 OpenWrite 资产走，不另建记忆库。
+
+      规划模式：当项目未初始化、作者意图/人物/设定/大纲存在缺口，或用户要求构思与规划时，
+      先读取 novel_status、novel_outline_read、novel_search 和相关资产；直接生成草案，
+      所有资产与大纲写入都遵循“预览 diff → 用户明确确认 → 应用”的门控。普通讨论不得写入。
+      写作模式：当目标章节具备已确认章纲和上下文时，先 novel_outline_read 再
+      novel_context_preview，然后写章、评审、必要时走 revision_from_review → regenerate → apply
+      → rereview 闭环。低质量、硬门禁失败或上下文不完整时先报告原因，不强行交付。
+      修改已有正文、人物、世界、正典、伏笔或其他项目文档时，先用 novel_search / novel_status
+      定位正式实体并读取最新版本。正文、正典和其他普通文档的每个独立修改分别调用
+      novel_document_change_plan(action="preview")；大纲、资产、创作重点、伏笔和写作目标的每个独立
+      修改分别调用 novel_structured_change_plan(action="preview")。向用户展示返回的 before/after 与来源版本；
+      只有用户明确确认后，才把原 preview_token 原样传给 action="apply"，不得重新生成路径、
+      锚点或内容。用户拒绝时用 action="reject"；源文件冲突时用 action="retry" 生成新预览；
+      已应用项需要撤销时，只能把返回的 undo_preview_token 传给 action="undo"。
+      novel_doc_write 是已获明确授权的完整文档写入兼容入口，不得用它绕过逐项预览。
+      完成写入后可用 novel_trace_list 核对来源、预算、模型调用、工具调用和领域变更。Trace 只保留摘要、
+      revision 与用量，作品正文、提示原文、模型原文、凭据和推理内容不得写入 trace。
+      普通讨论、分析和未确认建议不得写入资产。
+      写章前优先用 novel_outline_read 定位明确的章纲 ID、所属卷幕节与建议目标，
+      不要仅按最大章节号盲目创建下一章；再用 novel_context_preview 做写前预检。
+      如果 novel_status 显示待确认项为 outline_scope（大纲范围待确认），
+      或阶段仍在大纲滚动期但用户明确要求“根据现在/当前大纲写下一章”、
+      “就按这个大纲写”或等价表达，先向用户确认大纲范围，再执行章节预检与写作。
+      用户要求修改大纲时，先用 novel_outline_read 定位结构，再用
+      novel_structured_change_plan(change_kind="outline") 对一个结构操作逐项预览和确认；不要用
+      novel_doc_write 绕过大纲门控，也不要整篇覆盖 src/outline.md。novel_outline_edit、
+      novel_asset_update、novel_focus、novel_foreshadowing 和 novel_writing_targets 仅在用户本轮已经
+      明确授权对应的精确变更时作为直接写入兼容入口使用。
+      用户要求删除已写正文或章节时，先向用户说明将删除的章节与影响并得到明确同意。
+      单章使用 novel_chapter_delete；清理连续尾段时使用 novel_chapter_delete_batch，
+      keep_through 指定最后保留章节，confirm 必须精确为 DELETE_AFTER:<keep_through>，
+      version 必须来自刚读取的最新章节。不得用文档编辑工具清空正文来绕过删除门控。
+
+      ## OpenWrite 大纲写入契约
+
+      凡是生成、补全或修改 `src/outline.md`，必须写成解析器可消费的四级 Markdown，不能只写自然语言梗概：
+
+      ```markdown
+      # 作品名
+
+      全书梗概，说明主角、核心冲突、主要推进和故事结果。
+
+      ## 第1篇：篇标题
+
+      本篇梗概，说明这一阶段的主要事件、推进过程和结果。
+
+      ### 第1节：节标题
+
+      本节梗概，说明主要事件、推进过程和结果。
+
+      #### 第1章：章标题
+
+      本章梗概，说明本章实际发生的核心行动、冲突和结果。
+
+      > 戏剧位置: 起
+      > 内容焦点: 本章实际发生的核心行动、冲突和结果
+      > 本章目标: 建立当前矛盾, 推进人物选择
+      > 预估字数: 3000
+      > 出场角色: 角色规范名A, 角色规范名B
+      > 涉及设定: 已存在设定名A, 已存在设定名B
+      > 情感弧线: 戒备 -> 动摇 -> 决意
+      > 节拍: 场景切入, 冲突升级, 关键选择, 后果与章末钩子
+      > 悬念: 下一章需要承接的问题
+
+      ```
+
+      规则：
+      - 总纲、篇纲、节纲和章纲统一在标题后直接写普通散文梗概，不使用弧线、情感或张力元数据代替梗概。
+      - 章级元数据必须使用 `> 键: 值`；不要改写成项目符号、表格、粗体标签或含糊散文。
+      - `出场角色`只列本章实际进入场景或直接参与行动的人物，使用 `src/characters/`
+        中的规范名或 ID；“团队”“众人”等群体词不能代替具体人物，不得把仅被提及者
+        自动算作出场。
+      - `涉及设定`使用 `src/world/` 中可解析的规范名称；不要为填字段而虚构人物或设定。
+        缺少必要资产时先读取、创建草案或向用户确认。
+      - 完善已有章纲前，先读取目标章、所属节、相邻章、最近正文、相关人物与设定；
+        依据事实补字段，不凭空扩写。
+      - 四级梗概粒度逐级收窄：总纲概括全书，篇纲概括阶段事件，节纲概括一组章节，章纲概括本章；章另写戏剧位置与章内节拍。
+      - 修改后自检标题层级和上述字段；精确保留用户未要求修改的内容，并继续遵守预览 diff 与确认边界。
+
+      ## OpenWrite 内联批注契约
+
+      用独立一行、且仅在代码围栏之外写入以下机器可读批注：
+
+      ```text
+      //**人物[维度]：旧状态 -> 新状态**
+      //**关系源~>关系目标:具体关系**
+      ```
+
+      规则：
+      - 状态批注记录一次状态迁移；维度必须具体，例如位置、伤势、立场或“与某人关系”。
+      - `A~>B` 是从 A 指向 B 的有向关系注册，用于当前关系图，不表示关系随时间的变化，
+        也不会自动创建 `B~>A`。
+      - 关系发生演变时使用状态迁移，例如 `//**A[与B关系]：互相戒备 -> 暂时结盟**`。
+      - 使用 `src/characters/` 与 `src/world/` 中的规范名称或 ID，不使用含糊代称。
+      - 大纲中的批注必须放在对应章节标题下；无法放入章纲时显式添加 `@ch_070` 章节范围。
+      - 规划阶段在大纲中只登记计划变化；写作阶段与 Writer 在正文中只登记本章实际写出的变化，
+        不能把未落地计划写成事实。
+      - 同章同人物同维度同时存在大纲与正文批注时，正文事实优先用于当前状态和连续性判断；
+        大纲计划仍保留为历史来源。
+      - 旧式 `//**A~B:具体关系**` 仅为已有项目读取兼容；不得继续生成，必须写成 `~>`。
+      - 只有格式完整的有效批注会从字数统计与成书导出中隐藏；无效批注会保留在原文中并报告错误。
+
+      ## OpenWrite 角色文档契约
+
+      创建完整角色资产时，`content` 必须包含 TOML front matter 与 Markdown 正文。front matter 至少包含
+      `id`、`name`、`tier`、`summary`、`tags`，关系引用放在 `related`。正文必须使用一级角色名标题，
+      并填写 `## 基本信息`、`## 背景`、`## 外貌`、`## 性格`、`## 与主角关系`、
+      `## 说话风格`、`## 当前戏剧用途`；有能力体系时再填写 `## 特殊能力`。
+      未知信息写“待作者确认”，不能省略结构，也不能只传一句 description 充当完整角色卡。
+
+    # rc.1 reads text; alpha.1 reads prefix. One shared string prevents drift.
+    prefix: *openwrite_persona
+
+- id: agent-instructions
+  name: '@deepseek-ai/dsh-agent-instructions'
+  config:
+    maxBytes: 65536
+
+# OpenWrite bridge is mounted once by the host profile bundle.
+# Keep it out of this per-agent preset: mounting it here again would register
+# the process-level `novelDomain` service twice and make this preset unloadable.
+
+# ── shell ───────────────────────────────────────────────────────────────────
+
+- id: tool-bash
+  name: '@deepseek-ai/dsh-tool-bash'
+  disabled: !!js process.platform === 'win32'
+
+- id: tool-pwsh
+  name: '@deepseek-ai/dsh-tool-pwsh'
+  disabled: !!js process.platform !== 'win32'
+
+# ── filesystem ──────────────────────────────────────────────────────────────
+
+- id: tool-fs
+  name: '@deepseek-ai/dsh-tool-fs'
+
+- id: tool-fs-search
+  name: '@deepseek-ai/dsh-tool-fs-search'
+  config:
+    sampleOverCapGlobResults: false
+
+# ── background jobs ─────────────────────────────────────────────────────────
+
+- id: tool-jobs
+  name: '@deepseek-ai/dsh-tool-jobs'
+
+# ── skills ──────────────────────────────────────────────────────────────────
+
+# 技能注册表在 host 组合中按 scope 分层；这两行注册进本预设的层，无需 realm。
+# customSkillDirs 指向预设自带的 skills/ 目录：baseUrl 是预设自身目录，
+# 预设被复制到 ~/.dsh/.agent-presets/ 后依然解析正确（与 shipped cordis 预设同写法）。
+- id: skill-filesystem
+  name: '@deepseek-ai/dsh-skill-filesystem'
+  config:
+    customSkillDirs:
+      - !!js "process.getBuiltinModule('node:url').fileURLToPath(new URL('skills/', baseUrl))"
+
+- id: tool-skill
+  name: '@deepseek-ai/dsh-tool-skill'
+
+# ── goals ───────────────────────────────────────────────────────────────────
+
+- id: tool-goal
+  name: '@deepseek-ai/dsh-tool-goal'
+
+# ── plan mode ───────────────────────────────────────────────────────────────
+
+# Plan 状态按 agent 计，entry-local realm 是正确的生命周期（沿用 standard）。
+- id: planning
+  name: cordis:group
+  group: true
+  isolate:
+    planMode: true
+  config:
+    - id: plan-mode
+      name: '@deepseek-ai/dsh-plan-mode'
+      config:
+        section: |
+              You are in plan mode. Stay in plan mode until exit_plan_mode succeeds or the user switches the session mode. Imperative language to implement changes means plan the implementation, not execute it. A user's conversational agreement — including an answer confirming something you asked — approves nothing and does not end plan mode; fold the confirmed decision into the plan and submit it through exit_plan_mode.
+
+              Explore first. Use non-mutating reads, searches, static analysis, and checks to ground the plan in the actual repository. Do not edit or write files, change configuration, run formatters or code generation that rewrites tracked files, commit, or otherwise carry out the plan. Prefer existing functions and patterns over new machinery.
+
+              The tool catalog stays the same across modes for request-cache stability. These plan-mode rules override any later tool description or guidance that suggests using mutation tools; those tools remain listed to keep the tool catalog unchanged. Do not use todo_write to track this planning phase: it tracks implementation after an approved plan, while the plan itself belongs in exit_plan_mode.
+
+              Resolve discoverable facts by inspection. Use ask_user_question only for user-owned choices or material ambiguity that inspection cannot answer. Do not ask the user where code lives or how current behavior works when you can find out.
+
+              Make the plan decision-complete: state the goal and success criteria; group implementation changes by subsystem; identify public API, schema, and data-flow changes; cover edge cases, failure modes, tests, acceptance criteria, and explicit assumptions. Keep it concise enough to review but detailed enough that another engineer can implement it without making design decisions.
+
+              When ready, call exit_plan_mode with the complete plan markdown, starting with a # title. Make exit_plan_mode the only and final tool call in that assistant response: it presents the plan for approval, and implementation begins only in a later step after approval. Do not paste the final plan as a plain reply or ask "should I proceed?" through prose or ask_user_question. If review rejects it, incorporate the feedback and present again. If the review channel is unavailable or aborted, stay in plan mode and ask the user to switch modes manually; do not proceed with implementation.
+
+# ── compaction ──────────────────────────────────────────────────────────────
+
+# compaction-basic 通过 ctx.get 读 toolResultPrune，二者必须同 realm（沿用 standard）。
+- id: compaction
+  name: cordis:group
+  group: true
+  isolate:
+    compaction: true
+    toolResultPruner: true
+  config:
+    - id: compaction-basic
+      name: '@deepseek-ai/dsh-compaction-basic'
+
+    - id: command-compact
+      name: '@deepseek-ai/dsh-command-compact'
+
+    - id: tool-result-pruner
+      name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
+      config:
+        thresholdChars: 8192
+        headChars: 4096
+        tailChars: 1024
+
+# ── delegation and workflows ────────────────────────────────────────────────
+
+# subagents 注册表与 spawn/fork 后端在 host 组合；本预设只贡献委派工具。
+# workflows 无外部读者，相关行共享一个 entry-local realm（沿用 standard）。
+- id: delegation
+  name: cordis:group
+  group: true
+  isolate:
+    workflowEngine: true
+  config:
+    - id: tool-subagent-control
+      name: '@deepseek-ai/dsh-tool-subagent-control'
+
+    - id: tool-subagent-list-agents
+      name: '@deepseek-ai/dsh-tool-subagent-control/list-agents'
+
+    - id: tool-subagent
+      name: '@deepseek-ai/dsh-tool-subagent'
+      config:
+        provider: spawn
+        toolName: subagent
+        backgroundMode: continuable
+
+    - id: tool-subagent-fork
+      name: '@deepseek-ai/dsh-tool-subagent'
+      config:
+        provider: fork
+        toolName: subagent_fork
+        backgroundMode: continuable
+
+    - id: workflow-worker-thread
+      name: '@deepseek-ai/dsh-workflow-worker-thread'
+      config:
+        provider: spawn
+
+    - id: tool-workflow
+      name: '@deepseek-ai/dsh-tool-workflow'
+
+    - id: tool-ralph
+      name: '@deepseek-ai/dsh-tool-ralph'
+      config:
+        subagentProvider: spawn
+        maxRounds: 64
+
+# ── remaining model-facing rows ─────────────────────────────────────────────
+
+- id: tool-ask-user
+  name: '@deepseek-ai/dsh-tool-ask-user'
+
+- id: tool-todo
+  name: '@deepseek-ai/dsh-tool-todo'
+  config:
+    allowParallelInProgress: true
+
+- id: tool-web
+  name: '@deepseek-ai/dsh-tool-web'
+  config:
+    fetch: false
+    searchTimeoutMs: 60000
+
+# Stable scoped tool catalog; no novel tools are registered by the host bridge.
+- id: openwrite-tools
+  name: dsh-openwrite/tools
+
+- id: openwrite-dog-tools
+  name: dsh-openwrite/dog-tools

package/presets/openwrite/preset.yml

@@ -0,0 +1,3 @@
+name: OpenWrite 创作
+description: 长篇小说全流程 Agent：在同一会话中完成灵感收敛、人物/设定/大纲、正文写作、六域累加评审与修订交付，保留 37 项展开查询，按项目阶段自动切换规划与写作模式。
+order: 10

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

@@ -0,0 +1,15 @@
+---
+name: canon
+description: 查设定。Use when the author asks 查设定, 人物卡, 世界观, or types /canon. Read registered assets and search; do not create a second lorebook.
+---
+
+# 查设定
+
+接到已有 `novel_*`。人物、地点、世界观以 OpenWrite 资产为准。
+
+1. `novel_assets_list` 列出人物/世界资产（含名称与别名）。
+2. 指定实体用 `novel_asset_read`。
+3. 按名称或别名找不到时 `novel_search`（scope 可 `assets`）。
+4. 关系与状态漂移用 `novel_continuity`。
+
+向作者报告规范名、别名、摘要。改设定走 `novel_structured_change_plan(change_kind="asset")`；普通讨论不得写入。

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

@@ -0,0 +1,166 @@
+---
+name: dialoguequality
+description: Use when user wants to analyze dialogue style, extract speech patterns, compare character voices, or detect AI-sounding dialogue. Triggers include "对话", "口头禅", "角色声音", "对白", "AI味对话".
+user-invocable: false
+---
+
+# 对话质量系统
+
+用于分析角色对白、提取说话习惯、检查角色声音是否区分明显，以及识别 AI 味对话问题。
+
+## 当前数据来源
+
+对话分析不要只盯着对白片段本身。当前推荐读取顺序是：
+
+1. `data/manuscript/arc_*/ch_*.md` — 实际章节正文
+2. `src/characters/*.md` — 角色单源文档
+3. `data/style/composed.md` — 当前作品风格约束
+4. `src/outline.md` / canonical packet — 本章戏剧位置与章节目标
+
+如果需要完整判断某章对白是否失真，优先结合 `review_chapter` 或章节 packet，而不是只看几行台词。
+
+## 可用工具
+
+| 工具 | 说明 |
+|------|------|
+| `extract_dialogue_fingerprint` | 提取角色对白指纹 |
+| `review_chapter` | 对整章做审查，可发现台词失真、解释性对话、套路对白 |
+
+## 什么时候用
+
+- 角色说话越来越像同一个人
+- 想提取某角色口头禅、句长、问句比例
+- 怀疑一段对白太工整、太礼貌、太像 AI 写的
+- 想比较两个角色的声音有没有拉开
+
+## 工作方式
+
+### 1. 提取对白指纹
+
+先定位章节和角色，再提取：
+
+```text
+用户: 分析一下林月在第六章的对话风格
+
+AI:
+[COMMAND] extract_dialogue_fingerprint {
+  "chapter_id": "ch_006",
+  "character_names": ["林月"]
+}
+```
+
+重点观察：
+
+- `avg_sentence_length`：句长偏短还是偏长
+- `question_ratio`：疑问句比例
+- `common_bigrams`：高频词组
+- `speech_patterns`：口头禅、重复习惯、语气特征
+
+### 2. 结合角色档案复核
+
+提取完后，要对照 `src/characters/*.md`：
+
+- 角色身份是否和说话方式一致
+- 是否符合性格、教育程度、职业背景
+- 是否保留了角色特有的回避方式、攻击方式、冷幽默或停顿习惯
+
+### 3. 识别 AI 味对白
+
+重点查这些问题：
+
+#### 过度礼貌
+
+- 普通熟人反复说“请”“劳烦”“阁下”
+- 同事或熟人之间说话像正式公文
+
+#### 解释性对话
+
+- A 向 B 解释 B 本来就知道的事
+- 台词承担“给读者讲设定”的任务，而不是人物交流
+
+#### 完美逻辑
+
+- 每句话都有正面回应
+- 没有打断、沉默、敷衍、转移话题
+- 像在辩论，不像在说话
+
+#### 套路表达
+
+- “受教了”“所言极是”“你说得对”
+- “我很生气”“我很震惊”这类直接把情绪说出来
+- “嘴角微微上扬”“眼中闪过一丝”这类套路型动作标签
+
+#### 角色同声化
+
+- 不同角色句长接近
+- 用词层次相同
+- 职位、年龄、教育背景、社交方式没有反映在对白里
+
+## 检查清单
+
+### 角色声音
+
+- 主角是否有稳定的思维口癖
+- 配角是否有可识别的用词边界
+- 高压状态下的说话方式是否会变化
+
+### 对话结构
+
+- 是否有人答非所问
+- 是否有停顿、省略、打断
+- 是否存在大量“解释给读者听”的台词
+
+### 风格一致性
+
+- 是否符合 `data/style/composed.md`
+- 是否符合章节当前戏剧位置
+- 是否和上一章衔接自然
+
+## 输出建议格式
+
+```text
+对话检查结果：ch_006 / 林月
+
+1. 角色声音
+- 句长偏短，命令句比例高，符合技术组长的控制型表达
+- 高频表达偏直接，几乎不解释理由，角色识别度高
+
+2. 问题
+- 第 3 段存在解释性对话，林月不该向熟悉项目的人完整解释背景
+- 第 6 段礼貌度偏高，不像她一贯说话方式
+
+3. 修改建议
+- 删掉完整解释，改成一句结论 + 一个动作
+- 把“请你尽快处理”改成“今天收掉”
+```
+
+## 示例
+
+### 示例 1：识别解释性对话
+
+```text
+❌
+"你也知道，我们项目组最近一直在做那套老系统重构，所以今天才会出这种问题。"
+
+✅
+"老系统又炸了。"
+```
+
+原因：后者更像熟人之间的真实说话方式，信息由上下文承担，不靠台词硬讲。
+
+### 示例 2：识别角色同声化
+
+```text
+❌ 陈明 / 林月 / 赵磊都用类似的完整句式解释问题
+
+✅
+陈明：偏技术比喻、偏自嘲
+林月：短句、结论先行
+赵磊：口语化、插科打诨
+```
+
+## 注意
+
+- `extract_dialogue_fingerprint` 适合看“说话指纹”
+- `review_chapter` 适合看“对白放在整章里是否成立”
+- 真要改对白，必须结合人物文档和章节戏剧位置一起判断

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

@@ -0,0 +1,40 @@
+---
+name: dog-delivery-query
+description: Query a chapter delivery DoG graph 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
+---
+
+# 章节交付 DoG 查询
+
+章节写作、评审和修订工具会生成：
+
+`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_get` 结果的 `dog_delivery.graphPath` 找到图；conductor 输出使用
+   `dog_delivery_graph_path`。
+2. 依次调用 `dog_validate`、`dog_create`、`dog_run`、`dog_wait`，等待终态。
+3. 用 `dog_status` 读取 `review`、`revision` 和 `closure` evidence，再决定领域动作。
+4. 修订应用后必须重新调用 `novel_review_chapter`；只有复评对应当前正文 SHA 且门禁通过，
+   `closure` 才能成为 `closed`。
+
+## 状态解释
+
+- `review.missing`：正文存在但尚未评审。
+- `closure.review_failed`：当前正文已评审但未通过门禁，进入修订闭环。
+- `revision.proposal_pending`：提案已生成，等待作者确认应用或驳回。
+- `revision.applied_requires_rereview`：修订已写入正文，但不能视为问题已解决。
+- `closure.rereview_required`：必须对修订后的正文重新跑六域评审。
+- `closure.closed`：当前正文的最新评审通过，可以交付。
+
+## 约束
+
+- DoG 只查询 canonical manuscript/review/revision 文件，不直接修改它们。
+- 不因提案状态为 `applied` 就宣称问题关闭；必须以当前正文 SHA 对应的复评为准。
+- `needs_human` 是等待评审、确认或复评，不得描述成成功。
+- 应用或驳回修订仍遵守 OpenWrite 创作 Agent 的用户确认边界。