← Skill中心

以后如何更新Skill

以后附上技能包、SKILL.md或仓库地址,再发送下面这句话。

请按橙岛 Skill 入库标准处理这个技能:审核去重,补齐用途、功能、输入输出、调用示例、依赖费用与验证状态,安装可用版本并更新发布到 https://www.tiktok-toolbox.com/resources;保留旧版,不删除已有技能,不把未验证能力写成已生效。

统一入库规则

# 橙岛 Skill 入库标准 v1.0.0

正式源码与交付物统一存放在 /Users/borytan/Documents/Codex 的 proj_序号_skill_技能名称 项目中。默认宿主目录只作为安装副本;源码变更、版本和校验记录以项目为准。

## 固定更新指令

请按橙岛 Skill 入库标准处理这个技能:审核去重,补齐用途、功能、输入输出、调用示例、依赖费用与验证状态,安装可用版本并更新发布到 https://www.tiktok-toolbox.com/resources;保留旧版,不删除已有技能,不把未验证能力写成已生效。

这句话表达本次审查、安装和网页发布授权;不授权发信、发布社媒、改价、读取浏览器登录凭据、调用收费API或删除原有技能。缺必要授权/许可证时完成其余工作,明确列出该项待办。不要为已有授权重复询问。

## 每项必须写清的说明

1. 名称、唯一ID、语义版本、来源与原许可。
2. 解决什么问题、何时值得调用、何时不适用。
3. 具体能力,每项对应实际流程或工具;不凑固定数量。
4. 输入字段与样例、缺失/过期/矛盾数据如何处理。
5. 交付文件与字段、稳定主键、下游如何使用;说明不存在的字段,不合成伪评分。
6. 调用指令与步骤、宿主及运行依赖、权限范围。
7. 费用:本地处理、大模型、平台数据、邮件查询、媒体生成分别核对,写实际计费单位;没有证据不得写免费。
8. 外部副作用、授权边界、预算上限和停止条件。
9. 验证:结构审查、本地样例、真实任务、业务效果分开;没有实测标未验证。
10. 来源、适配改动与可回滚旧版。

## 从 OpenOutreach 采纳的执行契约

执行型Skill先有可运行工具,再写说明;方法型Skill可以提供诊断/策划/交付流程,必须明确不提供自动执行。不能为了套模板发明CLI。

已有CLI才定义零副作用的status入口,说明它是否联网、是否读取账户、是否消耗积分;未实现status就不要声称存在。任务应有界:目标、预算、超时、停止条件写清。若已有异步任务,说明提交和完成分别是什么,不把两者混为一谈。

stdout用于结果,stderr用于运行信息;JSON/CSV有稳定schema_version、主键与字段含义。增量还是总量必须逐工具核对,重跑是否恢复/重复/重置要实测,不能把OpenOutreach的语义套到别的工具。

失败与空结果分开:unauthorized、missing_dependency、rate_limited、invalid_input、provider_unavailable、partial、no_match分别说明。非零退出不保证有部分成果,只有返回真实成果才叫局部完成。限流按Retry-After与上限退避;认证失败不无限重试。

默认不调用额外付费接口。需要计费时记录单价来源、计费单位、调用数量上限和预算,不能把“一个线索”当“一个API请求”。凡会发信、发布、写平台或产生账单的动作,先检查用户是否已有相应授权;安装或找线索不等于发信授权。

网页收录、宿主安装、工具连接、任务成功、业务效果是五个不同状态。网页只检索阅读和下载,不凭按钮就声称执行。

## 审查与更新顺序

文件清点 → 来源/许可/隐私/执行代码审查 → 内容哈希去重 → 同名版本比较 → 能力和依赖说明 → 格式与必要契约测试 → 安装回读 → 预览验收 → 完整生产基线上发布 → 两域名及文件回读。

独立信源按发布主体与原始稿件族核对,不按域名数量充数。机会逐条挂证据与未做原因;统一竞品维度;对抗自审保留真实反驳与降级记录。脚本验证结构与关联,不能证明资料真伪或商业收益。

## 不照搬的内容

OpenOutreach资料提供的是该工具当时的约定。发现/筛选仍可能付LLM账单;“未花邮箱积分”不等于总成本为零。状态成功不等于查询达成,退出0含义逐命令确认。原文源码许可保留,不把第三方GPL或未声明许可改成MIT。宿主路径与参数在目标环境实测,不仅凭文章安装说明。