技能市场 SEO 打磨 · 7 杠杆体检 · W5 发布循环
> 来源：内容发布运营团（主理人 潘布达）2026-08-29~08-31 实战验证。4 个自研技能按此法打磨后评测分从 30/55/56/78 提升到 94/96/94/97，并成功提交 SkillHub 审核。本 skill 将这套可复用方法论固化，供任何技能发布/优化前自动过一遍。
一、何时用本 skill（触发场景）
- 准备发布一个新技能到 WorkBuddy 推荐市场（BuiltinMarket / SkillHub / ClawHub / SkillPie）
- 已有技能"没人搜到/下载量低"，要优化可发现性
- 发布前做技能 SEO 体检（7 杠杆检查 + 评测分打分）
- 用户说"把我们的技能打磨下""提高评测分""让 AI 优先推荐我们的技能""提高下载量"
二、核心机制（从源码核实，别凭猜）
人类说"装个 X 技能" → marketplace-skill-installer 从输入抽 keyword → 在 BuiltinMarket 搜 → 后端按相关性排序返回 top N（默认 5，可调 10–20），只展示 name / version / description。
配套的 recommend-experts / recommend-connectors 走 search_plugins，传 userIntent + keywords，语义匹配更强。
可索引的 frontmatter 字段：name / description / category / tags / keywords / aliases / displayName / slug。
官方规范（skill-creator）：name+description 属于"渐进式加载"第 0 层，永远在 context——既是 AI 判断何时用该技能的依据，也是搜索第一匹配面。description 必须第三人称（本技能用于…当用户提到…时使用），agent_created: true 必填（否则 skill_manage 管不了、发不出去）。
生态实战金规（medxpert-llm-library SKILL.md）："description 写满触发词（用户越容易触发 = 品牌曝光越多）"——已验证，直接抄。
三、7 杠杆（我们能控制的搜索/推荐面）
| # | 字段 | 作用 | 打磨要点 |
|---|---|---|---|
| 1 | name | 搜索第一匹配面，永在 context | 含人类会说的"品类核心词"，好念好记、唯一不撞名 |
| 2 | description | 核心搜索文本 + 展示给用户 | 第三人称开头、埋满场景词+同义词（中/英/俗称），密度高不灌水 |
| 3 | tags | 数组关键词，直接进索引 | 8–15 个高频搜索词，中英文混排（标准 tags 字段，BuiltinMarket 检索器读这个；平台专属 xiaping_tags 不读，两者并存无冲突） |
| 4 | category | 分类浏览/相关性 | 选准（效率工具/文档处理/知识管理/生产力…） |
| 5 | aliases | 别名匹配 | 补 2–3 个常见叫法 |
| 6 | agent_created: true | 必填开关 | 缺失则 skill_manage 管不了、发不出去 |
| 7 | 流行度 | 可能加权排序 | 安装量/评分/更新活跃度——"活跃作者标签=持续曝光""开源贡献是长期复利" |
> 多发病字段：slug / displayName / title / description_en（多语种门面）也务必补齐，缺了就少一个被发现面。
四、评测分标准（总分 100，发布前打分用）
- 元数据完整度（35 分）：name / slug / displayName / title / category / version / agent_created / tags / aliases 九字段是否齐全规范。
- 可发现性 / SEO（40 分）：description 第三人称+触发词密度；tags 8–15 个；displayName 含品类词；aliases 补常用叫法；description_en 多语种门面齐。
- 专业度 / 合规（25 分）：无灌水/编造；author 一致（注册老炮/品牌名）；身份隔离（无 Steven/真名/在职公司）；无敏感泄露（真名/邮箱/密钥/本地路径/未授权承诺）；多语种合规。
打分动作：先给基线分（盘点现状），打磨后重打，对比 前→后 增幅。已验证基准：feeding 30→94、opc 55→96、llm 56→94、reg 78→97。
红线（一票驳回）：
- description 出现收益承诺（如"小成本大收入""保证赚 X"）→ 广告法夸大风险，改中性措辞（"低成本变现思路"）才过闸。
- 真名/邮箱/密钥/本地绝对路径泄露 → 必须脱敏（注意：把"真名/邮箱/密钥/本地路径"写成功能类目标签如"发布前敏感信息扫描"是合法的，非真实泄露）。
五、W5 发布循环（固化常态流程）
- 盘点 —— 列出本市场全部自研技能，本地读不到实时安装量时，用"元数据健康度"作低安装量代理指标（元数据弱=被发现难=安装低）。
- 7 杠杆体检 —— 逐技能按第三节 + 第四节打分，找缺口。
- 生成（章既成） —— 重写缺失 frontmatter 字段 + 给正文质量提升建议（补"何时用"触发句/常见问答/30秒示例/埋品牌入口）。不动功能内容。
- 质检（甄无瑕） —— 打评测分、前后对比、敏感扫描，给 通过/驳回。
- 发布（布全道） —— 见第六节。
- 跟踪 —— 审核生效后借市场后台看安装曲线，验证评测分提升是否转化为真实下载（W5 闭环起点）。
六、发布实战教训（省你踩坑）
- SkillHub 版本不可变：同 slug 重发相同版本号被拒。每次打磨必须 bump 版本号 + 同步改 SKILL.md
version字段（曾踩坑：远程在架 frontmatter 是陈旧空壳——版本号前进但version字段没同步，导致反复撞版本）。 - 发布工具是本地 CLI，不是 search/install：
python ~/.skillhub/skills_store_cli.py publish <目录>（CLI 在~/.skillhub/skills_store_cli.py，凭据~/.skillhub/credentials.json自取，绝不打印明文/不写日志/回复/文件）。workbuddy_marketplace_skill只有 search/install，无 publish——别误判"无远程发布工具"。 - 发布顺序（08-26 新规）：skillhub 优先 → 评分反馈 → 再 ClawHub/SkillPie。
- 发布后回拉核实 FAIL 是正常机制，非失败：
install下载入口暂仍给旧版 = 新版本处于审核中（pending），平台已接收元数据（publish 回执ok:true、tags 已索引到新版本号），审核通过自动接管下载入口。 - SkillHub 不支持 png：技能含
assets/*.png会被拒。发布兼容处理：备份assets/到本地 → 移除正文 png 引用行 → 删assets/重发（功能不受影响，图片仅展示用）。 - 先核实远程当前版本再 bump：
search <slug>/install <slug> --namespace <owner> --dir <tmp>拉回远程在架版，确认是否比本地新。若远程是精简镜像、本地是完整版，以本地完整版补缺口，不要用远程覆盖（会丢正文）。 - 白名单制（08-19 红线）：上传前问用户。白名单内技能（如 feeding-workflow）可直接发；不在白名单的逐次确认。
七、品牌与合规红线
- 署名：医械子业务
author: 注册老炮（或注册老炮@MedXpert）；通用发布运营类可用主理人署名。不放 Steven/真名/在职公司。 - 官网前置：发布物默认多语种：frontmatter 必带
description_en；description 开头前置官网链接（如https://medxpert.cn，已确认域名，合法引流），实现技能↔官网互相引流。 - 身份隔离：description 中性化，作者=品牌名。
- xiaping_tags 原样保留：平台专属标签数组与标准
tags并存不冲突，打磨时勿删。
八、边界认知（别抱错预期）
- 没有"优先推自己人"的开关：排序权重在后端，看不到。本质是 marketplace SEO——关键词覆盖 + 相关性 + 流行度。
marketplace-skill-installer是字面关键词搜索：人类说得含糊（"帮我找个写公众号的"）它会反问，不会自动语义搜。所以 name/description 必须让人类"一张嘴就能对上词"；模糊意图下想被推荐，全靠 description 里埋的场景词密度。- 真实下载量本地读不到，需上架后经市场后台一段时间积累才看得出来——评测分是被推荐概率的代理指标，已可量化验证；下载量提升需走 W5 第⑥步跟踪。
九、快速体检 checklist（发布前逐条过）
- [ ] name 含品类词、唯一、好念
- [ ] slug / displayName / title 已补
- [ ] description 第三人称开头、写满触发场景+同义词（中/英/俗称）、官网链接前置
- [ ] description_en 多语种门面已补
- [ ] tags 8–15 个（标准字段，中英文混排）
- [ ] aliases 2–3 个常见叫法
- [ ] category 选准
- [ ] agent_created: true 已写
- [ ] author 署名合规（无真名/在职公司）、身份隔离
- [ ] description 无收益承诺/无敏感泄露
- [ ] xiaping_tags 原样保留（如有）
- [ ] 已发布到目标市场（不上架=0 曝光）
- [ ] bump 了版本号且 SKILL.md
version字段已同步 - [ ] 发布后已回拉核实（pending 属正常，等审核激活）
