@morlay/dsh-preset 0.0.2 → 0.0.4

package/README.md

@@ -6,12 +6,16 @@
 
 ## 内容
 
-| 文件                       | 作用                                                                              |
-| -------------------------- | --------------------------------------------------------------------------------- |
-| `cordis.patch.yml`         | bundle patch：禁用官方 preset、注册本包 preset 为默认、声明个人 `llm-pi-ai` route |
-| `tool/generate-presets.ts` | 从上游生成 preset 的模块 + tsdown hooks                                           |
-| `dist/presets/standard/`   | 构建产物：自定义 preset「标准模式」（由上游 `standard` 生成）                     |
-| `dist/presets/ptc/`        | 构建产物：自定义 preset「PTC 模式」（由上游 `ptc` 生成）                          |
+| 文件                       | 作用                                                                                                         |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------ |
+| `cordis.patch.yml`         | bundle patch：禁用官方 preset、注册本包 preset 为默认、声明个人 `llm-pi-ai` route、插入 `prompt-reminder` 行 |
+| `tool/generate-presets.ts` | 从上游生成 preset 的模块 + tsdown hooks                                                                      |
+| `dist/presets/standard/`   | 构建产物：自定义 preset「标准模式」（由上游 `standard` 生成）                                                |
+| `dist/presets/ptc/`        | 构建产物：自定义 preset「PTC 模式」（由上游 `ptc` 生成）                                                     |
+
+`cordis.patch.yml` 里插入的 `prompt-reminder`（`@morlay/dsh-prompt-reminder`）把被
+裁掉的系统提示词 section 降级为 `<system-reminder>` user 消息，见「工具说明降级为
+reminder」。
 
 ## 禁用官方 preset
 
