dsh-plugin-prompt-tool 0.8.1 → 2.0.0

package/templates/66-subagent-start.yml

@@ -5,10 +5,15 @@
 id: example-subagent-start
 name: 子代理通用守则
 layer: subagent-start
-strategy: static
-order: 0
-modelScope: all
-text: |-
-  开始编辑之前，先确认你改的这条路径在运行时会真的被执行：查调用链，
-  或用探针跑一次看它动。找不到证据就继续查，不要凭「看起来像」就动手。
-params: {}
+then:
+  - id: inject
+    kind: inject-text
+    config:
+      id: example-subagent-start
+      layer: subagent-start
+      strategy: static
+      order: 0
+      text: |-
+        开始编辑之前，先确认你改的这条路径在运行时会真的被执行：查调用链，
+        或用探针跑一次看它动。找不到证据就继续查，不要凭「看起来像」就动手。
+      params: {}

package/templates/70-subagent-maintenance.yml

@@ -7,32 +7,38 @@ id: subagent-maintenance
 name: 子代理状态/记忆维护
 enabled: false
 layer: pre-step
-strategy: static
-position: after-user
-dedupe: none
-promotion: none
-audience: subagent
-modelScope: all
-configKind: ordered
-order: 2000
-role: user
-mergeMode: merged
-sourceKind: ''
-form: hint
-summary: ''
-identity:
-  field: plugin
-  value: subagent-maintenance
-text: |-
-  你是本会话的「状态与记忆维护者」，与创作类子代理职责互补：
-  - 状态（本会话临时，模板变量注入用）：观察互动中明确的角色状态变化
-    （心情、态度、接受度等），用 session_var 工具 set 更新——变量名见下方
-    「状态变量」清单；状态未变化时不要重复写入。
-  - 记忆（跨会话持久）：有人际关系进展或重要事实时，用 world_book_upsert
-    的 note 参数写入来源角色卡记忆（条目 id 带 chara- 前缀 → 角色卡
-    memory.md，跨会话跟随角色卡）；无归属条目写入预设记忆。
-  - 克制：仅在状态确实变化时更新；不确定时保留原值；不编造未发生的内容。
-  状态变量清单：{{stateKeys}}
-variables:
-  stateKeys: 心情, 接受值, 关系进度
-params: {}
+if:
+  scope:
+    audience: subagent
+then:
+  - id: inject
+    kind: inject-text
+    config:
+      id: subagent-maintenance
+      layer: pre-step
+      strategy: static
+      position: after-user
+      dedupe: none
+      configKind: ordered
+      order: 2000
+      role: user
+      mergeMode: merged
+      sourceKind: ''
+      form: hint
+      summary: ''
+      identity:
+        field: plugin
+        value: subagent-maintenance
+      text: |-
+        你是本会话的「状态与记忆维护者」，与创作类子代理职责互补：
+        - 状态（本会话临时，模板变量注入用）：观察互动中明确的角色状态变化
+          （心情、态度、接受度等），用 session_var 工具 set 更新——变量名见下方
+          「状态变量」清单；状态未变化时不要重复写入。
+        - 记忆（跨会话持久）：有人际关系进展或重要事实时，用 world_book_upsert
+          的 note 参数写入来源角色卡记忆（条目 id 带 chara- 前缀 → 角色卡
+          memory.md，跨会话跟随角色卡）；无归属条目写入模块记忆。
+        - 克制：仅在状态确实变化时更新；不确定时保留原值；不编造未发生的内容。
+        状态变量清单：{{stateKeys}}
+      variables:
+        stateKeys: 心情, 接受值, 关系进度
+      params: {}

package/templates/75-subagent-end.yml

@@ -8,8 +8,13 @@ id: example-subagent-end
 name: 子代理结束记录（只观察）
 enabled: false
 layer: subagent-end
-strategy: static
-order: 0
-modelScope: all
-params:
-  action: observe
+then:
+  - id: inject
+    kind: inject-text
+    config:
+      id: example-subagent-end
+      layer: subagent-end
+      strategy: static
+      order: 0
+      params:
+        action: observe

package/templates/80-tool-surface.yml

