# Skill 市场 · 给 Agent 装能力,也把你的能力卖出去

> 技术参考 · 承接《[Agent 能力导航](03-agent-capabilities.md)》。
> Skill 是一段可复用的**行为能力**——在特定场景下自动激活的一套打法。市场让你**给自己的 Agent 装上别人写好的能力**,也让你把**自己打磨出的能力发布出去、被别人安装、甚至付费购买**。这一篇讲清楚两个方向怎么走、钱怎么算、发布有哪些红线。

---

## Skill 是什么

**一段"遇到某种场景就自动用上"的行为模式。** 它带一段策略提示,系统靠语义匹配决定什么时候激活它。比起零散的记忆,Skill 是**结构化、可复用、可交易**的能力单元。

Agent 自带一组平台原生 Skill;此外它可以从市场安装别人发布的,也可以把你为它配置的能力发布到市场。原生能力会随平台演进,以 Agent 当前实际加载的清单为准。

---

## 方向一:给你的 Agent 装能力

- **浏览**:`browse_listings(query, category, order)` 看榜单;`get_listing(id)` 看完整内容。
- **安装**:`install_listing(id)` 把内容拷进本地技能。幂等——重复装不会重复计费。
- **卸载**:`uninstall_listing(id)` 暂停本地这条技能。

### 付费 Skill:首次授权前必须确认

第一次购买、订阅或启用按次计费时,系统会返回"需要付款"及**完整条款 + 作者**。规则是硬的:

> Agent **必须把确切条款和作者原样报给你、拿到你明确确认**,才会带 `confirmed=True` 完成首次授权。确认不是"每笔都再问一次":订阅会按周期自动续费,按次方案会在成功触发后自动扣款;余额不足时技能暂停。

当前付费方式包括:

- **一次性买断**:`one_time`,确认后只付一次;
- **订阅**:`subscription`,首次确认后通常每 30 天自动续费;
- **按次**:`usage`,可带安装费/免费试用,之后按成功触发次数扣款;
- **组合方案**:`multi`,可组合入场费、买断、订阅和按次方案。

部分条目也支持链上 USDT 定价。无论哪种方式,首次授权时都必须看清本次费用、后续计费方式和作者。

**分成:作者 90%,平台 10%。**

### 退款(仅首次 Spark 安装 / 首次访问费用)

同时满足才自动退:

- 安装后 **7 天内** 卸载,**且**
- 这条技能**从没被触发过**(usage_count == 0)
- → 自动退 **90% Spark**(留 10% 作重新上架费)

超过 7 天、**或**已经用过一次,都**不退**。订阅续费、按次用量费和链上 USDT 购买也不在这套自动 Spark 退款范围内。另外:退过某付费 Skill 后,90 天内不能发布与它高度近似的技能(防"学完就退再抄")。

---

## 方向二:在对话里造一个新 Skill

先分清两种 Skill,它们的造法不同:

- **Prompt Skill(行为技能)**:一套说法、策略、检查清单——靠注入 Agent 自己的上下文生效。用 `create_skill(...)` 直接写出来。
- **沙盒 Skill(bundle)**:要真的**跑代码**——装 CLI、执行脚本、带凭证调外部 API、产出文件。它是一个包(`SKILL.md` + `scripts/`),在一次性 MicroVM 里由另一个 Claude 按 `SKILL.md` 执行。

造沙盒 Skill 也可以完全在对话里完成,四步:

1. `save_skill_draft(...)` —— 写草稿。`SKILL.md` 是**给另一个 Agent 看的操作手册**,不是程序:frontmatter 的 `description` 要写清"什么时候该用",正文写 Setup + 编号步骤 + 红线。凭证**绝不写进文件**,而是声明在 `sandbox.auth`,运行时以 `$CC_SECRET_<KEY>` 注入。
   - 自己写不出来的时候用 `build_skill_draft(...)`:把草稿交给**沙盒里的 skill-builder** —— 一个跑在隔离 VM 里的完整编码 Agent,有文件系统、能执行脚本、能连网查证,改完把文件写回草稿。适合"这个 API 返回长什么样得先跑一下才知道"这类活。它**一个凭证都没有**(只写代码,带凭证的验证归第 3 步),也**不能发布**、碰不到别的技能。同样按实际算力计费,所以自己写得出来的就别叫它。
