From 5ae0675097360a4ce2d0af83e3db5ab1acf618dc Mon Sep 17 00:00:00 2001 From: xiyanjun <443951564@qq.com> Date: Fri, 28 Aug 2026 18:15:57 +0800 Subject: [PATCH] docs(skill): add preflight guidance for parallel tasks All sessions in a browser share one cookie jar, so parallel tasks hitting the same logged-in site can silently overwrite each other's login state. Add a preflight step to the Mandatory workflow advising agents to check session/tab lists for domain overlap before running tasks in parallel. Related to #132. --- crates/bsk-cli/skill/SKILL.md | 2 ++ skill/SKILL.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/crates/bsk-cli/skill/SKILL.md b/crates/bsk-cli/skill/SKILL.md index 8b18ffb..b19883c 100644 --- a/crates/bsk-cli/skill/SKILL.md +++ b/crates/bsk-cli/skill/SKILL.md @@ -36,6 +36,8 @@ Drive the user's **real Chromium browser** (with their logins and cookies) throu Every automation task **must** follow this lifecycle. Do **not** rely on idle timeouts (default session idle is 5 minutes). +**Preflight before parallel tasks.** All sessions in a browser share one cookie jar, so two tasks hitting the same logged-in site overwrite each other's login state silently. Before running tasks in parallel, run `bsk session list` and `bsk tab list --session --scope all --json` to check for domain overlap. If the target domain overlaps an active session's agent tab, run the tasks SERIALLY, or use a separate browser profile (install the extension there, then `bsk session start --browser `), since different profiles have isolated cookie jars. If you expect N parallel tasks, ensure ≥ N active sessions. + ``` 1. bsk session start → capture the 4-letter session id printed on stdout 2. … every tool command … → always pass --session diff --git a/skill/SKILL.md b/skill/SKILL.md index 8b18ffb..b19883c 100644 --- a/skill/SKILL.md +++ b/skill/SKILL.md @@ -36,6 +36,8 @@ Drive the user's **real Chromium browser** (with their logins and cookies) throu Every automation task **must** follow this lifecycle. Do **not** rely on idle timeouts (default session idle is 5 minutes). +**Preflight before parallel tasks.** All sessions in a browser share one cookie jar, so two tasks hitting the same logged-in site overwrite each other's login state silently. Before running tasks in parallel, run `bsk session list` and `bsk tab list --session --scope all --json` to check for domain overlap. If the target domain overlaps an active session's agent tab, run the tasks SERIALLY, or use a separate browser profile (install the extension there, then `bsk session start --browser `), since different profiles have isolated cookie jars. If you expect N parallel tasks, ensure ≥ N active sessions. + ``` 1. bsk session start → capture the 4-letter session id printed on stdout 2. … every tool command … → always pass --session