dsh-lead-mode 0.1.3 → 0.1.5

package/README.md

@@ -38,12 +38,14 @@ It covers: agreeing on the goal before starting, making a delegation self-contai
 
 Two of those facts only show up when you read the runtime source:
 
-| Fact | Consequence |
+| Fact | Why it matters |
 |---|---|
-| The only path that wakes the Lead is a teammate's own `send_message` | Omit the report-back requirement from the delegation prompt and the teammate finishes silently; the Lead stays asleep |
-| A task change only wakes a caller currently inside `wait_agent` | Marking a task complete alone cannot wake an idle Lead |
+| A teammate settling notifies you automatically, carrying its closing message | Finish your turn after delegating; you do not need to sit and watch |
+| A task change does not wake an idle Lead | Do not count on "it marked the task complete, so I know"; that path only wakes a caller currently inside `wait_agent` |
 
-So the skill's default is: finish your turn after delegating and let the message wake you (the user sees progress immediately), and use one `wait_agent` only when the current turn cannot continue without the result. Never loop `wait_agent`, and never poll with repeated `list_agents`.
+So the skill's default is: finish your turn after delegating and let the notification wake you (the user sees progress immediately), and use one `wait_agent` only when the current turn cannot continue without the result. Never loop `wait_agent`, and never poll with repeated `list_agents`.
+
+Tell the teammate to put the **deliverable in its closing message** — that message is what comes back to you with the notification.
 
 ### 3. The dependency self-check command
 
@@ -112,6 +114,28 @@ Three steps.
 
 **3. Let the model work.** With the delegation tools in place, the model splits the work, delegates to teammates, and waits for all of them before wrapping up. Without them, its first move is to tell you to enable the Team runtime.
 
+## Watching work and comms: pair with dsh-context
+
+Tool calls read one at a time. To see the whole Team's state and traffic on one page, install **dsh-context** (a separate plugin, not shipped here):
+
+```bash
+dsh plugin --profile <your profile name> add dsh-context
+```
+
+It adds a **Fleet / 编队** tab to every session (right of **Context**), and the right sidebar's **Context** panel carries the same card.
+
+| Surface | Shows |
+|---|---|
+| Summary | Member status, live context, estimated cost, task progress |
+| Agent Network | The current agent, its parents, every subagent, one card each |
+| Fleet Members | Each member's role, model, latest reply, run time, steps, active task count |
+| Tasks | Team tasks and subagent delegations together, grouped by owner, with blocked-by chains |
+| Agent Comms | Who said what to whom. Team relays, mailbox deliveries, and the runtime's settlement notices |
+
+Picking a member on the graph or the member board narrows Tasks and Agent Comms to that one agent. Opening a message in Agent Comms shows the full record: which session log it came from, its sequence, whether the runtime wrote the settlement notice or the child sent it, and the complete closing report.
+
+The Lead mode skill names this entry point too, so the model points you here instead of restating progress itself.
+
 ## Required official bundles and versions
 
 This plugin ships none of the packages below. The host or an official bundle provides them; this plugin only declares version requirements in `peerDependencies`.

package/README.zh-CN.md

@@ -38,12 +38,14 @@
 
 其中两条是读源码才确认的，容易踩：
 
-| 事实 | 后果 |
+| 事实 | 为什么重要 |
 |---|---|
-| 唤醒 Lead 的路径只有 teammate 主动 `send_message` | 派活 prompt 里不写回报要求，teammate 干完不吭声，Lead 一直睡着 |
-| task 变更只唤醒正在 `wait_agent` 的调用方 | 光靠 teammate 把 task 标 complete，唤不醒空闲的 Lead |
+| teammate 收工会自动通知你，通知里带它收尾那条消息 | 派完活结束回合就够，不用盯着等 |
+| task 变更不会唤醒空闲的 Lead | 别指望「它把 task 标 complete 了我就知道了」，那条路只唤醒正在 `wait_agent` 的调用方 |
 
-所以 skill 的默认建议是：派完活就结束回合等消息（用户立刻看到进展），只有本回合内就必须拿到结果时才用一次 `wait_agent`。不要 `wait_agent` 套循环，也不要反复 `list_agents` 轮询。
+所以 skill 的默认建议是：派完活就结束回合等通知（用户立刻看到进展），只有本回合内就必须拿到结果时才用一次 `wait_agent`。不要 `wait_agent` 套循环，也不要反复 `list_agents` 轮询。
+
+派活 prompt 里要要求 teammate **把交付物写进收尾那条消息**——那条消息会随通知回到你手上。
 
 ### 三、依赖自检命令
 
@@ -112,6 +114,28 @@ dsh plugin --profile <你的 profile 名> add https://github.com/xiebaiyuan/dsh-
 
 **3. 让模型干活。** 派活工具齐了，模型会自己拆活、派给 teammate、等齐再收尾。工具不齐，它第一句就是让你去开 Team 运行时。
 
