dsh-agents-init

把「写 AGENTS.md」这件事整个放进子代理里跑。主对话只发出命令、只收到结果，指令正文一次都不进入主窗口。

English | 中文

它是怎么做到零上下文的

通常的技能（skill）必须先加载进模型上下文，模型才能照着做——这本身就是开销。这个插件绕开了这一步：

用户输入 /agentinit
      ↓
命令处理器直接调用 ctx.subagents.startActivation()
      ↓
子代理在自己的上下文里读 references/methodology.md，干活
      ↓
子代理结束，报告作为 subagent-settled 通知回传并唤醒主代理

关键在于命令处理器是宿主代码，不是模型。它直接派生出一个子代理，方法文档由子代理自己读取。主窗口全程没有见过任何一条指令。

| | 传统技能 | 本插件 | |---|---|---| | 激活时进入主窗口 | 全部指令（数千 tokens） | 0 | | 方法文档的读者 | 主模型 | 子代理 | | 主窗口最终付出 | 指令 + 工具轨迹 + 报告 | 命令回执 + 报告 |

这不是「把技能写短一点」，而是根本不让它进入上下文。

用法

/agentinit                          # 直接开始
/agentinit audit this repo          # 带上你的要求，原样转给子代理

命令会立即返回一行回执，例如：

Started an AGENTS.md subagent (child-0123456). Its report will arrive when it finishes; this conversation stays out of the work until then.

子代理完成后，报告自动回传。期间主对话可以继续做别的事——它没有被阻塞。

安装

plugin_manager  action=install_bundle  target=<本目录的绝对路径>

本组合包插入一行宿主条目（skill-agents-init）。index.js 只导入 Node 内置模块，因此能在任何 profile 中激活，不依赖对 @deepseek-ai/* 包的 peer 解析。

配置

全部可选。未知字段和类型错误会让激活直接失败，而不是静默忽略。

| 字段 | 默认值 | 含义 | |---|---|---| | provider | spawn | 子代理后端名。spawn 是 dsh-base 挂载的进程内实现。 | | agentPreset | "" | 给子代理指定一个 agent preset；留空则继承父级。 | | allowMethodEdit | true | 是否允许子代理修正方法文档（当某次运行证明某条规则是错的）。 | | activationNote | "" | 追加到每次运行的额外指引。 |

- id: skill-agents-init
  name: dsh-agents-init
  config:
    provider: spawn

如果配置了不存在的 provider，命令会立刻报错并列出当前可用的后端名，不会静默失败。

文件

| 文件 | 作用 | |---|---| | index.js | 宿主插件：/agentinit 命令 + 直接派生子代理。 | | references/methodology.md | 方法。只被子代理读取，从不进入主窗口。 | | cordis.patch.yml | 插入宿主条目的组合包补丁。 | | scripts/agents_md.py | 只读检查器，核验命令与路径（sections、check、stats）。 | | locale/en.json、locale/zh.json | 插件管理页的展示元数据。 | | test/smoke.mjs | 离线契约检查，使用假的 context。 | | test/runtime.mjs | 挂载到真实 Cordis 运行时，驱动真实的 commands 服务。 |

测试用纯 Node 运行，无任何依赖：

node test/smoke.mjs
node test/runtime.mjs

test/runtime.mjs 需要一份 DSH 安装。它会自动搜索常见位置，也接受 DSH_INSTALL_ROOT；找不到时打印 SKIPPED 并以 0 退出。

为什么没有 SKILL.md

早期版本把它做成了技能 + /agentinit 命令。技能路径的问题是：SKILL.md 必须注入主窗口才能生效，那 686 tokens 是每次运行都要付的。

现在插件不再注册技能提供方，SKILL.md 已删除。方法只有一个副本（references/methodology.md），且只有一个读者（子代理）。代价是：模型不能主动「发现」这个能力，只能由你输入 /agentinit 触发——这正是你要的取舍。

已知边界

隔离的是生产过程，不是产物。 AGENTS.md 一旦写入仓库，就会被 dsh-agent-instructions 自动注入——它把 AGENTS.md / CLAUDE.md 作为候选，从项目根到会话工作目录全链路加载。子代理能让你不为一整个仓库的阅读付上下文，但产出的那份文件本身仍要按设计进入每次请求。这正是 AGENTS.md 的取舍：一份小文件，换取每次请求的正确性。

修改本插件后需要重启宿主。 Node 的 ESM 没有模块缓存失效机制，插件重新启用时会复用进程内已加载的模块。改动 index.js 后请重启 DSH，而不是只切换插件的启用状态。references/methodology.md 不受影响——它每次运行都重新读取。