@@ -47,10 +51,75 @@ preset 自带的 `persona` 行会在 agent scope 注册 `deployment:persona-pref
 固化了该语义），所以生成器把那一行**删掉**，而不是复制一份改过的 persona——同一份
 文案只维护一处。
 
+### 指令遵循设计
+
+`personaPrefix` 位于 order 0（prompt 最前，紧跟被关掉的 harness identity 之后）：
+声明指令优先级（直接用户指令 > 工作区 `AGENTS.md` > 本系统提示词）与执行协议。其中
+点名 `AGENTS.md` 是**强制约束**——官方 `agent-instructions` 注入模板的措辞
+（"may be relevant" / "as guidance" / "do not override…"）是上游的通用保守表述，会让
+模型把仓库规则当参考而不是规则，所以这里显式反制。协议一行覆盖：动手前读相关
+`AGENTS.md`、过程自检、交付前核对红线与验证证据、无法遵守时明确说明、派发子代理时
+把约束写进任务说明。
+
+`personaSuffix` 位于 order 10200（prompt 最后）：一句话复述"结束任务前对照本提示词与
+`AGENTS.md` 自检"。长 prompt 里中段指令会被稀释，首尾各放一次最关键的约束，用近因
+位置兜住遵循度；细节只在 prefix 维护，避免两处重复。
+
+改这两段后**必须重启 dsh 才能生效**：profile 在进程启动时装载，`system-prompt` 的
+section 在插件构造时注册；dev 模式重启 `just custom dev`/`just custom desktop`，打包
+形态需重新 `just custom bundle`（patch 随 seed 快照复制）。
+
 自建 preset 仍然必要，但只为别的事：`includeShippedRoot: false` 之后需要一份自己的
 roster（id 沿用官方名以走客户端语言字典），以及桌面形态下 preset 必须落在 dsh 包的
 `config/agent-presets` 挂载点（见 dsh-desktopify 的 `dsh.desktop.agentPresets`）。
 
+## 工具说明降级为 reminder，不进系统提示词
+
+上游把每个工具的跨调用说明（`tool:bash`、`tool:read`、…）、Agent Teams 协作规则、
+harness 源码位置、Web GUI 说明都注册成系统提示词的 section。本部署实测它们占
+9200 字符里的约 7400：条数多、篇幅大、挤在上下文最前面，稀释真正要遵守的那几行
+纪律。`cordis.patch.yml` 因此在 host plane 插一行：
+
+```yaml
+- insert:
+    - id: prompt-reminder
+      name: "@morlay/dsh-prompt-reminder"
+```
+
+一处定义覆盖全部 preset（standard / ptc 以及后续新增的）——这是与具体 preset 无关
+的部署级策略，preset composition 不各自带这一行，生成器也就不必碰它。该插件注册
+在 root scope，会收到每个 agent 的装配与 pre-step 事件（含子 agent）：
+
+- 装配（`system-prompt/assemble` 瀑布）时保留 `keep` 名单——默认是部署级
+  `deployment:persona-prefix` / `deployment:persona-suffix`——内的 section，其余
+  非空 section 从 assembly 移除并按 order 捕获文本；
+- pre-step 时把捕获的文本作为一条 `<system-reminder>` user 消息注入，紧随本轮
+  用户消息之后；文本不变不重复注入，`plan:policy` / `tools:ptc-only` 这类按模式
+  渲染的 section 变化时追加一条新的全量 reminder（首行声明最新一条覆盖更早的）。
+
+于是系统提示词只剩首尾两段个人提示词，其余内容仍在上下文里、但不再占系统提示词
+的位置，也不再随模式切换改动。**为什么不用 `persona` 行的 `complete: true`**：那会
+连 suffix 一起丢，且子 agent 自己注册同名 persona 时 `complete` 语义消失，保留 /
+降级会不一致；本插件按 `keep` 名单匹配 section 名，两种 agent 行为一致。完整行为与
+配置见 `packages/preset/dsh-prompt-reminder/README.md`。
+
+## 工作区指令走官方行为，候选收紧为 AGENTS 系列
+
+preset 里的 `agent-instructions` 行是官方 `@deepseek-ai/dsh-agent-instructions`：
+baseline 按官方语义作为 user 消息注入一次。生成器只覆盖该行 config 的两个字段：
+
+```yaml
+instructionFileCandidates: ["AGENTS.md"] # 上游默认 ['AGENTS.md','CLAUDE.md']
+localInstructionFileCandidates: ["AGENTS.local.md"] # 上游默认还含 CLAUDE.local.md
+```
+
+即**不读 CLAUDE 系列**（本部署不需要 CLAUDE 兼容）；`maxBytes` 等其余字段跟随上游。
+
+本仓库曾有一个把 baseline 落点改成 system-prompt section 的 fork
+（`@morlay/dsh-agent-instructions-as-prompt`），一直未接入默认打包；提示词分层定为
+「系统提示词只留 persona、其余走 reminder」之后它已删除——baseline 留在 user 消息
+通道与这个分层一致。
+
 ## preset 由构建生成，不是手工副本
 
 产物落在 `dist/`，由 tsdown 的 `build:done` hook 在每次 `pnpm build` 时生成
@@ -68,11 +137,11 @@ pnpm --filter @morlay/dsh-preset run generate-presets [outDir]
 ```
 
 脚本把上游 composition 当**数据**读入：`js-yaml` 用 include 的
-`entryListSchema` 解析（`!!js` 标签保留为表达式节点）→ 在 JS 里改两处（删掉
-`persona` 行、把 `agent-instructions` 行指向本仓库的 fork）→ `dump` 回 YAML。
-因此上游任何结构性改动（新增 / 重命名 row、改字段）都自动跟随，不依赖易碎的文本
-锚点；上游若删掉 `persona` 行，目标（preset 不自带 persona）本就达成，脚本照常
-通过。
+`entryListSchema` 解析（`!!js` 标签保留为表达式节点）→ 在 JS 里改三处（删掉
+`persona` 行、把 `agent-instructions` 行的候选收紧为 AGENTS 系列、插入
+`prompt-reminder` 行）→ `dump` 回 YAML。因此上游任何结构性改动（新增 / 重命名
+row、改字段）都自动跟随，不依赖易碎的文本锚点；上游若删掉 `persona` 行，目标
+（preset 不自带 persona）本就达成，脚本照常通过。
 
 脚本先**整目录清空**输出目录再生成：产物完全派生自脚本，残留目录（改过
 `source`、旧命名）不该留下——否则 discovery 会把它们当有效 preset 扫出来。
