---
id: PRD-002
title: 分发渠道策略 —— 主推 ClawHub，skills.sh 零维护
status: draft
owner: @yarnb
created_at: 2026-04-23
linked_issue: "#030"
linked_objective: O4-production-ready
linked_milestone: M7
linked_features: []
---

# PRD-002 — 分发渠道策略

## 1. 问题 (Why)

当前 xiangqin 同时被分发到 **ClawHub**（slug `acong-tech-xiangqin`，displayName 原为中文 "相亲"，2026-04-23 改拼音 `xiangqin` 对齐 slug）和 **skills.sh**（仓名 `acong-tech-skills/xiangqin` 英文）。两个渠道**命名不对称 + 运营负担叠加**，若不定策略会：

- 双文案维护成本倍增（README 中英双语 / metadata 两套 / tag 翻译）
- 精力分散，两边都不出头
- 品牌割裂（用户在两个地方看到不同名字）

## 2. 目标用户 & 场景

- **主攻简中互联网用户**（相亲 app 核心市场）
- 次要保留英文用户（被动收录即可，不主动投入）

## 3. 成功指标

| 指标 | 目标 |
|---|---|
| ClawHub 月装机量 | ≥ X（T+30 后 baseline） |
| ClawHub 搜索"相亲" / "找对象" 排名 | Top 5 |
| 双渠道**维护时间成本** | ≤ 0.5 h/week（skills.sh 零维护） |
| skills.sh 装机量 | 不跟指标（仅保留英文 SEO） |

## 4. 方案范围 (What)

### In scope

1. **ClawHub 主推**：版本发布、SKILL.md 文案优化、tag 优化、描述 SEO
2. **slug 英文 / displayName 拼音 `xiangqin`** 固化（两渠道共用，统一品牌代号）
3. **skills.sh 仓保留不维护**：仓 `acong-tech-skills/xiangqin` 保持，不主动 push 改动
4. **description 策略**：简中为主 + 首段英文一行摘要

### Out of scope

- **skills.sh 英文 README / 文档**（不做双语）
- **ClawHub 第三方镜像站同步**（openclaw.cc / clawcn.net 让他们自己扫）
- **付费推广位**（平台未提供，也不是当前阶段的事）
- **应用商店上架**（另一个渠道，单独 PRD）

## 5. 用户流程

用户发现 xiangqin 的典型路径（简中为例）：

```
Claude Code 用户想"找个相亲的" 
    ↓
问 agent 或搜索 ClawHub "相亲"
    ↓
向量搜索命中 "相亲" displayName
    ↓
看到中文描述 + 中文标签（"相亲/脱单/受众查询"）
    ↓
clawhub install acong-tech-xiangqin
    ↓
agent 读 SKILL.md（中文）→ 引导用户装 xq CLI
```

英文用户走 skills.sh 搜 `xiangqin` → 看到英文仓 → 仍能用，但数量稀少不构成主要用户池。

## 6. 方案选型

见 [wiki/concepts/distribution-channels.md](../wiki/concepts/distribution-channels.md) + [raw 调研](../raw/distribution-channels-research-2026-04-23.md)。

核心决策：
- 不做双渠道对等维护（成本高收益低）
- 中文优先（ClawHub displayName / description）
- skills.sh "deprecated-first-class"（保留不投入）

## 7. 拆解到 FEAT（本 PRD 大多是运营 / 文档而非代码）

- [ ] FEAT-040: SKILL.md 描述 SEO 优化（高频关键词 "相亲 / 找对象 / 脱单 / 受众查询 / 心仪 / 匹配"）**defer**：当前 description trigger 已覆盖 13 条常用触发语 + 英文 tagline（FEAT-047），再加关键词边际收益低；等有 ClawHub 搜索真实数据（2 周后看 trending 位次）再判断要不要扩
- ~~FEAT-041: tag 体系优化（ClawHub tag 关键词覆盖）~~ **非 lever，关闭**：2026-04-23 深调研发现 `clawhub publish --tags` 接受的是**版本指针 tags**（像 npm dist-tags `latest` / `beta`），**不是 SEO 关键词 tags**。ClawHub 搜索排序的真实 lever 是 slug / displayName exact token + description / SKILL.md 正文 embedding，tag 不参与召回
- **FEAT-042: publish.md SOP 加发布前安全扫描 review 清单**（2026-04-23，brain/sop/services/publish.md 更新：6 条 lint rule / 手动 grep 列表 / 踩坑历史表）
- **FEAT-043: 主仓 README ClawHub primary**（2026-04-23，README.md `## 装` 段重排：ClawHub 简中首选 / skills.sh 英文国际 / PyPI only-CLI 三档）
- **FEAT-045: ClawHub displayName 中文 → 拼音 `xiangqin`**（2026-04-23，v0.6.2 release.yml 一行 `--name` 改动；品牌代号对齐 slug / GitHub 仓 / skills.sh 仓）
- **FEAT-046: skills.sh 冷启动**（2026-04-23，手动 `npx skills add acong-tech-skills/xiangqin --all -g` 触发 install telemetry；24-48h 后验证 https://skills.sh/acong-tech-skills/xiangqin 从 404 变 200）
- **FEAT-047: SKILL.md 加英文 tagline**（2026-04-23，v0.6.3 description 末尾加 `xiangqin — a Chinese matchmaking / dating skill for Claude agents.`，辅助 skills.sh 英文关键词命中）
- **FEAT-048: SKILL-REPO-README `#vX.Y.Z` fragment pin 提示**（2026-04-23，v0.6.3 教 skills.sh 用户版本锁定用法）
- **FEAT-045: ClawHub displayName 中文 → 拼音 `xiangqin`**（2026-04-23，v0.6.2 release.yml 一行 `--name` 改动；品牌代号对齐 slug / GitHub 仓 / skills.sh 仓）
- [ ] FEAT-046: skills.sh 冷启动 —— 手动 `npx skills add acong-tech-skills/xiangqin` 一次触发 install-time 入库（当前 skills.sh 目录页 404；深调研发现 push 仓 ≠ 入库，需 install-time telemetry 触发）
- [ ] FEAT-047: SKILL.md 加英文 tagline（description 第二句附英文摘要，辅助 skills.sh 关键词命中）
- [ ] FEAT-048: `SKILL-REPO-README.md` 加 `#v0.x.y` fragment pin 提示（skills.sh 用户默认拿 main HEAD，版本锁定要显式 fragment）
- （可选）FEAT-044: ClawHub 中国镜像站主动 ping（如果未来镜像开放 submit）

