---
id: 024
title: skill 仓的 README 由主仓源文件控制（CI 双文件同步）
status: in_progress
labels: [infra, ci, docs]
assignee: team-lead
created_at: 2026-04-23
---

# #024 skill 仓 README 源文件回主仓

## 背景

2026-04-23 老板补充：
> "那个仓库的 README. 我希望在我们这边也是有原文档，也是在我们这边，在我们仓库底下，每次 CI 的时候应该要把这个 README 也去更新一下。"

当前 `release.yml` 的 `publish-clawhub` / `sync-skills-sh` job 里 README 是 **heredoc 硬编码**（yaml 里 inline 一大段 markdown）。问题：
- 改 README 要改 yaml（别扭）
- 主仓 git 历史看不到 README 变化
- 跨 skill 仓（以后可能多 skill）要重复 inline

## 方案

主仓根目录新建 `SKILL-REPO-README.md`（和 `SKILL.md` 同级 peer）：
- 这是**给 skill 分发仓当 README 用的**特殊文件
- 命名和 SKILL.md 协议性相呼应
- 主仓 git 历史完整可追溯

`release.yml` 改：
- `sync-skills-sh` job: `cp SKILL.md SKILL-REPO-README.md /tmp/skill/`（skill 仓的 README.md 实际来自主仓的 `SKILL-REPO-README.md`）
  - 需要改名: `mv /tmp/skill/SKILL-REPO-README.md /tmp/skill/README.md`
- `publish-clawhub` job: 同上，`/tmp/skill-publish/` 里放 `SKILL.md` + `README.md`（由 `SKILL-REPO-README.md` 重命名）

## 工作量

30 分钟。今晚做。

## 相关

配合 #007 org 迁移做好后，未来每个 skill 仓都遵守这个模式（主仓管 SKILL.md + SKILL-REPO-README.md，CI 双文件同步）。
