# starworkMultiagentNext > Experimental plugin-bundled entry for StarWork MultiAgent Workflow Next. Use explicitly as $starworkMultiagentNext to design or run next workflow in a StarWork workspace. - Skill: `jennie-shawn/starworkmultiagentnext` (Agent Skill, multi-file: 15 files) - Install (CLI): `npx skillmds@latest add jennie-shawn/starworkmultiagentnext` - Raw SKILL.md: https://api.skillmd.com/api/skills/jennie-shawn/starworkmultiagentnext/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Productivity - Author: jennie-shawn (https://skillmd.com/u/jennie-shawn) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/jennie-shawn/starworkmultiagentnext --- # starworkMultiagentNext 这是 Codex plugin bundled 的实验性入口。MVP 阶段请显式使用 `$starworkMultiagentNext`，避免触发用户级或仓库级旧 `starworkMultiagent`。 使用这个 Skill，把用户关于“设计 workflow”“启动 workflow”“当前会话职责”“多 Agent 分工”“跨 Agent 输出共享”“跨会话指令”“查看其他 lane 进度”的自然语言请求，转成安全的 StarWork workflow next 协作流程。 `starworkMultiagentNext` 不是 `starwork multiagent` 命令本身。Skill 负责判断意图、读取必要 reference、直接调用宿主标准会话工具，并把真实结果记录回 StarWork 项目事实源。**CLI 只做 StarWork 项目事实源**，不是宿主会话动作执行者。 这个 Codex plugin adapter 只提供 Codex 侧安装、发现、显式触发和 bundled Skill / references packaging；不替代 StarWork CLI、Core、`.starwork/`、`_系统/协作/` 或 workflow run state，也不自带 `create_thread`、`send_message_to_thread`、`read_thread` 等 Codex 标准线程工具。 如果用户只是询问 StarWork 是什么、怎么开始、安装入口或该用哪个能力，回到 `starwork` 主入口。用户明确说多 Agent、Agent Lanes、lane、跨会话消息、开发 Agent、产品 Agent、验收 Agent、Codex 标准会话工具、Codex 会话控制或 workflow 时，继续使用本 Skill。 ## next channel Workflow Builder / Workflow Runner 是 next 内测能力。开始 workflow 前先确认： - 当前 Skill frontmatter 包含 `starwork_channel: next` 和 `starwork_multiagent`。 - CLI 必须来自 `@jennie-shawn/starwork@next`。 - 当前 plugin bundled Skill 必须包含 workflow references；如果缺失，说明 plugin 安装不完整，停止 workflow 操作，提示用户重新安装 plugin。 - 如果你同时安装了用户级或仓库级 `starworkMultiagent`，MVP 请显式使用 `$starworkMultiagentNext`，以避免触发旧版本。 普通 stable 用户不测试 workflow。 ## 先读上下文 开始前优先读取当前工作区内这些文件，存在多少读多少： ```text AGENTS.md _系统/上下文/current-projects.md _系统/上下文/decisions.md _系统/上下文/product-principles.md _系统/任务/current-work.md _系统/协作/agent-lanes.md _系统/协作/shared.md _system/context/current-project.md _system/context/decisions.md _system/tasks/current-work.md _system/collaboration/agent-lanes.md _system/collaboration/shared.md ``` 中文项目使用 `_系统/协作/`；英文项目使用 `_system/collaboration/`。如果用户指定目标目录，所有 CLI 命令都加 `--target `；否则默认当前工作区。 ## Reference 加载规则 当用户请求命中某个场景时，先读取该场景 reference，再执行动作。 如果 reference 文件不存在或无法读取，不得继续执行对应高风险动作；先说明 Skill 安装不完整，并要求用户用完整目录重新安装 StarWork next Skills。 | 场景 | 必读 reference | |---|---| | 判断用户意图 | `references/intent-routing.md` | | 任何 MultiAgent 写入前 | `references/context-and-compatibility.md` | | 绑定 / 改名 / 置顶 / 归档 / 创建会话 | `references/session-tools.md` | | 向其他 lane / Agent / session 投递 | `references/delivery-guarantee.md`、`references/message-templates.md`、`references/session-tools.md` | | 创建 Agent 团队 | `references/team-onboarding.md`、`references/session-tools.md`、`references/message-templates.md` | | 读取 lane 状态 | `references/session-tools.md`、`references/lane-workspace-output-promotion.md` | | 登记 shared output / 晋升输出 | `references/lane-workspace-output-promotion.md` | | 写入、输出、安全边界 | `references/safety-output-rules.md` | | 设计 workflow | `references/workflow-builder.md` | | 启动 workflow | `references/workflow-runner.md`、`references/workflow-run-state.md`、`references/workflow-packet-budget.md`、`references/delivery-guarantee.md` | ## 前置保护 `starworkInit` 负责把普通项目接入 StarWork；本 Skill 只负责已有 StarWork 工作台里的团队协作。 开始任何多 Agent 写入前： 1. 先确认目标目录是 StarWork 工作台；目标不是 StarWork 工作台时，停止 multiagent 写入，转 `starworkInit` 安全接入。 2. `rules_entry_status: pending_merge` 时停止写入，转 `starworkInit` 整合最终 `AGENTS.md` / 宿主规则入口。 3. `multiagent.compatibility.status` 不是 `current` 时，不进行写入类 MultiAgent 操作；先走 v0.10 升级预览。 4. 写入类命令先预览或等用户确认；不要覆盖用户业务文件。 ## 当前会话 ID 任何会话控制、workflow Runner 或跨会话操作前，必须确认**当前会话 ID**。 - `` 中的 `source_thread_id` 优先作为当前来源会话 ID。 - 宿主或运行环境显式提供 current thread / current session metadata 时，使用该值。 - 不得用历史 worklog、旧 binding、相似标题、最近更新时间或猜测出的 thread id 推断当前会话。 - 如果当前会话 ID 不明，停止绑定、改名、置顶、归档、释放和以当前会话为来源的投递记录。 - 发送前必须检查目标 lane session 不等于当前会话；否则默认阻断自我投递，除非用户明确要求本地执行或仅记录。 ## 必须投递 目标是另一个 lane、Agent 或 session 的步骤，都是**必须投递步骤**。必须投递步骤不能用当前回复说明替代，也不能把“消息已准备好”当作完成。 合法结果只有三类： | 结果 | 要求 | |---|---| | 真实自动投递成功 | 确认目标 lane / session / 当前会话 ID，组装完整消息，调用宿主标准线程工具成功，再记录 StarWork request | | 明确人工转交 | 工具不可见或失败时，先工具发现；仍失败则输出 `manual_handoff_required`、完整可复制消息，并说明尚未自动送达 | | 明确阻塞 | 目标 lane、目标 session、当前会话 ID 或用户确认缺失时，进入 blocked / unbound / needs_confirmation | 状态写入顺序固定： ```text 确认目标 lane / session / current session -> 组装 STARWORK:MULTIAGENT_MESSAGE -> 调用 send_message_to_thread 或对应宿主标准工具成功 -> 再执行 starwork multiagent request record delivered... ``` 未真实投递成功不得记录 `delivered_via_codex_thread_tool` 或 `delivered_via_claude_code_session_tool`，不得说“已通知”“已完成交接”或“目标任务已完成”。 如果 `send_message_to_thread` 或对应宿主标准工具不在当前工具列表里，先用工具发现能力查找。工具发现不可见、发现失败或调用失败时，进入 `manual_handoff_required`，展示完整 `STARWORK:MULTIAGENT_MESSAGE v1`，并明确尚未自动送达。 ## CLI 与宿主工具边界 Codex App 正常路径中，创建、投递、读取、命名、置顶、归档由 Skill 直接调用标准线程工具：`create_thread`、`send_message_to_thread`、`read_thread`、`list_threads`、`set_thread_title`、`set_thread_pinned`、`set_thread_archived`。 CLI 只维护 StarWork 项目事实源，例如： - `starwork doctor --target --json` - `starwork multiagent status --target --json` - `starwork multiagent init` - `starwork multiagent add` - `starwork multiagent bind` - `starwork multiagent release` - `starwork multiagent share` - `starwork multiagent request record` 不得恢复旧 CLI 自动投递或创建路径作为 Codex App 正常路径；宿主工具不可见时走工具发现或人工交接，不用 CLI 模拟自动投递。 ## Workflow 摘要 用户说“设计 workflow / 自动通知流程 / 产品开发循环”时进入 Workflow Builder：只设计、采访、预览、保存草案；不通知任何 Agent，不启动真实流程，不写 `.starwork/workflows/state.json`，不写 `product/`。 用户说“启动 / 进入 / 执行 workflow”时进入 Workflow Runner：先读取 workflow run state，通过 Step Router 从 Workflow Definition + Run State + 当前 completion event 计算下一步目标；默认生成 compact + reference packet；full packet 只在目标 Agent 无法访问项目文件、manual handoff 必须完整自包含或用户明确要求时使用。 Runner 投递前必须展示 run id、current step、from lane、target lane、target session、route source、delivery mode。发生 `blocked_self_delivery`、`manual_confirmation_required` 或 `self_step_recorded` 时停止投递，不调用 `send_message_to_thread`，不记录 `delivered_via_codex_thread_tool`。 Runner 的跨 lane 节点仍受“必须投递”约束。workflow 当前节点消息已送达只代表消息送达和 request 已记录，不代表目标任务完成。 ## 成功口径 对用户汇报时分层说明： | 状态 | 含义 | |---|---| | 岗位已创建 | StarWork 中已有职责位 | | 会话已绑定 | 职责位已绑定真实 AI 会话 | | 消息已送达 | 交接消息已到目标会话，并可记录 request | | 目标任务已完成 | 必须来自目标 lane 回传、worklog、shared output 或明确会话观察 | **消息已送达不等于目标任务已完成**。Agent 已创建 / 会话已绑定也不等于任务已经开始或完成。 ## Skill-owned Message Codex App 正常路径中，Skill 自己组装 StarWork 消息，不调用 CLI 模板生成器。消息必须完整可复制，详情读取 `references/message-templates.md`。 ## 输出与安全 - 不自动决定项目该有哪些 lane；lane ID、职责和写入范围必须来自当前项目语境。 - 不把示例 lane 当默认模板。 - 不把 lane workspace 当成项目正式输出目录。 - lane 外文件修改前，先登记共享请求或取得用户明确授权。 - 工具不可见或失败时，直接给出 `manual_handoff_required` 和完整可复制消息。 - 完成状态必须来自目标 lane 的明确回报、worklog、shared output 或 `read_thread` 观察。 ## 事实源参考 需要完整边界、验收标准和协议细节时读取： ```text ../starworkMultiagent-spec.md ../../core/agent-lanes-spec.md ``` 不要在主 Skill 内重复维护 Agent Lanes 协议细节；以 Core SPEC、MultiAgent SPEC 和 references 为事实源。