Tianyi Cui
9dcc8fa985
Integrate master 78ae4fc2d4d8ecaebb4b674028f781a358b92cc9 after the four independent review fixes. Keep this base update separate from those fixes and from subsequent review changes so the integration is independently reviewable and the observed-master checkpoint remains preserved. Retain activation-owned execution, caller-independent local discovery, and unconditional parent final-answer delivery. Preserve master's preset scoped scheduling tools and all delegated-child schedule deny rules. Move the new scheduling regression from the removed driver package into the surviving subagent package and run it through a real Spawn activation. Preserve master's removal of runtime invariant plugins, dependencies, exports, and test mounts. Keep context disposal before fixture directory cleanup. Combine Python workflow ordering with activation/catalog events without inventing unsupported source-plane import paths. Keep all frozen Agent Note archives byte-for-byte identical to master; do not accept Git's automatic edits to renamed archived notes. Retain current lifecycle and delivery facts in active documentation, repair its links, and regenerate catalogs/persistence schemas from merged source. All 62 master persistence roots remain; only subagent/catalog gains the PR's external membership extension. Keep master's third-party lock graph and update only workspace dependency changes. Validation before this checkpoint: 683 focused tests passed, seven Windows-only cases skipped; 2,772 archived artifacts verified. Generated catalog and active-pair checks passed. Fresh artifact build and remaining build-dependent documentation checks continue before publication.
2.9 KiB
2.9 KiB
description, kind
| description | kind |
|---|---|
| subagent 包组：委派 seam、其进程内与进程外后端，以及面向模型的委派工具。 | package-group |
subagent/：subagent 能力家族
English | 中文
概述
subagent 包家族让 agent（智能体）将任务委派给子 agent、继续其工作，并发现自己创建的每个子级。隔离工作可选择全新的进程内子级；需要既有对话时可选择带父级历史的进程内子级；也可选择由 ACP（Agent Client Protocol）、Codex、Claude Code 或另一 Harness 运行时支持的进程外子级。面向模型的工具还让 agent 能够向相邻 agent 发送消息、中断工作并列出子级状态。无论子级正在运行还是已存储，父级都能看到它；各包 README 说明各提供方特定的设置与限制。
目录
包
| 包 | 职责 | ctx 键 |
|---|---|---|
subagent/ |
定义委派服务：提供方注册表、一次性运行、可继续子级与发现 | ctx.subagents |
subagent-spawn-in-process/ |
运行全新的进程内子 agent | 注册到 ctx.subagents |
subagent-fork-in-process/ |
运行从父级已完成历史派生的进程内子 agent | 注册到 ctx.subagents |
subagent-acp/ |
经 Agent Client Protocol 运行进程外子 agent | 注册到 ctx.subagents |
subagent-codex/ |
经官方 app-server 协议运行真实 Codex 子 agent | 注册到 ctx.subagents |
subagent-claude-code/ |
经官方 Agent SDK 运行真实 Claude Code 子 agent | 注册到 ctx.subagents |
subagent-dsh-sdk/ |
经 TypeScript SDK 运行进程外 Harness 子 agent | 注册到 ctx.subagents |
tool-subagent/ |
向模型公开委派 | 注册到 ctx.tools |
tool-subagent-control/ |
向模型提供向相邻 agent 发送消息、中断工作和列出子级状态的操作 | 注册到 ctx.tools |
相关文档
- Subagent 子系统——服务约定、提供方约定与终态结果语义。
- 历史Subagent 能力 seam——委派能力家族的设计记录。
- 可继续的 subagent——接受后续轮次的持久子级。
- tool-subagent-control README——后续消息、中断与列举接口。
开发备注
无。