上线前 checklist

什么时候读：技能写完、交付前。逐条打勾，把未满足的列给用户。不跳条。只核对适用的段：不碰数据表就跳过「数据表」段，不调别的技能就跳过「技能间调用」段。

形态与入口

入口是 async def execute(input_data, runtime_context)（名字、参数名、async 三项照抄；否则 create_skill / edit_skill 拒装），第二参数无默认值
frontmatter name 匹配 ^[a-z0-9][a-z0-9_-]*$ 且与目录名一致
碰数据库 / 用 call_skill → async def；直连从 db_factory 现开现还，不读 ctx["db"]
子进程型：日志走 stderr，stdout 只打最终 JSON；业务失败退出码 0 + success:false
模块内确有入口函数（漏了静默降级成文档型）
进程内 handler 里没有 argparse + __main__（会被判成 CLI）

固定词表的键直接判空，未写多余 .get(k, "")
actor_is_admin / 身份键为空的分支已处理，未把空值当最低档位放行
triggered_at 当 float 用；attachments 读 type（att_type 是过渡别名）；部门判断优先用 actor_department_id
不靠 channel 判断调用来源（页面线会被覆盖）；team_role 缺失按无权限处理（页面线不注入）
org_id 缺失时返回 error_type=config + non_retriable=true
工号取 actor_emp_no（不读 emp_no）；行级过滤依赖它的技能在真库验过「非管理员能看到自己的行」，经 call_skill 路径也验过
部门路径匹配带首尾斜杠；判本级用末段

密钥按四层顺序取（skill_configs[skill] → skill_configs → skill_args → ctx → env），未要求模型传密钥
文档中的凭证只用 $VAR 引用，无「打印出来确认」步骤
非凭证常量名不含 key/token/secret/password/credential/auth 子串；自测按子串扫
需要配置：顶层 env: 结构化声明（控制台表单读）+ metadata.openclaw.requires.env / bins（执行前校验读），两处都写
不需要配置：写 env: []，避免正文嗅探冒出假配置项
技能目录里没有含密钥 / 内部数据的 .json .js .html 等文件（/ui/asset 免鉴权可下载，无面板也一样）

本地面板：ui: 是技能目录内的 .html 相对路径且文件存在，建议放 ui/ 子目录；不想要面板的技能根目录没有 panel.html / ui.html / index.html
本地面板：schema 写了 properties.action.enum，面板调的每个动作都在其中（网关只认它，不认 x-actions）
本地面板：enum 里的写 / 删 / 结构类动作在 handler 内自鉴权（actor_emp_no / actor_is_admin / 业务条件），不依赖网关
本地面板：ui.html 只用 src= / href= 相对路径；无 /api、/xxx 站点根路径、http(s) 绝对地址；没有 CSS url() 与 JS 相对 import
本地面板：app.js 完整 ready/init/invoke/invoke_result 握手，频道 skill_panel，ready 必发
本地面板：无 localStorage/sessionStorage；无 fetch 直连后端；动作返回字段名与面板 res.data.xxx 对得上
本地面板：入口目录树里没有敏感文件（静态资源免鉴权公开）
外部面板：ui: 是 http(s) URL；未生成本地面板文件
外部面板：技能说明提醒了对接方三件事（frame-ancestors 放行 + 接 panel_token + 用 PEM 公钥验签，aud = 面板 URL 的 host[:port]、iss 默认 myinc-platform）

SKILL.md < 8000 字符，细节拆 references/ 并写明何时读
frontmatter 是合法 YAML：值里出现「英文冒号+空格」的整句加引号（否则平台退回逐行解析，嵌套块全丢）
category 是 13 个合法值之一；category / cost-tier / async / env 写在顶层，不塞进 metadata
文档型：任何位置都没有无意放置的 openapi.* / endpoints_whitelist.*（会被判成 API 型）
description 说清「什么时候该调它」，带触发词
未 import 其它技能
动作型的 SKILL.md 明写「action 必须传中文原词」+ 三个调用示例；帮助表左列是触发场景
角色提示词（若有）：明令不复述工具返回值；不许改的文本做成工具动作；可变配置先查再答；positive-examples / negative-examples 齐全