@@ -0,0 +1,66 @@
+# 模板：工具面收窄（核心文件与任务集）+ 按需解锁
+#
+# 为什么：工具面实测 **156 个工具、描述合计 46894 字符（≈12K token）**，每个请求都付。
+# 收窄到核心集后只剩约 10 个工具，其余按需解锁。
+#
+# 与 test/engine/declarations/tool-bootstrap.yml 的关键差别：那份原型**只在受控相位收窄**
+# （`promoted: false`），晋升后原样放开；本模板**覆盖全部相位**——晋升后放开等于白省，
+# 而工具描述是每请求的固定开销。若要旧语义，给 `phase` 加 `promoted: false` 并把
+# `compacted` 拆成两条即可。
+#
+# 配套两件（缺一不可）：
+#   1. `dev_tool_search` 工具（组合源 engine/compositions/source/local/dev-tool-search.yml）
+#      ——唯一发现入口，模型靠它搜索并解锁。
+#   2. `allowFrom`（engine/actions/assembly.mjs）——从历史 `tool/call` 参数回收解锁名单。
+#      只挂插件不配 allowFrom 的话，解锁是**一次性的**（当次请求用完即被裁）。
+#
+# 工具名必须与**实际装配名**一致。本项目 harness 是 `pwsh`（不是 `bash`）、
+# `edit` + `write`（不是 `str_replace_editor`）。写错名字有两个后果，都很隐蔽：
+#   - 写进 allow 的名字不存在 → `requireMatch` 触发 fail-open，**静默暴露完整目录**；
+#   - 该在的没写进去 → 该工具被裁掉，模型只能用别的方式硬凑。
+#
+# `requireMatch: true` 是刻意的：任一 allow 工具缺失（或模型解锁了一个不存在的名字）
+# 就放弃裁剪、暴露完整目录。宁可多给上下文，也不静默裁成空目录——收窄错了会让当前
+# 工作流调不到工具，那是比多花 token 严重得多的故障。
+#
+# **本模板走规则路径，不能声明 `waterfallPosition`**（那是声明 `triggers` 路径的字段，
+# `compileRules` 会以 unknown fields 拒绝）。`assembly` 的改写发生在通道下游结算之后，
+# 与相邻动作的先后由规则顺序与模块顺序决定。若确实需要 `outermost`（`prepend: true`，
+# 保证本动作在普通注册之外先看到装配），改用声明路径（同 test/engine/declarations/
+# tool-bootstrap.yml 的格式）而不是本模板。
+id: tool-surface-resident
+name: 工具面收窄（核心文件与任务集）
+enabled: true
+if:
+  # 覆盖全部相位。为什么不能只写 `phase: { promoteOn, includeSubagents }`：
+  # `promoted` 的缺省是 **true**（= 只匹配已晋升），不是「任意」；而 `compacted` 未声明才是
+  # 「不判该维度」（engine/conditions/phase.mjs:27-48）。更麻烦的是 `promoted: 'ignore'`
+  # 要求同时声明 `compacted`，而 `compacted` 只接受布尔值——**没有任何单节点组合能表达
+  # 「两个相位都命中」**，必须用 `any` 拼两支（phase.mjs:30-35 的注释正是在讲这个表达力边界）。
+  #   支 1 `promoted: true`          → 已晋升（不论压缩与否）
+  #   支 2 `{compacted: true, promoted: false}` → 压缩后未晋升（受控相位的压缩回退）
+  # 未晋升且未压缩的**首轮不收窄**：与「首轮保全文」同一取舍——先让模型看到完整目录，
+  # 再随相位推进收窄。收窄的价值在于工具描述是**每请求固定开销**（实测 46894 字符），
+  # 而长会话必然进入上面两支，所以省下的正是大头。
+  any:
+    - phase: { promoteOn: either, includeSubagents: true, promoted: true }
+    - phase: { promoteOn: either, includeSubagents: true, compacted: true, promoted: false }
+then:
+  - id: narrow-tools
+    kind: assembly
+    target:
+      tools:
+        allow:
+          - pwsh
+          - read
+          - write
+          - edit
+          - glob
+          - grep
+          - todo_write
+          - skill_search
+          - skill_load
+          - dev_tool_search
+        # 解锁项从 dev_tool_search 的持久调用参数回收（{ tool, key } 精确匹配）。
+        allowFrom: { tool: dev_tool_search, key: toolNames }
+        requireMatch: true