+## 看工作和通信状态：配 dsh-context
+
+工具调用只能一条条读，Team 的状态与通信要一页看全，装 **dsh-context**（另一个插件，不随本插件安装）：
+
+```bash
+dsh plugin --profile <你的 profile 名> add dsh-context
+```
+
+它在每个会话里加一个 **编队 / Fleet** 标签页（在 **Context** 右边），右栏的 **Context** 面板里有同一张卡。
+
+| 区块 | 看什么 |
+|---|---|
+| 概要 | 成员状态、实时上下文、预估花费、任务进度 |
+| Agent Network | 当前 agent、它的父级、全部子代理，一人一张卡 |
+| Fleet Members | 每个成员的角色、模型、最新回复、运行时长、步数、在办任务数 |
+| Tasks | 团队任务与子代理派活放一起，按 owner 分组，带 blocked-by 链 |
+| Agent Comms | 谁跟谁说了什么。团队消息、邮箱投递、运行时的结算通知都在这里 |
+
+点图上的成员或成员卡，Tasks 与 Agent Comms 会收窄到那一个人。Agent Comms 里点开一条，能看到完整记录：来自哪个会话日志、第几号事件、是运行时写的结算通知还是子代理自己发的、完整收尾报告。
+
+Lead 模式 skill 里也写了这个入口，所以派活时模型会直接让你去这儿看进度。
+
 ## 依赖的官方 bundle 与版本
 
 本插件不捆绑下面这些包。它们由宿主或官方 bundle 提供，本插件只在 `peerDependencies` 里声明版本要求。

package/cordis.patch.yml

@@ -50,10 +50,10 @@
                 有这些工具，就按 Lead 工作法干活：
 
                 - 派活自包含。teammate 看不到你的上下文，把目标、约束、验收标准、已知失败、绝对路径都写进 prompt。
-                - 派活 prompt 里必须要求回报：干完用 send_message 给 lead 发一条。不写这句就不会有任何通知。
+                - 要求它收尾那条消息写清交付物。它收工时那条消息会随通知回到你手上。
                 - 写作用域不重叠。一人一块文件。分不开的活排成依赖。
-                - 共享任务走 list、get、claim（带 revision）、干、complete。
-                - 等活优选结束回合等消息：teammate 给你发消息才会唤醒你。task 变更只唤醒正在 wait_agent 的调用方，不会唤醒空闲的你。
+                - 共享任务走 list、get、claim（带 revision）、干、complete。task 只是账本，不是唤醒通道。
+                - 等活就结束回合等通知：teammate 收工、或给你发消息，都会唤醒你。task 变更只唤醒正在 wait_agent 的调用方，不会唤醒空闲的你。
                 - 不要用 wait_agent 套循环，也不要反复 list_agents 轮询。只有本回合内就必须拿到结果时才等一次。
                 - 等齐必需的 teammate 再给最终答复。
                 - teammate 继承你的模型，spawn_teammate 没法单独指定模型。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-lead-mode",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Lead mode for DSH: an agent preset, a working-method skill, a dependency self-check, and two reminders that tell you to enable the official Agent Teams. | 给 DSH 加 Lead 模式：预设、skill、依赖自检、两条前置提醒。",
   "type": "module",
   "main": "lib/index.js",

package/skills/lead-mode/SKILL.md

@@ -31,6 +31,29 @@ dsh plugin --profile <你的 profile 名> add @deepseek-ai/dsh-experimental-agen
 
 目标或指令有疑问先问用户。别自己挑一个解释就开始干。
 
+## 等通知，别轮询
+
+teammate 干完你**会被唤醒**，不用自己盯着。
+
+| 事件 | 唤醒空闲的你吗 | 带回什么 |
+|---|---|---|
+| teammate 一轮干完、没有新消息 | 会 | 它收尾那条消息 |
+| teammate 主动 `send_message` 给你 | 会 | 那条消息 |
+| task 被 claim 或 complete | **不会** | 只唤醒正在 `wait_agent` 的调用方 |
+
+所以默认这么做：**派完活就结束回合。** 把「派了谁、等什么」写清楚，然后收工。用户立刻看到进展，你不空转。teammate 收工时你被唤醒，接着干。
+
+`wait_agent` 只在「本回合内就必须拿到结果才能继续」时用一次。它的好处是 task 变更也能唤醒它。默认等 30 秒，上限 1 小时。
+
+禁止这两件事：
+
+- 用 `wait_agent` 套循环
+- 反复 `list_agents` 轮询
+
+`list_agents` 只用来回答「谁在跑、谁卡住了」，不用来等。
+
+`wait_agent` 返回 `noProgress` 不是错误，是告诉你没人在跑，该换手段。
+
 ## 派活的四个参数
 
 `spawn_teammate` 只有 `name`、`description`、`prompt`、`context` 四个参数。
@@ -49,7 +72,7 @@ dsh plugin --profile <你的 profile 名> add @deepseek-ai/dsh-experimental-agen
 
 取名字前先 `list_agents` 看一眼，别撞已占用的名字。
 
