skill-template/SKILL.md

name, description, version, author, metadata, allowed-tools

name	description	version	author	metadata	allowed-tools
技能开发模板（通用业务版）	OpenClaw 通用业务技能开发模板，覆盖任务执行、日志记录、外部系统对接、隔离测试等典型能力。复制后请按 references/DEVELOPMENT.md 完成定制。	1.0.14	深圳匠厂科技有限公司	openclaw slug platform_kit_min_version emoji category developer_ids your-skill-slug 1.0.13 📦 通用 10032 12428	bash

技能开发模板（skill-template）

这是一个用于复制的新技能模板，不是业务技能本身。新建技能时，应复制本仓库结构，再把占位内容替换成你的真实业务实现。

模板使用方式

1. 复制目录为你的新 skill 仓库。
2. 全局替换 your-skill-slug、技能开发模板（通用业务版） 等占位词。
3. 按 references/CLI.md、scripts/ 分层与 README.md 的说明补业务逻辑。

目录约定

• 根目录结构参考现有规范技能：assets/、references/、scripts/、tests/、evals/。
• CLI 入口固定为 scripts/main.py。
• 业务逻辑按 cli / db / service / util 分层；公共能力从 jiangchang-platform-kit 提供的 jiangchang_skill_core 引用。

最小命令

python {baseDir}/scripts/main.py health
python {baseDir}/scripts/main.py config-path
python {baseDir}/scripts/main.py version

配置：仓库 .env.example 为模板；用户 .env 在 {CLAW_DATA_ROOT}/{CLAW_USER_ID}/{slug}/.env，启动时自动 bootstrap。优先级：进程环境变量 > 用户 .env > .env.example。

运行依赖

• Python 运行环境由匠厂宿主注入共享 runtime：{JIANGCHANG_DATA_ROOT}/python-runtime/.venv。
• 公共能力来自共享 runtime 安装的 jiangchang-platform-kit>=1.0.13（jiangchang_skill_core 包）；新技能不得在仓库内保留 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 视频/旁白/背景音乐/前后缓冲等标准能力的最低版本。
• 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，使这些开发者仍可在技能市场中查看该技能。
• developer_ids 建议写为正整数数组；第一个 ID 会作为主开发者同步到 skills.developer_id。
• 面向用户与编排的文档写在 references/，不要再新增旧式 docs/ / optional/ 结构。