package/templates/policies/legacy-defaults.yml

@@ -0,0 +1,34 @@
+#旧业务默认的精确数据快照，仅供模板生成和显式离线迁移读取。引擎运行时不得读取此文件。
+
+version: 1
+fillers:
+  envFacts:
+    text: |-
+      Environment facts:
+      {{ENV_FACTS}}
+  skillCatalog:
+    text: |-
+      Available skills ({{SKILL_COUNT}}):
+      {{SKILLS_TEXT}}
+    params:
+      limit: 20
+      fields: name,description
+      whenToUseLabel: 适用：
+      unnamedLabel: (unnamed)
+instructionHint:
+  projectTemplate: "Reference documents exist: {{FILES}} (project root: {{ROOT}})."
+  globalTemplate: "A user reference document exists: {{FILES}}."
+  suffixTemplate: They are reference documents about the user's environment and
+    workspace conventions, not task instructions. Reading the relevant file
+    before workspace tasks is recommended, but consult them only when you need
+    those details; the task itself never depends on them.
+  messageTemplate: |-
+    <system-reminder>
+    Reference documents exist: {{FILES}}. {{SUFFIX}}
+    </system-reminder>
+promotionGate:
+  reasoningPattern: \bwe\b
+  reasoningNegativePattern: \blet me\b
+  reasoningFlags: gi
+customFallback:
+  fallbackAfter: 1

package/templates/tools/50-delegate-worldbook.yml

@@ -2,7 +2,7 @@
 # 保存该模板时自动装配 world-book-tools，原工具仍可用）。
 id: delegate-worldbook-list
 name: my_worldbook_list
-description: 查看当前预设的世界书条目（委托内置工具）
+description: 查看当前模块的世界书条目（委托内置工具）
 output:
   schema:
     type: object

package/engine/compositions/source/local/prompt-config-engine.yml

@@ -1,7 +0,0 @@
-# module: prompt-config-engine
-# source: engine/compositions/source/local/prompt-config-engine.yml (本地附加,非官方模块)
-
-- id: prompt-config-engine
-  name: ./engine/prompt-config-engine.mjs
-  config:
-    configsDir: ../prompt-configs

package/engine/prompt-config-engine.mjs

