docs: clarify shared Python, CLI vs Action, and Task Center rules

development/SKILL_ACTION_RUNTIME.md

@@ -20,8 +20,8 @@
 1. **宿主管调度，技能管业务** — 不自行实现任务中心 / Job 轮询 / 后台守护进程。
 2. **单业务内核、多入口** — 数据管理、定时任务、Agent、技能详情与直接 CLI 复用同一 domain service；禁止按入口复制业务逻辑。
 3. **五职责正交** — `placements` / `bind.tables` / `executionProfile` / `entrypoint` / domain service 各管一事（见 ACTIONS.md）。
-4. **长耗时建议 async** — 开浏览器、RPA、HTTP 大文件下载等建议 `executionProfile: "async"`，进**任务中心**；这是选择建议，**不**限制可以出现在哪些 placement。
-5. **Agent 禁止 `exec` 直跑长任务 CLI** — 必须 `run_skill_action`；禁止 `exec python main.py run` + `process poll` 干等。
+4. **长耗时建议 async** — 开浏览器、RPA、HTTP 大文件下载等建议 `executionProfile: "async"`，进**任务中心**；这是对**方法**的选择，**不**限制可以出现在哪些 placement / 入口。
+5. **Agent：短 CLI / 长 Action** — 短查询可用共享 Python bash CLI；长任务 / RPA **禁止** `exec` + `process poll`，必须 `run_skill_action`。
 6. **进度走 Journal** — `emit` / `video.add_step` → Run Journal；UI / Skill Run Card / 任务中心展示；**不靠 stdout 流**。
 7. **显式声明 `executionProfile`** — 每个 action **必须**写明 `sync` 或 `async`；禁止依赖宿主缺省；禁止第三种模糊模式（`auto` / `background` / `deferred` 等）。
 
@@ -160,15 +160,15 @@ cmd_stats()                 # 只读 sync：JSON stdout，无 job_context
 
 ## 8. Agent / SKILL.md 契约（复制后必改）
 
-业务技能 `SKILL.md` 应明确：
+业务技能 `SKILL.md` / `references/` 应明确（Agent 主读，勿只写在本文）：
 
-1. 副作用任务必须通过宿主 **Skill Action**（`run_skill_action`）调用。
-2. **禁止**对长任务使用 `exec` + `process poll`。
+1. 短查询：共享 Python（`JIANGCHANG_PYTHON_EXE`）跑 CLI；**禁止** `uv run`。
+2. 长任务 / RPA / async Action：必须通过宿主 **Skill Action**（`run_skill_action`）；**禁止** `exec` + `process poll`。
 3. 单条 vs 批量 action id 与参数（如 `url` / `pickCount`）。
-4. 长任务进度看**任务中心** / Skill Run Card，不等 CLI stdout。
-5. 多入口复用同一业务内核；异步 Action 进入任务中心。
+4. `executionProfile: async` → 进度看**任务中心** / Skill Run Card；`sync` → 当场结果。与入口无关。
+5. 多入口复用同一业务内核。
 
-模板源仓库的 `SKILL.md` 含占位段落；scaffold 后按业务改写。
+模板源仓库的 `SKILL.md` / `references/ACTIONS.md` 含占位段落；scaffold 后按业务改写。
 
 ---