aicrosschat 0.8.7 → 0.8.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +28 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -170,6 +170,34 @@ npm run smoke # 16 项,等价于 node relay/smoke.mjs
|
|
|
170
170
|
> 早先文档里提到的 `test-core.mjs`、`test-integration.mjs`、`test-two-instances.mjs` 已不存在;双实例结果属于历史记录,当前仓库不再提供该驱动脚本,**不作为可复现声明**。
|
|
171
171
|
|
|
172
172
|
|
|
173
|
+
## 进度共享与任务颗粒度(协作约定)
|
|
174
|
+
|
|
175
|
+
跨机协作最大的成本不是算力,而是**等一个不知道卡在哪的任务**。所以把下面两条当作协议的一部分:
|
|
176
|
+
|
|
177
|
+
### 1. 任务颗粒度:一个任务 = 一个可验收的交付单元
|
|
178
|
+
|
|
179
|
+
- 派活前先拆:一个任务应当能在**一次执行**内完成、并且有一个**可判定通过/不通过的结果**(文件、测试输出、指标、链接)。
|
|
180
|
+
- 不要把一个多日目标直接丢给成员;拆成「可并行 / 有依赖」的子任务,用 `dependsOn` 串起来(见上文)。
|
|
181
|
+
- 派发时写清四件事:**目标**(做什么)、**范围**(`paths`,避免重叠)、**验收标准**(怎样算完成)、**回报点**(何时发 status)。
|
|
182
|
+
- 主控侧:板上一个任务对应一个可验收结果;不要把“调研 + 实现 + 发布”塞进同一个任务。
|
|
183
|
+
|
|
184
|
+
### 2. 进度共享:关键节点必须发 `status`,不要静默
|
|
185
|
+
|
|
186
|
+
执行方在下列节点发一条 `team_say(kind=status, taskId=…)`,一条一两句即可:
|
|
187
|
+
|
|
188
|
+
| 节点 | 内容 |
|
|
189
|
+
|---|---|
|
|
190
|
+
| 开工 | 认领后说明预期做法与预计耗时 |
|
|
191
|
+
| 遇到阻塞 | 卡在哪、需要谁提供什么(同时用 `kind=blocker` 更醒目) |
|
|
192
|
+
| 长任务中途 | 每完成一个阶段发一次(建议不超过 15 分钟或每 25% 进度一次) |
|
|
193
|
+
| 完成 | 用 `team_done(taskId, 摘要)` 收口;`answer` 只是汇报,不关闭任务 |
|
|
194
|
+
|
|
195
|
+
- **不要用“我在做了”代替具体进展**:写“已完成 X,正在 Y,预计 Z 前给结果”。
|
|
196
|
+
- 主控收到 `status` 后如无新指令可只记录不回;需要改方向时再 `team_say(kind=task)` 追加。
|
|
197
|
+
- 如果任务预计会超过原估时,先发 status 再继续,别等到超时。
|
|
198
|
+
|
|
199
|
+
> 这两条是约定而非强制校验:插件不会因为没发 status 拦截你,但审计/复盘会把“静默超时”和“颗粒度过大”当作协作问题记录下来。
|
|
200
|
+
|
|
173
201
|
## 其他客户端接入(非 DSH)
|
|
174
202
|
|
|
175
203
|
协议在 relay 层,所以参与者不必是 DSH。两种接入方式:
|