docs(bailian-cli): Update SKILL.md to reference new pre-flight checklist procedure

Author: hopelynd

skills/bailian-cli/SKILL.md

@@ -17,7 +17,7 @@ description: >-
 
 ## Version & updates (agent — do this BEFORE any other action)
 
-**MANDATORY:** Before running any `bl` command, follow [`assets/versioning.md`](assets/versioning.md). If versions mismatch, ask the user whether to upgrade — do not proceed silently.
+**MANDATORY:** Before running any `bl` command, complete the **Agent pre-flight checklist** in [`assets/versioning.md`](assets/versioning.md). Do NOT run any `bl` command until the checklist is complete. If versions mismatch, ask the user whether to upgrade — do not proceed silently.
 
 ## Command reference (authoritative)
 

skills/bailian-cli/assets/versioning.md

@@ -8,48 +8,37 @@
 agent** (non-TTY stderr), so the user never learns their `bl` is outdated. The
 agent must take over that responsibility.
 
-Run this flow **once per session**, before the first `bl` command.
+## Agent pre-flight checklist (MANDATORY)
 
----
-
-## 1. Align the skill with the installed CLI
+**Do NOT run any `bl` command until you complete this checklist.** Run it **once per session**, before the first `bl` command. Cache the result — do not re-check before every command.
 
-1. **Skill version** — `metadata.version` in this skill's `SKILL.md` frontmatter.
-2. **CLI version** — `bl --version` (output `bl X.Y.Z`; compare only `X.Y.Z`).
-3. If the two strings **differ**, refresh the skill first:
+1. Read this skill's version from `SKILL.md` frontmatter: `metadata.version`.
+2. Check the installed CLI version:
    ```bash
-   npx skills add modelstudioai/cli --all -g -y
+   bl --version
    ```
+   If this fails, see [Missing `bl`](#missing-bl) below.
+3. Compare the two versions (ignore the `bl` prefix; compare only `X.Y.Z`):
+   - If `metadata.version` ≠ `bl --version`, refresh the skill before doing anything else:
+     ```bash
+     npx skills add modelstudioai/cli --all -g -y
+     ```
+   - Do not trust a stale `reference/` when versions mismatch — flags may be wrong.
+4. Check the latest published CLI version:
+   ```bash
+   npm view bailian-cli version
+   ```
+5. If the installed `bl` is **older** than the latest npm version, **STOP** the current task and **ask the user** (report skill version, installed CLI version, and npm latest):
+   > A newer version of bl is available (current: X.Y.Z, latest: A.B.C). Upgrade before continuing?
+   - **Do NOT auto-upgrade silently** — the user decides.
+   - If the user agrees: run `bl update`, then continue. (`bl update` upgrades `bailian-cli` via npm and, on success, also runs `npx skills add modelstudioai/cli --all -g -y` to keep the skill in lockstep across all agent apps.)
+   - If the user declines: continue with the current version and note it in the summary.
+   - If `npm view` / `bl update` fails (offline, registry blocked, permission): continue with the current `bl` and tell the user it could not be updated.
+6. Only proceed with the user's actual task after the above is resolved.
 
-Do not trust a stale `reference/` when versions mismatch — flags may be wrong.
-
-## 2. Check the CLI against the latest published release
-
-```bash
-npm view bailian-cli version    # latest on npm
-```
-
-Compare with `bl --version`. If the installed `bl` is **older** than the latest:
-
-```bash
-bl update
-```
-
-`bl update` upgrades `bailian-cli` via npm and, on success, also runs
-`npx skills add modelstudioai/cli --all -g -y` to keep the skill in lockstep across all agent apps.
-
-## 3. Update policy — always ask first
-
-- When any version mismatch is detected, **stop and ask the user before proceeding**.
-  - Report: skill version, installed CLI version, and npm latest.
-  - Ask: "A newer version of bl is available (current: X.Y.Z, latest: A.B.C). Upgrade before continuing?"
-- **Do NOT auto-upgrade silently** — the user decides.
-- If the user agrees, run `bl update`, then continue the task.
-- If the user declines, continue with the current version and note it in the summary.
-- Do this **at most once per session** (cache the result; do not re-check before every command).
-- If `npm view` / `bl update` fails (offline, registry blocked, permission), do **not** block the task — continue with the current `bl` and tell the user it could not be updated.
+---
 
-## 4. Missing `bl`
+## Missing `bl`
 
 If `bl --version` fails, install the CLI and skill:
 
@@ -58,7 +47,7 @@ npm install -g bailian-cli
 npx skills add modelstudioai/cli --all -g
 ```
 
-## 5. Mention it in the task summary
+## Mention it in the task summary
 
 If you ran `bl update`, include it in your end-of-task summary (see
 [SKILL.md → Summarize what you did](../SKILL.md#summarize-what-you-did)), e.g.