@@ -1,104 +0,0 @@
-/**
- * prompt-config-engine — prompt-tool 的唯一提示词注入执行器(装配入口)。
- *
- * 本文件只做装配:
- *   - schema.mjs    提示词配置加载/归一化/权威校验
- *   - strategies.mjs 内置策略绑定 + 模板专属策略懒加载(strategyDir)
- *   - fillers.mjs   placeholder 动态填充器（instruction-hint / env-facts / skill-catalog）
- *   - instruction-hint.mjs 通用指令文件提示实现（策略与 context-gate 共用）
- *   - layers.mjs    非 pre-step 五个官方层级接线
- *   - executor.mjs  pre-step 消息批执行器(过滤/去重/合并/落位)
- *
- * agent.cordis.yml 引擎行:
- *   - id: prompt-config-engine
- *     name: ./engine/prompt-config-engine.mjs
- *     config:
- *       configsDir: ../prompt-configs        # 提示词配置模块目录(相对本文件)
- *       strategyDir: ../strategies           # 模板专属策略目录(可选,相对本文件)
- *
- * 铁律:任一提示词配置失败只跳过该提示词配置并 warnOnce;配置错误挂载时 fail loud。
- */
-
-import { readFileSync } from 'node:fs'
-import { basename } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { createPromptConfigs, loadPromptConfigFiles, parsePromptConfigYaml } from './schema.mjs'
-import { applyPromptConfigs } from './executor.mjs'
-import { defineConfig, passthrough } from './fields.mjs'
-
-/** Cordis plugin name used by loader diagnostics. */
-export const name = 'prompt-config-engine'
-
-/**
- * 等待全部可注入层级的宿主服务。preset 行在 agent 组合内解析这些服务
- * (persona 依赖 systemPrompt,工具行依赖 tools,agent loop 依赖 llm)。
- */
-export const inject = ['systemPrompt', 'tools', 'llm']
-
-export { parsePromptConfigYaml, loadPromptConfigFiles, createPromptConfigs, applyPromptConfigs }
-
-/** 物化清单里是否仍挂着官方指令加载行（负责人冲突事实）。 */
-const OFFICIAL_INSTRUCTIONS_ROW = /dsh-agent-instructions|(^|\s)id:\s*agent-instructions\b/m
-
-/**
- * 本 mount 的装配事实：来源 id（协调器注册键，取预设目录名）+ 是否仍挂着官方
- * 指令行。协调器据此拒绝在官方负责人仍在时同时注入插件指令文件正文。
- * 引擎直接以源码方式被引用（无物化组合文件）时按未知处理，不声明冲突。
- */
-function compositionFacts(dirUrl) {
-  try {
-    const dir = new URL('..', dirUrl)
-    return {
-      sourceId: `preset:${basename(fileURLToPath(dir))}`,
-      officialInstructions: OFFICIAL_INSTRUCTIONS_ROW.test(readFileSync(new URL('../agent.cordis.yml', dirUrl), 'utf8')),
-    }
-  } catch {
-    return { sourceId: undefined, officialInstructions: false }
-  }
-}
-
-/**
- * 引擎插件入口:config.configsDir 为提示词配置模块目录(相对本文件的 URL),
- * config.strategyDir 为模板专属策略目录(可选)。引擎扫描目录内每个
- * *.yml / *.yaml / *.json 并装配为提示词配置。
- */
-/**
- * 配置契约：白名单由字段声明派生（此前没有白名单，未知键被静默忽略）。
- * 三个键都刻意用 passthrough 保住既有语义——迁移前它们对**非字符串或空串**是静默取默认值
- * （`typeof x === 'string' && x.length > 0 ? x : 默认`），换成 text() 会把静默降级变成挂载期
- * 报错，那是 B2 未授权的行为变更。归一化结果与迁移前逐字段一致，唯一新增的是「未知键报错」。
- *
- * `presetRoot` 是可选的预设根基准（绝对 file URL）：引擎由插件包提供、不再位于
- * `<预设根>/.engine/` 时，`templateFile` 的越界校验无法再从引擎位置推导，改由装配期注入。
- */
-export const configContract = defineConfig({
-  configsDir: passthrough((value) => (typeof value === 'string' && value.length > 0 ? value : './prompt-configs')),
-  strategyDir: passthrough((value) => (typeof value === 'string' && value.length > 0 ? value : undefined)),
-  presetRoot: passthrough((value) => (typeof value === 'string' && value.length > 0 ? value : undefined)),
-})
-
-export function apply(ctx, config) {
-  const { configsDir: dirName, strategyDir: rawStrategyDir, presetRoot: rawPresetRoot } = configContract.parse(config, name)
-  const dirUrl = new URL(dirName.endsWith('/') ? dirName : `${dirName}/`, import.meta.url)
-  // strategyDir 在入口统一解析成绝对 URL：bindResolver 用 `new URL(x.mjs, strategyDir)`
-  // 懒加载，相对写法的 base 不是合法绝对 URL（ERR_INVALID_URL），会让整行挂载失败。
-  const strategyDir = rawStrategyDir === undefined
-    ? undefined
-    : new URL(rawStrategyDir.endsWith('/') ? rawStrategyDir : `${rawStrategyDir}/`, import.meta.url).href
-  // 预设根基准（可选）：装配期注入绝对 file URL；缺省时由 schema 按「引擎上一级目录」推导。
-  const templatePresetRoot = rawPresetRoot === undefined
-    ? undefined
-    : new URL(rawPresetRoot.endsWith('/') ? rawPresetRoot : `${rawPresetRoot}/`)
-  const facts = compositionFacts(dirUrl)
-  applyPromptConfigs(ctx, createPromptConfigs(loadPromptConfigFiles(dirUrl), {
-    strategyDir,
-    // 注入预设根时（引擎由插件包提供）：相对 templateFile 仍按**历史引擎位置**
-    // `<预设根>/.engine/` 解析，用户预设与提示词配置零改写；越界校验基准则是预设根本身。
-    ...(templatePresetRoot === undefined
-      ? {}
-      : { templateBaseUrl: new URL('.engine/prompt-config-engine.mjs', templatePresetRoot), templatePresetRoot }),
-  }), {
-    prepend: true,
-    ...facts,
-  })
-}