@@ -85,7 +154,7 @@ pnpm --filter @morlay/dsh-preset run generate-presets [outDir]
 
 1. 升级 `DEEPSEEK_HARNESS_VERSION` 并 sync/patch/build。
 2. `pnpm --filter @morlay/dsh-preset run build`（build:done 会重新生成）
-3. `pnpm exec vitest run packages/preset/dsh-preset` 确认无 drift。
+3. `pnpm exec vitest run packages/preset` 确认无 drift（含 reminder 插件的行为测试）。
 
 ## 装配
 
@@ -126,6 +195,9 @@ profile 里把内容物化到该挂载点；`includeShippedRoot: false` 两种
 ## 维护注意
 
 - `package.json` 的 `files` 必须含 `dist`（preset 在其中）与 `tool`，否则发布产物缺内容。
+- `cordis.patch.yml` 插入的 `@morlay/dsh-prompt-reminder` 必须能被 **profile** 的依赖
+  树解析：示例 app 已在 `dependencies` 声明；换工作区时要一并声明，否则该行加载失败、
+  工具说明会留在系统提示词里。
 - 生成器显式设 `quotingType: '"'`：`yaml.dump` 默认单引号而仓库 oxfmt 偏好双引号，
   不指定会让生成器与 formatter 来回改；产物在 gitignore 的 dist 里，本就不参与 fmt。
 - **dev 模式需要先构建**：`just dev` / `just desktop` / `just bundle` 都先跑

package/cordis.patch.yml

@@ -2,15 +2,16 @@
   config:
     includeHarnessIdentity: false
     includeRuntimeContext: false
-    personaSuffix: "你的工作目录在 `{{cwd}}`"
+    personaSuffix: |-
+      你的工作目录在 `{{cwd}}`，工作目录内的  AGENTS.md 的规则非常重要，必须严格遵守
     personaPrefix: |-
       你是一个经验丰富的编程专家，YAGNI 是你的编程哲学，PDCA 是你的行为规范
 
-      ## 语言与行为
+      ## 语言和行为
 
       - 所有思考、分析、推理过程、工具调用描述等必须使用中文，专有名词除外
       - 思考不要陷入重复循环，一旦循环，立即退出
-      - 思考聚焦需求理解与方案设计（要点、流程、验证策略），不预演具体代码实现；代码在 Do 阶段基于实际文件状态输出，正确性由 Check 验证。
+      - 思考聚焦需求理解与方案设计（要点、流程、验证策略），不预演具体代码实现；代码在 Do 阶段基于实际文件状态输出，正确性由 Check 验证
 
 - id: agent-presets
   config:
@@ -56,3 +57,10 @@
               low: low
               high: high
               max: max
+
+# 提示词分层：系统提示词只留上面的 persona，工具说明 / Agent Teams 规则 / plan
+# 规则等由该插件降级为 <system-reminder> user 消息。部署级策略，在这里定义一次
+# 即覆盖全部 preset（含子 agent），preset composition 不再各自带这一行。
+- insert:
+    - id: prompt-reminder
+      name: "@morlay/dsh-prompt-reminder"

package/dist/presets/ptc/agent.cordis.yml

@@ -1,8 +1,12 @@
 # 本文件由 packages/dsh-preset/tool/generate-presets.ts 生成，请勿手工编辑
 - id: agent-instructions
-  name: "@morlay/dsh-agent-instructions-as-prompt"
+  name: "@deepseek-ai/dsh-agent-instructions"
   config:
     maxBytes: 65536
+    instructionFileCandidates:
+      - AGENTS.md
+    localInstructionFileCandidates:
+      - AGENTS.local.md
 - id: tool-bash
   name: "@deepseek-ai/dsh-tool-bash"
   disabled: !!js process.platform === 'win32'