-## 派活必须自包含
+## prompt 怎么写
 
 teammate 看不到你的上下文。它能看到的只有 `prompt`。
 
@@ -62,37 +85,25 @@ teammate 看不到你的上下文。它能看到的只有 `prompt`。
 
 写「按刚才说的做」等于没派。它不知道「刚才」。
 
-### prompt 里必须写回报要求
+### 收尾那条消息就是交付物
 
-这是最容易漏、后果最严重的一条：
+teammate 收工时，它**最后那条消息**会随通知回到你手上，格式是「Its closing message:」加正文。
+
+所以派活时直接要求它收尾写清：
 
 ```
-干完用 send_message 给 lead 发一条，写：结论 + 文件清单 + 验收输出 + 偏离规格的地方。
+收尾那条消息写四块：结论 / 文件清单 / 验收输出 / 偏离规格的地方。
 ```
 
-漏了这句，teammate 干完就不吭声，你会一直睡着。原因见下一节。
+这比你额外要求一次 `send_message` 省事，而且是你默认拿得到的东西。
 
-## 等通知，别轮询
+需要**中途**进度（干到一半问一句、或者要它先确认再继续）时，才另外要求它 `send_message` 给你。
 
-唤醒 Lead 的路径只有一条：**teammate 主动给你 `send_message`。**
+### 收尾消息可能被省掉
 
-三种事件的真实行为：
+如果 teammate 在收工前刚给你发过 `send_message`，通知里不会重复它的收尾正文，而是写「It sent you a message just before finishing, so its closing message is omitted.」。
 
-| 事件 | 会不会唤醒空闲的你 |
-|---|---|
-| teammate 给你发消息 | 会。新回合开始 |
-| task 被 claim 或 complete | **不会**。只唤醒正在 `wait_agent` 的调用方 |
-| teammate 静默收工 | **不会**。teammate 是常驻的，收工不结清 |
-
-所以等活按这个顺序选：
-
-1. **优选：派完活就结束回合。** 把「派了谁、等什么」写清楚，然后收工。用户立刻看到进展，你不空转。teammate 回报时你被唤醒，接着干。
-2. **次选：本回合内就必须拿到结果才继续时，用一次 `wait_agent`。** 它的好处是 task 变更也能唤醒。默认等 30 秒，上限 1 小时。
-3. **禁止：`wait_agent` 套循环，或反复 `list_agents` 轮询。** 那是空转。
-
-`list_agents` 只用来回答「谁在跑、谁卡住了」，不用来等。
-
-`wait_agent` 返回 `noProgress` 不是错误，是告诉你没人在跑，该换手段。
+也就是说：你要么拿到收尾消息，要么拿到它发的那条，不会两个都没。
 
 ## 写作用域不重叠
 
@@ -118,6 +129,8 @@ teammate 看不到你的上下文。它能看到的只有 `prompt`。
 
 task 描述就是完整规格。规格写细一点，teammate 少问一轮。
 
+task 是给人看的账本，不是唤醒通道。别指望「它把 task 标 complete 了我就知道了」。
+
 ## teammate 用什么模型
 
 **不能单独指定。** `spawn_teammate` 没有 model 或 provider 参数。
@@ -142,10 +155,28 @@ teammate 继承你（Lead）在 spawn 那一刻的 provider 和 model。想换
 | `provisioning` | 正在创建 |
 | `failed` | 创建失败 |
 
-`inactive` 时它不吭声是正常的。想知道它干到哪，`list_agents` 看状态，`team_task_list` 看任务归属。
+`inactive` 有两种情况：teammate 已经收工（你收到过它的通知），或者它被存档了、等你再给它发消息才醒来。
 
 只有 Lead 能创建和打断 teammate（`interrupt_agent`）。打断不清空它排队的消息。
 
+### 想看全局，用 dsh-context 的编队页
+
+工具调用只能一条条读。要看整队的工作与通信，让用户开 **dsh-context** 的编队页（另一个插件，不随本插件安装）：
+
+| 区块 | 看什么 |
+|---|---|
+| 概要 | 成员状态、实时上下文、预估花费、任务进度 |
+| Agent Network | 当前 agent、父级、全部子代理，一人一张卡 |
+| Fleet Members | 每个成员的角色、模型、最新回复、运行时长、步数、在办任务数 |
+| Tasks | 团队任务与子代理派活放一起，按 owner 分组，带 blocked-by 链 |
+| Agent Comms | 谁跟谁说了什么。团队消息、邮箱投递、运行时的结算通知都在这里 |
+
+入口：任意会话点 **编队 / Fleet** 标签页（在 **Context** 右边）。右栏的 **Context** 面板里有同一张卡。
+
+装法：`dsh plugin --profile <你的 profile 名> add dsh-context`
+
+派活时可以直接告诉用户去这儿看进度，比自己复述一遍更清楚。
+
 ## 给最终答复前
 
 - 必需的 teammate 都等齐了再答。没等齐就说「还在跑」，别把半成品当结论。