dsh-lead-mode 0.1.3 → 0.1.4

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
 

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 **把交付物写进收尾那条消息**——那条消息会随通知回到你手上。
 
 ### 三、依赖自检命令
 

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.4",
   "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 干完就不吭声，你会一直睡着。原因见下一节。
-
-## 等通知，别轮询
-
-唤醒 Lead 的路径只有一条：**teammate 主动给你 `send_message`。**
+这比你额外要求一次 `send_message` 省事，而且是你默认拿得到的东西。
 
-三种事件的真实行为：
+需要**中途**进度（干到一半问一句、或者要它先确认再继续）时，才另外要求它 `send_message` 给你。
 
-| 事件 | 会不会唤醒空闲的你 |
-|---|---|
-| teammate 给你发消息 | 会。新回合开始 |
-| task 被 claim 或 complete | **不会**。只唤醒正在 `wait_agent` 的调用方 |
-| teammate 静默收工 | **不会**。teammate 是常驻的，收工不结清 |
+### 收尾消息可能被省掉
 
-所以等活按这个顺序选：
+如果 teammate 在收工前刚给你发过 `send_message`，通知里不会重复它的收尾正文，而是写「It sent you a message just before finishing, so its closing message is omitted.」。
 
-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,7 +155,7 @@ teammate 继承你（Lead）在 spawn 那一刻的 provider 和 model。想换
 | `provisioning` | 正在创建 |
 | `failed` | 创建失败 |
 
-`inactive` 时它不吭声是正常的。想知道它干到哪，`list_agents` 看状态，`team_task_list` 看任务归属。
+`inactive` 有两种情况：teammate 已经收工（你收到过它的通知），或者它被存档了、等你再给它发消息才醒来。
 
 只有 Lead 能创建和打断 teammate（`interrupt_agent`）。打断不清空它排队的消息。