@ai-agent-forge/plugin-subagent-delegate 0.88.1 → 0.88.3

package/MANUAL.md

@@ -0,0 +1,23 @@
+# subagent-delegate 能力手册(AI 用)
+
+多代理编排:把可并行的独立子任务委派给子代理会话执行,主会话保持轻量。子代理有自己的上下文、工具面与模型,结果回传主会话。
+
+## 工具速查
+
+| 工具 | 用途 |
+| --- | --- |
+| subagent_run | 委派新子代理任务(单次最多 4 个并发) |
+| subagent_list | 列出本会话的子代理与状态 |
+| subagent_result | 读取(等待)子代理结果 |
+| subagent_send / subagent_inbox | 向子代理发消息 / 收信箱 |
+| subagent_steer | 运行中转向(补充指令) |
+| subagent_cancel / subagent_resume | 取消 / 恢复 |
+| subagent_escalate | 子代理向主会话升级问题 |
+| subagent_role_set / role_list / role_remove | 角色(系统提示+工具档案)管理 |
+
+## 使用原则
+
+1. **只委派可独立完成的任务**:明确输入/输出/验收;需要共享实时状态或频繁往返的活自己干。
+2. **角色隔离**:用 `role_set` 定义的角色按"术有专攻"分工(explore/reviewer/design-proposer 等),不要把编码任务给审查角色。
+3. **结果有界**:子代理回报是摘要与结论,不是全量文件内容;需要细节让子代理写文件、主会话按路径读。
+4. 并发上限与队列深度、超时由插件 config 管控(默认 8 并发/任务 5 分钟超时),超限调用会得到结构化错误。

package/README.md

@@ -16,7 +16,11 @@ capability (D-075 S4, third batch).
   - `api.host.communication` → `communicationWiring`
   - `api.host.turnContext.backgroundDigestSink` / `getTurnCorrelationId`
   - `api.host.agentDir` + `api.host.roleAssociations` → role catalog (after an
-    idempotent factory seed of `<agentDir>/roles/`)
+    idempotent factory seed of `<agentDir>/roles/`: `explore`, `reviewer`,
+    `design-proposer`, `visual-reviewer` — the latter two are the visual
+    baseline roles (2026-10-04, "术有专攻"): read-only profile narrowed to
+    `["read"]`, instructions embed the aesthetic baseline assets; see
+    `docs/plans/视觉保底角色设计注记.md`)
   - `api.host.agentDir` → the nested-depth lineage gate source
   - auto-pooling is driven by the existing config key `runnerEntryAuto`
 - Config channel: hosts declaring `api.host.agentDir` get

package/agent-forge.json

@@ -1,7 +1,7 @@
 {
 	"packageFormatVersion": 1,
 	"id": "agent-forge.plugin.subagent-delegate",
-	"pluginVersion": "0.88.1",
+	"pluginVersion": "0.88.3",
 	"apiVersion": "1",
 	"minHostVersion": "0.84.4",
 	"platform": {

package/dist/delegate.d.ts

@@ -161,8 +161,9 @@ export interface SubagentCancelResultV1 {
  * - 共享目录 `<agentDir>/roles/<id>.json` → `{ "description": …, "instructions": … }`；
  * - 可见性由**当前方案**决定：只有 `suite.associations.roles` 关联到的 id 才出现在
  *   `subagent_run` 的菜单里；没关联的角色对主代理不可见（不报错）。
- * - 工厂只做**种子落盘**（{@link seedFactoryRoleCatalog}，首次缺文件时写入 explore/reviewer
- *   两个普通文件，可改可删），默认方案关联它们，因此开箱即用；引擎从不回退到编译内的定义。
+ * - 工厂只做**种子落盘**（{@link seedFactoryRoleCatalog}，首次缺文件时写入 explore/reviewer/
+ *   design-proposer/visual-reviewer 四个普通文件，可改可删），默认方案关联它们，因此开箱即用；
+ *   引擎从不回退到编译内的定义。
  *
  * 角色今天**确定性地决定子任务的任务框定**（instructions 组装进送交子会话的提示词），
  * 但**不改变子会话的模型与工具面**——后者需要"子任务档案"这一公共契约（见
@@ -307,8 +308,8 @@ export declare function resolveSubagentRoleCatalog(options: {
 /** 角色文件名（`<agentDir>/roles/<id>.json`），供种子与目录与文档共用一处。 */
 export declare function subagentRoleCatalogPath(agentDir: string, id: string): string;
 /**
- * 出厂种子落盘（仅补缺，绝不覆盖既有文件）：默认方案关联 explore/reviewer，
- * 因此新环境开箱即用；这两个文件与用户自己写的角色完全同权——改文件即生效，
+ * 出厂种子落盘（仅补缺，绝不覆盖既有文件）：默认方案关联四个种子角色，
+ * 因此新环境开箱即用；这些文件与用户自己写的角色完全同权——改文件即生效，
  * 删文件使关联成为 dangling 诊断。引擎运行期从不回退到编译内的角色定义。
  */
 export declare function seedFactoryRoleCatalog(agentDir: string): void;