chore: auto release commit (2026-06-14 11:12:03)

SKILL.md

@@ -1,12 +1,12 @@
 ---
 name: 技能开发模板（通用业务版）
-description: "OpenClaw 通用业务技能开发模板，覆盖任务执行、日志记录、外部系统对接、隔离测试等典型能力。复制后请按 references/DEVELOPMENT.md 完成定制。"
+description: "OpenClaw 通用业务技能开发模板，供复制后定制新业务 skill。定制步骤见 development/DEVELOPMENT.md。"
 version: 1.0.14
 author: 深圳匠厂科技有限公司
 metadata:
   openclaw:
     slug: your-skill-slug
-    platform_kit_min_version: "1.0.13"
+    platform_kit_min_version: "1.0.14"
     emoji: "📦"
     category: "通用"
     developer_ids:
@@ -18,19 +18,24 @@ allowed-tools:
 
 # 技能开发模板（skill-template）
 
-这是一个**用于复制的新技能模板**，不是业务技能本身。新建技能时，应复制本仓库结构，再把占位内容替换成你的真实业务实现。
+这是一个**用于复制的新技能模板**，不是业务 skill 本身。复制后请替换占位内容，实现你的真实业务逻辑。
 
-## 模板使用方式
+## 文档分工
 
-1. 复制目录为你的新 skill 仓库。
-2. 全局替换 `your-skill-slug`、`技能开发模板（通用业务版）` 等占位词。
-3. 按 `references/CLI.md`、`scripts/` 分层与 `README.md` 的说明补业务逻辑。
+| 文档 | 读者 | 用途 |
+|------|------|------|
+| 根目录 `README.md` | 普通用户 | 技能市场详情页说明（`metadata.readme_md` 主来源） |
+| `SKILL.md`（本文） | LLM / OpenClaw 平台 | 技能入口、触发与运行契约摘要 |
+| `references/` | Agent 编排/调用 | 渐进式加载：CLI 契约、字段 schema 等 |
+| `development/` | 开发者 / AI 编程代理 | 需求、开发教程、测试、技术规范 |
 
 ## 目录约定
 
-- 根目录结构参考现有规范技能：`assets/`、`references/`、`scripts/`、`tests/`、`evals/`。
-- CLI 入口固定为 `scripts/main.py`。
-- 业务逻辑按 `cli / db / service / util` 分层；公共能力从 `jiangchang-platform-kit` 提供的 `jiangchang_skill_core` 引用。
+复制后建议保留：
+
+- `assets/`、`development/`、`evals/`、`references/`、`scripts/`、`tests/`
+- CLI 入口固定为 `scripts/main.py`
+- 业务逻辑按 `cli / db / service / util` 分层
 
 ## 最小命令
 
@@ -45,18 +50,22 @@ python {baseDir}/scripts/main.py version
 ## 运行依赖
 
 - Python 运行环境由匠厂宿主注入**共享 runtime**：`{JIANGCHANG_DATA_ROOT}/python-runtime/.venv`。
-- 公共能力来自共享 runtime 安装的 `jiangchang-platform-kit>=1.0.13`（`jiangchang_skill_core` 包）；**新技能不得**在仓库内保留 `scripts/jiangchang_skill_core/` 副本。
+- 公共能力来自共享 runtime 安装的 `jiangchang-platform-kit>=1.0.14`（`jiangchang_skill_core` 包）；**不要 vendor** `scripts/jiangchang_skill_core/`，新技能不得在仓库内保留该目录副本。
 - config、logging、runtime_env、rpa、media-assets、video_session、runtime_diagnostics 等均从共享 venv 的 `jiangchang_skill_core` import，而非技能目录副本。
-- 根目录 `requirements.txt` **只声明技能特有** Python 三方依赖；`jiangchang-platform-kit`、`playwright` 等公共能力由宿主共享 runtime 提供，**不要**写入技能 requirements。宿主安装/更新技能后会将技能 requirements 安装到共享 venv。
-- `metadata.openclaw.platform_kit_min_version`（当前 `1.0.13`）是运行契约/兼容性声明，供宿主安装与启用时校验，**不是**技能 pip 依赖声明。`jiangchang-platform-kit>=1.0.13` 是当前 RPA 视频/旁白/背景音乐/前后缓冲等标准能力的最低版本。
+- 根目录 `requirements.txt` **只声明技能特有** Python 三方依赖；`jiangchang-platform-kit`、`playwright` 等公共能力由宿主共享 runtime 提供，**不要**写入技能 requirements。
+- `metadata.openclaw.platform_kit_min_version`（当前 `1.0.14`）是运行契约/兼容性声明，供宿主安装与启用时校验，**不是**技能 pip 依赖声明。
 - Skill 代码**不要**自行 `pip install`；系统级依赖（如 VC++ Runtime）仅在 `health` / preflight 中提示用户安装。
 - `health` 使用 `collect_runtime_diagnostics` 输出统一 runtime 诊断（只读，不下载/修复 media-assets）。
 
-## 重要说明
+## 定制入口
 
-- 复制后请同步修改 `scripts/util/constants.py` 中的 `SKILL_SLUG` / `SKILL_VERSION`。
-- 如技能无需持久化，可保留 `db/` 目录但不主动调用。
-- `metadata.openclaw.developer_ids` 用于声明技能发布后的默认开发者可见用户 ID 列表。
-- 当技能在平台中 `access_scope = 0`（不公开）时，任务执行流程会把 `developer_ids` 中的用户自动补写到 `skill_user_access`，使这些开发者仍可在技能市场中查看该技能。
+1. 复制目录为你的新 skill 仓库，全局替换 `your-skill-slug` 等占位词。
+2. 按 `development/DEVELOPMENT.md` 完成开发与文档定制。
+3. 用户市场说明写入根 `README.md`；Agent 调用契约见 `references/CLI.md`、`references/SCHEMA.md`。
+4. 同步修改 `scripts/util/constants.py` 中的 `SKILL_SLUG` / `SKILL_VERSION`。
+
+## 平台元数据
+
+- `metadata.openclaw.developer_ids`：技能发布后的默认开发者可见用户 ID 列表。
+- 当 `access_scope = 0`（不公开）时，平台会把 `developer_ids` 中的用户自动补写到 `skill_user_access`。
 - `developer_ids` 建议写为正整数数组；第一个 ID 会作为主开发者同步到 `skills.developer_id`。
-- 面向用户与编排的文档写在 `references/`，不要再新增旧式 `docs/` / `optional/` 结构。