dsh-lead-mode 0.1.6 → 0.1.7

package/cordis.patch.yml

@@ -51,6 +51,7 @@
 
                 - 派活自包含。teammate 看不到你的上下文，把目标、约束、验收标准、已知失败、绝对路径都写进 prompt。
                 - 要求它收尾那条消息写清交付物。它收工时那条消息会随通知回到你手上。
+                - 派活时要求它第一步建工作日志（.scratch/<effort>/worklog-<mate>.md），收尾前补完最后一轮。
                 - 写作用域不重叠。一人一块文件。分不开的活排成依赖。
                 - 共享任务走 list、get、claim（带 revision）、干、complete。task 只是账本，不是唤醒通道。
                 - 等活就结束回合等通知：teammate 收工、或给你发消息，都会唤醒你。task 变更只唤醒正在 wait_agent 的调用方，不会唤醒空闲的你。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-lead-mode",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "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

@@ -99,12 +99,74 @@ teammate 收工时，它**最后那条消息**会随通知回到你手上，格
 
 需要**中途**进度（干到一半问一句、或者要它先确认再继续）时，才另外要求它 `send_message` 给你。
 
+还有一条硬要求，写进每张单里：开建工作日志是成员的第一件事，收尾前补完最后一轮。它是你的账本，成员被 `interrupt_agent` 打断也不丢账。格式见下面的「上下文变长怎么办」那节。
+
 ### 收尾消息可能被省掉
 
 如果 teammate 在收工前刚给你发过 `send_message`，通知里不会重复它的收尾正文，而是写「It sent you a message just before finishing, so its closing message is omitted.」。
 
 也就是说：你要么拿到收尾消息，要么拿到它发的那条，不会两个都没。
 
+## 上下文变长怎么办：压缩、复用、交接、换人
+
+### 为什么会丢
+
+宿主对每个 agent 都自动压缩会话。压力到阈值就触发，会话 id 不变，早期节点被一条摘要替换。这就是**上下文降级**：细节只剩摘要，不再完整可见。
+
+团队层没有关掉压缩的开关。Lead 也没有「压缩指定成员会话」的通道，只能等它自己触发。
+
+成员活干长了，前面的细节会变薄。你不查，就当它还记得。
+
+### 怎么检测
+
+查这个成员的会话被压缩过几次：
+
+1. `list_agents` 取成员的 `id`。
+2. `session_event_search`，`session_id` 填那个 id，`event_types: ["compaction/start"]`，`surfaces: ["log-only"]`。
+3. 命中 ≥1 次，就是该成员已被压缩，细节开始丢。
+
+不要在 `wait_agent` 里套这个检查，也不要反复轮询。一次派活、验收之前查一次就够。
+
+阈值不写死。各宿主不一样，写死会过期，你只需要知道怎么查。
+
+### 交接阶梯
+
+按代价从低到高排，能不换人就不换人。
+
+1. 继续跑：命中 0–1 次、活快收尾，交给自动压缩兜住。
+2. 重发窄单：用 `send_message` 给同一个成员一张更窄的单，只做剩下的部分。成员常驻，别急着换人。
+3. 写交接文档：要求它先补完工作日志，再写 handoff，然后 `interrupt_agent`。
+4. 换新成员：`spawn_teammate`，`context` 用 `fresh`。原因写死：`fork` 拷的是你 Lead 自己的历史，不是上一个成员的历史，所以拿不到前任的细节。
+
+### 工作日志与交接文档放哪
+
+位置固定在 `.scratch/<effort>/`。一人一个 `worklog-<mate>.md`，换人时写 `handoff-<mate>-<n>.md`。
+
+`.scratch` 是 `obsidian-docs/scratch/` 的软链，笔记库能看见，不进 git。
+
+工作日志（worklog）分两段：
+
+| 段 | 写什么 |
+|---|---|
+| 状态摘要（头部，一屏内） | 任务 id 与标题、所属成员、写作用域、验收判据、当前状态 |
+| 轮次记录（下面，只追加） | 一轮一条：做了什么、改了哪些文件、下一步、踩到的坑 |
+
+交接文档（handoff）六块，全部用指针，不复制正文：
+
+1. 接手关系：谁交给谁、交接原因、时间。
+2. 任务与账本：task id、revision、owner、验收判据。
+3. 文件账：已改、未改、只读过，全部绝对路径，加工作日志指针。
+4. 验收：能复跑的命令，加最近一次输出摘要。
+5. 死路与决策：试过什么不行、为什么选现在这条。
+6. 下一步：接手第一件事、明确不做什么。
+
+### 换人操作清单
+
+- 先查名额：`/lead-mode` 报 `maxMembers`。换一次吃一个名额，创建失败的也占位，名字永不复用。
+- 旧 task 你先 `team_task_update` 执行 `release`，续作成员再 `claim`。revision 会变。
+- 续作成员名字加 `-r2` 后缀，与被接手的成员并存，不要复用旧名字。
+- `interrupt_agent` 不清空它排队的消息，打断前确认工作日志已写完。
+
 ## 写作用域不重叠
 
 两个 teammate 同时改一个文件，改动会互相覆盖，而且谁都发现不了。