package/dist/presets/standard/agent.cordis.yml

@@ -1,8 +1,12 @@
 # 本文件由 packages/dsh-preset/tool/generate-presets.ts 生成，请勿手工编辑
 - id: agent-instructions
-  name: "@morlay/dsh-agent-instructions-as-prompt"
+  name: "@deepseek-ai/dsh-agent-instructions"
   config:
     maxBytes: 65536
+    instructionFileCandidates:
+      - AGENTS.md
+    localInstructionFileCandidates:
+      - AGENTS.local.md
 - id: tool-bash
   name: "@deepseek-ai/dsh-tool-bash"
   disabled: !!js process.platform === 'win32'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morlay/dsh-preset",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Personal dsh profile bundle: disables the shipped agent presets, builds generated standard / ptc presets into dist, and declares personal llm-pi-ai provider routes.",
   "keywords": [
     "dsh",
@@ -26,7 +26,7 @@
     "./cordis.patch.yml": "./cordis.patch.yml"
   },
   "dependencies": {
-    "@morlay/dsh-agent-instructions-as-prompt": "^0.0.1"
+    "@morlay/dsh-prompt-reminder": "^0.0.1"
   },
   "devDependencies": {
     "@deepseek-ai/cordis-plugin-include": "^1.0.7",

package/src/__tests__/generated-presets.spec.ts

@@ -1,9 +1,11 @@
 /**
  * 生成产物的回归测试：`dist/presets/standard` / `dist/presets/ptc` 必须等于
- * 「上游 composition 的 persona prefix 替换版」。
+ * 「上游 composition 删 persona 行、指令候选收紧为 AGENTS 系列」的版本。
  *
  * 断言方式是把产物与**现算的**期望值比较，而不是与一份快照比——上游升级后
- * 忘记重跑构建时，这条测试会失败并指出 drift，而不是继续绿着。
+ * 忘记重跑构建时，这条测试会失败并指出 drift，而不是继续绿着。期望值由测试
+ * 自己解析上游推出、不经过被测的 `renderComposition`：生成器多删 / 改任何
+ * 一行都会失败，而不是自证。
  *
  * 产物在 dist（构建输出，gitignore），因此测试自身调用 `generatePresets` 到
  * 临时目录，不依赖 build 是否跑过。
@@ -13,47 +15,112 @@
 import { mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { entryListSchema } from "@deepseek-ai/cordis-plugin-include";
+import yaml from "js-yaml";
 import { afterAll, describe, expect, it } from "vitest";
 import {
   PRESET_SOURCES,
-  INSTRUCTIONS_PLUGIN,
   PERSONA_ROW_ID,
   UPSTREAM_PRESETS,
   generatePresets,
-  renderComposition,
   renderMetadata,
 } from "../../tool/generate-presets.ts";
 
+/** 上游 preset 里承载工作区指令的行 id。 */
+const INSTRUCTIONS_ROW_ID = "agent-instructions";
+
+/** 上游那行指向的官方插件（产物须保持官方名；提示词分层由 profile 的 patch 承担）。 */
+const UPSTREAM_INSTRUCTIONS_PLUGIN = "@deepseek-ai/dsh-agent-instructions";
+
+/** 产物里指令候选的文件名（字面量：不读 CLAUDE 系列）。 */
+const PRODUCT_INSTRUCTION_CANDIDATES = ["AGENTS.md"];
+const PRODUCT_LOCAL_INSTRUCTION_CANDIDATES = ["AGENTS.local.md"];
+
+/** 上游 composition 的一行；比较只看结构。 */
+type CompositionRow = {
+  id?: string;
+  name?: string;
+  config?: Record<string, unknown>;
+  [key: string]: unknown;
+};
+
 const OUT_DIR = mkdtempSync(join(tmpdir(), "dsh-preset-"));
 afterAll(() => {
   rmSync(OUT_DIR, { recursive: true, force: true });
 });
 generatePresets(OUT_DIR);
 
+/** 独立解析 composition 文本（include 的 schema，`!!js` 标签保留为表达式节点）。 */
+function parseRows(text: string): CompositionRow[] {
+  return yaml.load(text, { schema: entryListSchema }) as CompositionRow[];
+}
+
+/** 解析上游 preset 与生成产物。 */
+function readPair(source: string): { upstream: CompositionRow[]; product: CompositionRow[] } {
+  return {
+    upstream: parseRows(readFileSync(join(UPSTREAM_PRESETS, source, "agent.cordis.yml"), "utf8")),
+    product: parseRows(readFileSync(join(OUT_DIR, source, "agent.cordis.yml"), "utf8")),
+  };
+}
+
+/** 生成器对上游 composition 的期望改动：删 persona 行、收紧指令候选。 */
+function expectedRows(upstream: CompositionRow[]): CompositionRow[] {
+  return upstream
+    .filter((row) => row.id !== PERSONA_ROW_ID)
+    .map((row) =>
+      row.id === INSTRUCTIONS_ROW_ID
+        ? {
+            ...row,
+            config: {
+              ...row.config,
+              instructionFileCandidates: PRODUCT_INSTRUCTION_CANDIDATES,
+              localInstructionFileCandidates: PRODUCT_LOCAL_INSTRUCTION_CANDIDATES,
+            },
+          }
+        : row,
+    );
+}
+
 describe("generated presets", () => {
   it.each(PRESET_SOURCES)(
-    "$source matches its upstream source with only the persona and instructions rows replaced",
+    "$source equals its upstream source with only the persona row dropped and the instruction candidates narrowed",
     (entry) => {
-      const upstream = readFileSync(
-        join(UPSTREAM_PRESETS, entry.source, "agent.cordis.yml"),
-        "utf8",
-      );
-      const actual = readFileSync(join(OUT_DIR, entry.source, "agent.cordis.yml"), "utf8");
-      expect(actual).toBe(renderComposition(entry.source, upstream));
+      const { upstream, product } = readPair(entry.source);
+      // 期望由测试自行推出：上游删 persona 行 + 收紧候选，其余逐行不动。
+      expect(product).toEqual(expectedRows(upstream));
     },
   );
 
-  it.each(PRESET_SOURCES)("$source loads the fork for workspace instructions", (entry) => {
-    const text = readFileSync(join(OUT_DIR, entry.source, "agent.cordis.yml"), "utf8");
-    // preset 是会话级 composition：不在这里换掉，上游插件仍会把 baseline 作为
-    // user 消息注入一次（profile 级的 disable 管不到 preset）。
-    expect(text).toContain(`name: "${INSTRUCTIONS_PLUGIN}"`);
-    expect(text).not.toContain('"@deepseek-ai/dsh-agent-instructions"');
-  });
+  it.each(PRESET_SOURCES)(
+    "$source keeps the agent-instructions row on the upstream plugin with AGENTS-only candidates",
+    (entry) => {
+      const { upstream, product } = readPair(entry.source);
+      const upstreamRow = upstream.find((row) => row.id === INSTRUCTIONS_ROW_ID);
+      const productRow = product.find((row) => row.id === INSTRUCTIONS_ROW_ID);
+      // 官方插件名保持（fork 一旦接入即失败，改名也不失效）。
+      expect(upstreamRow?.name).toBe(UPSTREAM_INSTRUCTIONS_PLUGIN);
+      expect(productRow?.name).toBe(upstreamRow?.name);
+      // 候选收紧为 AGENTS 系列：CLAUDE 系列不再被读取。
+      expect(productRow?.config?.instructionFileCandidates).toEqual(["AGENTS.md"]);
+      expect(productRow?.config?.localInstructionFileCandidates).toEqual(["AGENTS.local.md"]);
+      // 其余 config 字段跟随上游（如 maxBytes 的字节预算）。
+      expect(productRow?.config?.maxBytes).toBe(upstreamRow?.config?.maxBytes);
+      // 提示词分层（prompt-reminder）是 profile 的 bundle patch，不进 preset 产物。
+      expect(
+        product.some((row) => typeof row.name === "string" && row.name.startsWith("@morlay/")),
+      ).toBe(false);
+    },
+  );
 
   it.each(PRESET_SOURCES)("$source carries generated metadata", (entry) => {
     const actual = readFileSync(join(OUT_DIR, entry.source, "preset.yml"), "utf8");
     expect(actual).toBe(renderMetadata(entry));
+    // 字段级校验：多写 / 漏写字段在这里失败（上面的逐字比较是自指的）。
+    expect(yaml.load(actual)).toEqual({
+      name: entry.name,
+      description: entry.description,
+      order: entry.order,
+    });
   });
 
   it("drops the persona row: the deployment system-prompt owns the persona", () => {

package/src/__tests__/patch.spec.ts

@@ -0,0 +1,41 @@
+// 装配守卫：prompt-reminder 是 host plane 的唯一装配点。被误删 / 改名时提示词分层
+// 静默失效（工具说明回到系统提示词），这里 fail loud；persona 是 keep 名单的唯一
+// 提供者，删掉它系统提示词会变空。
+
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { entryListSchema } from "@deepseek-ai/cordis-plugin-include";
+import yaml from "js-yaml";
+import { describe, expect, it } from "vitest";
+
+const PATCH_PATH = join(process.cwd(), "packages/preset/dsh-preset/cordis.patch.yml");
+
+/** patch 的一行；只用到覆盖目标与 insert 的新增行。 */
+interface PatchRow {
+  id?: string;
+  config?: Record<string, unknown>;
+  insert?: { id?: string; name?: string }[];
+}
+
+// 用 include 的 entry schema 解析：patch 里含 `!!js` 表达式，默认 schema 会拒绝。
+const rows = yaml.load(readFileSync(PATCH_PATH, "utf8"), {
+  schema: entryListSchema,
+}) as PatchRow[];
+
+describe("dsh-preset patch wiring", () => {
+  it("declares the prompt-reminder row exactly once, on the local plugin", () => {
+    const inserted = rows
+      .flatMap((row) => row.insert ?? [])
+      .filter((row) => row.id === "prompt-reminder");
+
+    expect(inserted).toHaveLength(1);
+    expect(inserted[0]?.name).toBe("@morlay/dsh-prompt-reminder");
+  });
+
+  it("keeps the deployment persona the reminder keeps in the system prompt", () => {
+    const config = rows.find((row) => row.id === "system-prompt")?.config;
+
+    expect(config?.personaPrefix).toBeTruthy();
+    expect(config?.personaSuffix).toBeTruthy();
+  });
+});

package/tool/generate-presets.ts

@@ -6,8 +6,11 @@
  * 必须随包发布；但手工维护副本会与上游 drift。这里把上游 `standard` / `ptc`
  * 当数据读入——`js-yaml` 用 include 的 `entryListSchema` 解析（`!!js` 标签
  * 因此保留为表达式节点）——在 JS 里改两处（删掉自带的 `persona` 行、把
- * `agent-instructions` 行指向本仓库的 fork），再 `dump` 回 YAML。上游任何结构性
- * 改动（新增/重命名 row、改字段）都自动跟随，不依赖易碎的文本锚点。
+ * `agent-instructions` 行的指令候选收紧为 AGENTS 系列），再 `dump` 回 YAML。
+ * 上游任何结构性改动（新增/重命名 row、改字段）都自动跟随，不依赖易碎的文本锚点。
+ *
+ * `agent-instructions` 行是上游官方插件：工作区指令的 baseline 留在 user 消息通道，
+ * 与「系统提示词只留 persona、其余走 reminder」的分层一致。
  *
  * 产物落在 `dist/` 而非源码树：dist 是构建输出（gitignore），既不会与 oxfmt
  * 互相改格式，也不会把派生文件混进源码。
@@ -75,39 +78,41 @@ export const PERSONA_ROW_ID = "persona";
 export const INSTRUCTIONS_ROW_ID = "agent-instructions";
 
 /**
- * 承载工作区指令的插件：本仓库的 fork（baseline 走 system prompt）。
+ * 工作区指令的候选文件：只要 AGENTS 系列，不要 CLAUDE 系列。
  *
- * preset 是**会话级** composition，profile 级的 patch（禁用上游行 + 挂 fork）
- * 管不到它——不在这里替换，每个会话仍会由上游插件把 baseline 作为 user 消息
- * 注入一次。
+ * 上游默认是 `['AGENTS.md','CLAUDE.md']` 与 `['AGENTS.local.md','CLAUDE.local.md']`；
+ * 本部署不读 CLAUDE 系文件（覆盖上游 config 的这两个字段，其余字段如 `maxBytes`
+ * 保持上游值）。行本身仍是官方 `@deepseek-ai/dsh-agent-instructions`——fork 暂未
+ * 接入，见模块注释。
  */
-export const INSTRUCTIONS_PLUGIN = "@morlay/dsh-agent-instructions-as-prompt";
+export const INSTRUCTIONS_CONFIG = {
+  instructionFileCandidates: ["AGENTS.md"],
+  localInstructionFileCandidates: ["AGENTS.local.md"],
+} as const;
 
 /**
- * 把上游 composition 文本渲染成产物文本：解析 → 改 persona 与 instructions 两行 → dump。
- * @param source - 上游 preset id，用于 header 与诊断。
+ * 把上游 composition 文本渲染成产物文本：解析 → 删 persona 行、收紧指令候选 → dump。
  * @param upstream - 上游 composition 文本。
  * @returns 带 header 的产物文本。
  */
-export function renderComposition(source: string, upstream: string): string {
+export function renderComposition(upstream: string): string {
   const rows = yaml.load(upstream, {
     schema: entryListSchema,
   }) as CompositionRow[];
-  const instructions = rows.find((row) => row.id === INSTRUCTIONS_ROW_ID);
-  if (instructions === undefined) {
-    throw new Error(
-      `generate-presets: upstream \`${source}\` has no \`${INSTRUCTIONS_ROW_ID}\` row; ` +
-        "upstream changed — re-check which plugin loads the workspace instructions",
-    );
-  }
-
-  instructions.name = INSTRUCTIONS_PLUGIN;
   // 删掉 preset 自带的 `persona` 行：它会在 agent scope 注册
   // `deployment:persona-prefix` 并**遮蔽**部署级 persona（system-prompt 的
   // personaPrefix，见上游 system-prompt 的 Config 文档）。个人提示词只由
   // `cordis.patch.yml` 的 system-prompt 行提供，这里不再复制一份。
   const persona = rows.findIndex((row) => row.id === PERSONA_ROW_ID);
   if (persona >= 0) rows.splice(persona, 1);
+  const instructions = rows.find((row) => row.id === INSTRUCTIONS_ROW_ID);
+  if (instructions === undefined) {
+    throw new Error(
+      `generate-presets: upstream composition has no \`${INSTRUCTIONS_ROW_ID}\` row; ` +
+        "upstream changed — re-check which plugin loads the workspace instructions",
+    );
+  }
+  instructions.config = { ...instructions.config, ...INSTRUCTIONS_CONFIG };
   // `quotingType: '"'` 是刻意选择：yaml.dump 默认用单引号，而仓库的 oxfmt 会把
   // YAML 单引号改成双引号——不显式指定就会 fmt 与生成器来回改。指定后产物与
   // `oxfmt --check` 零差异（实测），故 `presets/**` 无需 fmt 忽略。
@@ -144,7 +149,7 @@ export function generatePresets(outDir: string = join(PACKAGE_ROOT, PRESETS_OUT_
     const dir = join(outDir, entry.source);
     mkdirSync(dir, { recursive: true });
     const compositionPath = join(dir, "agent.cordis.yml");
-    writeFileSync(compositionPath, renderComposition(entry.source, upstream));
+    writeFileSync(compositionPath, renderComposition(upstream));
     const metadataPath = join(dir, "preset.yml");
     writeFileSync(metadataPath, renderMetadata(entry));
     written.push(compositionPath, metadataPath);