重新调整模板

README.md

@@ -5,7 +5,7 @@
 ## 模板目标
 
 - 对齐当前规范 skill 的目录结构：`assets/`、`references/`、`scripts/`、`tests/`、`evals/`
-- 对齐当前规范脚手架分层：`scripts/cli`、`scripts/db`、`scripts/service`、`scripts/util`、`scripts/jiangchang_skill_core`
+- 对齐当前规范脚手架分层：`scripts/cli`、`scripts/db`、`scripts/service`、`scripts/util`；公共能力从共享 runtime 的 `jiangchang-platform-kit` 引用
 - 提供最小可运行入口：`python scripts/main.py health` / `version`，以及通用任务命令骨架 `run` / `logs` / `log-get`
 - 内置 **隔离测试体系**：`IsolatedDataRoot`、双键环境、`OPENCLAW_TEST_TARGET` 档位与 adapter profile 策略（详见 [`references/TESTING.md`](references/TESTING.md)）
 - 让新技能从一开始就按规范落地，不再沿用旧模板的 `docs/`、`optional/`、`skill_main.py` 结构
@@ -56,9 +56,22 @@ python scripts/main.py version
 
 ## Python 依赖（requirements.txt）
 
-- 在技能**根目录**维护 `requirements.txt`，声明本技能特有的 Python 三方包。
+- 模板默认声明 `jiangchang-platform-kit>=1.0.11` 作为公共 SDK 依赖；`jiangchang_skill_core` 来自共享 runtime，**不在技能仓库内复制**。
+- 新技能**不得 vendored** `scripts/jiangchang_skill_core/`；复制模板后若发现该目录，应删除并改为依赖共享 venv。
+- 在技能**根目录**维护 `requirements.txt`，声明本技能特有的 Python 三方包（在 platform-kit 之外按需追加）。
 - 匠厂宿主在**安装或更新**技能后，会将该文件中的依赖安装到共享 Python runtime：
   `{JIANGCHANG_DATA_ROOT}/python-runtime/.venv`（Windows 示例：`D:\jiangchang-data\python-runtime\.venv`）。
-- 平台通用依赖由宿主 `resources/jiangchang-python-runtime/pyproject.toml` 维护；**不要**把业务依赖写进宿主 pyproject。
 - **Skill 业务代码不得自动 `pip install`**；缺依赖时应在 `health` / preflight 中给出清晰错误。
 - **系统级组件**（如 Microsoft Visual C++ Redistributable）**不要**写进 `requirements.txt`；仅在 `health` / preflight 中提示用户自行安装。
+
+## 公共能力边界
+
+以下能力均由 `jiangchang-platform-kit`（共享 runtime 的 `jiangchang_skill_core`）提供，技能只写业务逻辑与薄封装，**不要**在技能内复制实现：
+
+- `config` — `.env` 三级优先级读取与首次落盘
+- `runtime_env` — 数据根、用户 ID、兄弟技能根解析
+- `unified_logging` — 统一日志与 trace
+- `rpa` — 浏览器/桌面/手机 RPA 共享库
+- `media_assets` — 共享媒体资源探测与路径解析
+- `video_session` — RPA 录屏成片（ffmpeg、字幕、背景音乐）
+- `runtime_diagnostics` — `health` 统一 runtime 诊断