From 9ffb6e5341aac103643c6569fe0193504b3dc524 Mon Sep 17 00:00:00 2001 From: wantsong Date: Wed, 24 Jun 2026 15:08:48 +0800 Subject: [PATCH] =?UTF-8?q?=E7=AC=AC=E4=B8=89=E8=BD=AE=E6=B5=8B=E8=AF=95?= =?UTF-8?q?=E6=B4=BE=E5=8F=91=E5=AD=90=E4=BC=9A=E8=AF=9D=E6=94=B9=E4=B8=BA?= =?UTF-8?q?=E6=96=B0=E5=AD=90=E4=BC=9A=E8=AF=9D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 68673ad..18beb97 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -79,16 +79,18 @@ Use these terms as the default implementation contract for Video Workbench slide | User term | Meaning | Default carrier | | --- | --- | --- | -| `子会话` / `session` | A user-visible separate Codex session for brief / orchestration work. | `codex_app.fork_thread` to create, `codex_app.send_message_to_thread` to continue, `codex_app.read_thread` to inspect. | +| `子会话` / `session` | A user-visible separate Codex session for brief / orchestration work, started from a clean prompt rather than inherited orchestration history. | `codex_app.create_thread` to create, `codex_app.send_message_to_thread` to continue, `codex_app.read_thread` to inspect. | | `继续前子会话` | Continue the already recorded visible child session instead of creating a new one. | Send the next instruction to the recorded `threadId`. | | `Agent` / `SubAgent` | An internal one-shot worker owned by the child session; it should not appear as a separate user-visible Codex session. | `multi_agent_v1.spawn_agent(agent_type="worker")`; one worker handles exactly one slide. | | `无 review` | Review is disabled for the named scope. | Do not write `sNN-vN-review.md`; record only packet / return / ledger / task-log evidence. | -If the default tools are not already exposed in a new session, use `tool_search` to expose `fork_thread`, `send_message_to_thread`, `read_thread`, and `spawn_agent` by name, then proceed with this contract. +Do not use `codex_app.fork_thread` as the default carrier for production child sessions. Forking copies completed orchestration history from the parent thread and can contaminate the child session's context. Use `fork_thread` only when the user explicitly wants an inherited-context branch. + +If the default tools are not already exposed in a new session, use `tool_search` to expose `create_thread`, `send_message_to_thread`, `read_thread`, and `spawn_agent` by name, then proceed with this contract. Default preflight for a slide/session run: -- confirm the target visible session id or create exactly one new visible session; +- confirm the target visible session id or create exactly one new clean visible session with `create_thread`; - scan the target slide folder for the next unused `sNN-vN-*` version; - set `Overwrite allowed: no`; - record whether review is disabled or enabled;