## 8. 风险 & 回滚

| 风险 | 概率 | 影响 | 缓解 |
|---|---|---|---|
| ClawHub 下线 / 停止支持中文 | 低 | 高 | skills.sh 仓保留做 fallback；真出事就切 |
| ClawHub 政策变化拒绝相亲类 skill | 低 | 高 | 接入 OpenClaw 中国镜像 clawcn.net 等作为 plan B |
| 中文 "相亲" 向量召回不准 | 中 | 中 | 通过 description / tag 加同义词覆盖 |
| 只推一个渠道，用户获取上限低 | 高 | 中 | 接受；相亲业务本就是窄市场，不靠 skill hub 走量 |

## 9. 里程碑

| T+X | 交付 |
|---|---|
| T+0 | PRD 通过 + 更新 release-flow SOP + README 优先级调整 |
| T+3 | SKILL.md SEO / tag 优化上线 |
| T+7 | ClawHub 搜索"相亲"排名基线测量 |
| T+30 | 指标评估（装机量 / 搜索排名） |

## 10. 讨论 / 反馈

### 2026-04-23 @claude — 初稿

基于 agent 深度调研 + Karpathy 三层架构（事实归 raw/ → 解读归 concepts/ → 执行归 prd/），PRD-002 是"执行"层。

**待老板拍的点**：
1. skills.sh 仓真的**完全零维护**还是"有明显问题时偶尔修"？release.yml 当前每个 tag 都 sync SKILL.md 到 skills.sh 仓（issue #007 transfer 之后的流程），这个要保留吗？
   - **推荐保留**（自动的不是成本，不需要 revert）
   - **但不主动优化 skills.sh 侧文案**
2. 首段英文摘要的格式 / 长度？
   - **推荐一句话**："xiangqin — matchmaking / dating skill (Simplified Chinese market)."
3. ClawHub tag 优化具体加哪些？
   - **推荐**：`相亲` / `脱单` / `找对象` / `社交` / `匹配` / `受众查询` / `dating` / `matchmaking`
4. 是否现在就动 README 结构调整 vs 放到下一个 minor release（0.6.0）？
   - **推荐**：现在动（低风险文档改动，不捆绑代码 release）

### 2026-04-23 @claude — displayName 拼音化决策

**背景**：老板语音 brief "中文叫相亲，希望改成英文字母的相亲就是拼音 xiangqin"。

**结论**：
- displayName `相亲` → `xiangqin`，和 slug / GitHub 仓 / skills.sh 仓名品牌对齐
- 中文用户召回**不受影响**：ClawHub 向量搜索 `相亲` query 命中 description / SKILL.md 正文 的中文关键字；slug `xiangqin` 本就是拼音 token
- 未来 i18n 分化走 docs + CLI 层（各国自己的实名验证方式），不走 displayName 语言分支
- **实现**：release.yml 里 `--name "相亲"` → `--name "xiangqin"` 一行改，bump 0.6.2 重发触发 ClawHub 元数据更新

**为什么不走 API 单独 update 元数据**：已实测 `PATCH /api/v1/skills/<slug>` / `PUT /api/v1/skills/<slug>` 都 404，ClawHub REST API 不暴露元数据 update endpoint。唯一更新路径是 `clawhub publish` 重发（等于 patch bump）。

### 2026-04-23 @claude — 深调研结论补入

- skills.sh 是 Vercel 2026-01-20 发布的真实独立产品（源 `github.com/vercel-labs/skills`），机制已深调完 [raw/skills-sh-deep-dive-2026-04-23.md](../raw/skills-sh-deep-dive-2026-04-23.md)
- skills.sh 入库需要 **install-time telemetry 触发**（push 到仓不够），当前 xiangqin 未入库 → 新增 FEAT-046
- skills.sh 无 CJK 分词文档 → 新增 FEAT-047 英文 tagline
- skills.sh 默认拿 main HEAD（不认 git tag）→ 新增 FEAT-048 fragment 提示