package/preset/pt-cordis/preset.yml

@@ -1,43 +0,0 @@
-id: pt-cordis
-name: 创造模式
-description: 用于创建自定义 Agent preset：具备标准模式的全部能力，并提供运行时检查、持久化插件管理和 preset 创作指导。
-version: 1.0.0
-engineCompat: ">=0.4.2"
-modules:
-  - agent-instructions
-  - tool-bash
-  - tool-pwsh
-  - tool-fs
-  - tool-fs-search
-  - tool-jobs
-  - command-goal
-  - tool-goal
-  - planning
-  - compaction
-  - delegation
-  - tool-ask-user
-  - tool-todo
-  - tool-web
-  - skill-filesystem-cordis
-  - tool-skill
-  - tool-present
-  - tool-plugin-manager
-  - prompt-config-engine
-persona:
-  suffix: Your working directory is {{cwd}}.
-  prefix: You are a coding agent powered by the {{model}} model.
-promptConfigs: []
-layerSettings:
-  agent-request:
-    modelProvider: ""
-    modelName: ""
-    modelReasoningEffort: ""
-    modelTemperature: ""
-    modelMaxTokens: ""
-  subagent-start:
-    subagentModelProvider: ""
-    subagentModelName: ""
-    subagentReasoningEffort: ""
-    subagentTemperature: ""
-    subagentMaxTokens: ""
-    maxDepth: ""

package/preset/pt-cordis/skills/cordis-composition-reference/SKILL.md

@@ -1,29 +0,0 @@
----
-name: cordis-composition-reference
-description: Use when writing or reading a Cordis bundle patch or agent preset for this harness and you need the Loader YAML dialect (insert, override by id, group, disabled, isolate, !!js) or the list of installable Harness plugin packages and what each provides.
----
-
-# Cordis composition reference
-
-Reference material for bundle patches and preset plugin lists. Procedures live in `cordis-plugin-development` and `editing-cordis-compositions`.
-
-## Loader patch dialect
-
-A profile composes an ordered list of patch layers over the bundle entry lists. Each patch is a mapping:
-
-- `insert: [rows]` appends rows; with an `id` naming an existing `group: true` row, the rows are appended inside that group's `config` list.
-- A patch with an `id` and no `insert` targets the existing row with that id. Supplied fields replace the row's fields; `config` is replaced wholesale, never deep-merged, so restate every field the row needs. A truthy `name` asserts the existing plugin name rather than renaming it.
-- Non-insert patches without a nonempty `id`, and targets that match no row, are warned about and skipped.
-
-A row has `id`, `name` (the plugin package specifier; inserted relative paths are anchored beside their patch file), optional `config`, and optional `disabled`, `inject`, `intercept`, and `isolate`.
-
-- `group: true` with `name: cordis:group` makes `config` a nested entry list and allows patches to insert into it by id. `cordis:include` loads a literal YAML or JSON entry list from `config.path`.
-- `disabled` accepts a boolean, null, or a `!!js` expression evaluated against the Loader context at every mount decision. A disabled row omits required `config` unless `group: true` forces activation.
-- `!!js` scalars are Loader expressions, never `!js`. Inside `config` they are evaluated after the row's declared injections activate, against that plugin's context (`ctx.<service>`), so `!!js dshHomePath('sessions')` and `!!js "!ctx.get('profileContext')"` are valid. Other row metadata stays literal.
-- `isolate` maps service names to `true` or a realm label; a preset plugin that provides a service isolates the provider and all consumers together. Scope controls contributions and event visibility; `isolate` controls service instances.
-
-`plugin_manager` `list_plugins` reports each row's `enabled` flag and `fiberPhase`; `set_plugin` and `set_bundle` answer `overridden` when a higher-priority layer wins.
-
-## Installable plugin packages
-
-`references/packages.md` lists every workspace package that exports a Cordis plugin, grouped by package group, with whether its row takes `config`. Search it with `grep -n <keyword>` rather than reading it whole. Plugins outside this list come from installed bundles; `plugin_manager` `list_bundles` names them.