spawnlisted

# spawn —— 唤起 subagent（发现 + 选型 + 两层交代 + 命名） 把「派 subagent」从零散多步收敛成一条流程，并与 agent 身份 doctrine（`.agent/agent-identity.md`）打通： 子 agent **出生即有好名**（`persona·动作·focus`）、登记进花名册，而不是事后补 rename。 > keystone：launcher 是「易唤起」与「好命名」的交汇点——起 agent 时顺手 `--title` 好名 + 建 worktree + > 选 profile + 入 roster，一次做对。 ## 适用边界 - 适用：有一段可界定的子任务要交出去——搜索/实现/审查/监控/规划等。 - 不适用：scope 还没拆清（先 `interactive-plan-doc` 写 plan）；主 agent 顺手一步能做完；需要人类副作用（走 human gate）。 ## 两种 spawn（先选一种） | 模式 | 何时用 | 载体 | 命名 | | --- | --- | --- | --- | | **in-session 子 agent** | 一次性、跑完把结果汇报回主线程（如一轮 review、一次搜索） | `Task`/`Agent` 工具 | 主 agent 在交代里给它一个 doctrine 名（便于报告署名）；不占 Paseo 标签 | | **Paseo-tab launcher（keystone）** | 需要**持久、可与 human 交互**的并行 agent（一个标签页一个 agent） | `paseo run` | **出生即命名**：`--title` + `--env AGENT_NAME=` 双表面命名 + 入 roster | ### Paseo 术语：Project / Workspace / Agent tab / Terminal tab / Worktree 选 Paseo-tab 模式前先分清这五个概念，避免"新 tab"和"新 worktree"混用： - **Project**：Paseo sidebar 里登记的目录根，可以是 Git repo 或普通目录。 - **Workspace**：Project 下的持久工作上下文，记 cwd/agents/terminals/状态；同一份代码可以有多个 Workspace，不必开 worktree。 - **Agent tab**：一个 Workspace 里的一次 agent 会话 + 其 UI tab。**默认不创建**新 Project/Workspace/worktree。 - **Terminal tab**：一个 Workspace 里的终端，不是 agent。 - **Worktree**：Git 级独立目录 + 分支；Paseo 会为它关联一个 Workspace，用于需要文件/分支隔离的任务。 本 skill 的「Paseo-tab launcher」默认对应 **Agent tab**（`paseo run` 起一次会话），是否带 worktree 由下面 `--worktree`/`--cwd` 的选择决定，不等同于"新建 Workspace"或"新建 Project"。 ### 位置选择约定（issue #47，human 拍板） 开新 agent 时「开在哪一层」按 worktree 与否钉死——位置服务于 human 手动