2. `check_skill_draft(...)` —— 一次列出所有问题(表单、包结构、密钥硬编码扫描)。
3. `test_skill_draft(...)` —— **真的起一个沙盒跑一次**。按实际 token 计费。声明了 `depends_on` 的父 Skill 必须已安装,试跑时会把父的真包一起装进沙盒,**凭证也和发布后一模一样**(否则子技能连父都认证不上,测了等于没测)。若其中包含敏感凭证(父自铸的身份、钱包私钥),结果会逐条列出、我会明说一句 —— 毕竟这是把它们交给了一段还没人审过的代码。
   - 写 `depends_on` 之前先用 `read_skill_docs(bundle_id)` 读父技能的手册:子技能要调父的 CLI,命令和参数得照父作者写的来,猜是猜不对的。
4. `publish_skill_draft(...)` —— 默认 **private**:只装给自己用,不进市场、不占名额、不收上架费,安全审核照跑,过了就直接能 `run_skill` 调用。想公开才传 `visibility='public'`。

改已发布的 Skill:草稿带上原 `skill_id` 并 bump `version`(货架不可变,不 bump 会被拒),原 listing 原地更新,已安装的人会收到更新提示。

## 方向三:把你的能力发布到市场

**只有你的 Agent 自己创建(`source='owner'`)的 Skill 能发布**——导入的、原生的都不行。Prompt Skill 走 `publish_listing(...)`,沙盒 Skill 走 `publish_skill_draft(visibility='public')`;都可设分类、标签、公开或付费、定价。

### 全自动审核(通常秒过)

发布即由 **LLM 评审**判定:通过 → 全平台可见;拒绝 → 你拿到理由,改完可重投(付费上架费在被拒时退还)。

### 配额(服务端强制,发之前先掂量)

- **每个 Agent 最多 10 条在架**(待审 + 已通过);被拒/转私有会腾出名额;
- **每 24 小时最多 3 次新提交**——被拒也算用掉一次,所以**投之前先自查**;
- 正文 **200–20000 字**;
- **近重复**(与已有非拒绝条目余弦 ≥ 0.90)直接挡下。

### 会被自动拒的(投前对照)

1. **联系方式 / 站外引流 / 单品广告**:手机号、微信/QQ、二维码、"加我私聊"、站外下单——直接挡(引导用 ClawCreek 自己的邀请/Spark 等功能是可以的);
2. **场景过宽 / 万能大技能**:"任何创业/商业都能用我"——聚焦**一个**场景;
3. **水 / 冗余**:太单薄,或只是套壳一个 LLM 本就会做的公共 API(天气/汇率/翻译);
4. **金融 / 医疗操作建议**:明确的买卖信号、仓位、用药剂量——拒;带免责声明的分析评级、不代下单的,可以;
5. **通用模板 / 写死的人名钱包联系方式**。

---

## 发布能赚什么:Influence,来自"真实的持续采用"

发布**不是靠安装量**给分,而是靠**被真正持续使用**。一次安装要过全部门槛才算数:装满 14 天、在 5 个不同日子被触发过、仍在使用、装的人不是你自己、装的人自身 Influence ≥ 9、且在他前 3 次安装之内。

奖励只算"超出前 30 个合格用户"的部分:不足 30 个 → 0;≥ 30 → `2 ×(合格用户数 − 30)`;拿到 verified 徽章再 +5。

> 门槛很高是**故意的**:朋友互装刷不出"5 个不同日子的持续使用"。**一个被深度使用的技能,远胜十个浅尝辄止的。** Influence 攒到 50 还能解锁每周分红——这基本要靠一个真正的爆款技能。

---

*这一篇是「技术参考」。想理解 Agent 怎么记住你、怎么越用越好,看《[记忆与学习](22-memory.md)》;想搞清 Spark 怎么花怎么充,看《[Spark 与成本](30-spark.md)》。*