refactor: unify skill source model

skiff/README.md

@@ -14,7 +14,7 @@ cd /path/to/skills   # 本仓库根目录
 ## 命令风格
 
 接口对齐 [Vercel skills CLI](https://github.com/vercel-labs/skills) 的 `add` / `remove`，
-统一管理 **~/.skills 自研 skill**、命名 custom source 和 registry 外部 skill。
+统一管理 builtin skill、预置 catalog source 和用户命名的 custom source。
 
 ```bash
 # 浏览可用自研 skill
@@ -68,14 +68,14 @@ skiff bootstrap
 | `skiff update` | 在 `~/.skills` 执行 `git pull`，更新 skiff 自身 |
 | `skiff init <name> [--project DIR]` | 使用 builtin skill 自带模板初始化项目状态 |
 
-### 全局安装（自研 skill）
+### Skill 安装
 
 | 命令 | 说明 |
 |------|------|
 | `skiff add <name> [--global] [-a AGENT...] [-y]` | 安装到 Agent 目录（软链） |
 | `skiff select [--global] [-a AGENT...]` | 打开终端多选界面，批量安装 skill |
 | `skiff remove <name> [--global] [-a AGENT...] [-y]` | 移除软链（`rm` / `r` 别名） |
-| `skiff add --list` | 列出可用自研 skill |
+| `skiff add --list` | 列出可用 builtin skill |
 | `skiff publish [paths] -m MSG [--push]` | 在 ~/.skills 内 git add/commit/push |
 
 旧命令 `install` / `uninstall` 已移除，请改用 `add` / `remove`。
@@ -88,16 +88,16 @@ skiff bootstrap
 | claude | `~/.claude/skills/` |
 | codex | `~/.codex/skills/` |
 
-### 外部 Git skill
+### 预置 Catalog Source
 
 | 命令 | 说明 |
 |------|------|
-| `skiff registry add <name> <repo-url> [--ref main] [--path .]` | 写入 `registry.yaml` |
-| `skiff fetch <name>` | 克隆或更新外部仓库缓存 |
-| `skiff add <name> [-g] [-a AGENT...]` | 安装 registry 中的单个 skill 或完整 collection（缺失时自动 fetch） |
+| `skiff catalog add <name> <repo-url> [--ref main] [--path .]` | 写入 `catalog.yaml` |
+| `skiff fetch <name>` | 克隆或更新 catalog source checkout |
+| `skiff add <name> [-g] [-a AGENT...]` | 安装 catalog 中的单个 skill 或完整 collection（缺失时自动 fetch） |
 | `skiff add <collection>/<skill> [...]` | 只安装 collection 中指定的 skill |
 
-`registry.yaml` 条目可额外提供 `description` 和 `tags`。`description`
+`catalog.yaml` 条目可额外提供 `description` 和 `tags`。`description`
 会显示在 `skiff select` 的候选列表中。`path` 可以直接指向含
 `SKILL.md` 的单个 skill，也可以指向由多个 skill 目录组成的 collection。
 collection 会自动发现下一层所有含 `SKILL.md` 的目录；`skiff add <name>`
@@ -202,12 +202,12 @@ cd ~/code/my-app
 skiff add declarative-openspec-loop -a cursor -y
 ```
 
-### 安装外部 Git skill
+### 添加 Catalog Source
 
 ```bash
-skiff add my-ext https://github.com/org/repo --ref main
+skiff catalog add my-ext https://github.com/org/repo --ref main
 skiff fetch my-ext
-skiff install-external my-ext
+skiff add my-ext -g
 ```
 
 ## 源码结构
@@ -218,8 +218,8 @@ skiff/
 ├── __main__.py      # python3 -m skiff 入口
 ├── cli.py           # 命令定义与调度
 ├── paths.py         # 路径常量与 Agent 目标
-├── skills.py        # 自研 skill 发现
-├── registry.py      # registry.yaml 读写
+├── skills.py        # builtin/catalog/custom 统一解析
+├── catalog.py       # catalog.yaml 读写与 Skill 发现
 ├── sources.py       # custom source 配置、发现与 Git 管理
 ├── project.py       # .skills.yaml 管理
 ├── symlinks.py      # 软链创建/检查/修复
@@ -233,9 +233,9 @@ skiff/
 | 变量 | 路径 | 说明 |
 |------|------|------|
 | `SKILLS_HOME` | `~/.skills` | skills 仓库（软链） |
-| `SKILLS_DIR` | `~/.skills/skills/` | 自研 skill 目录 |
-| `REGISTRY_FILE` | `~/.skills/registry.yaml` | 外部 skill 注册表 |
-| `EXTERNALS_DIR` | `~/.local/share/skills/externals/` | 已 fetch 的外部仓库；新条目按 repo/ref 共享缓存 |
+| `SKILLS_DIR` | `~/.skills/skills/` | builtin skill 目录 |
+| `CATALOG_FILE` | `~/.skills/catalog.yaml` | 预置 Skill 来源目录 |
+| `CATALOG_CACHE_DIR` | `~/.local/share/skills/externals/` | catalog checkout 兼容缓存；按 repo/ref 共享 |
 | `CONFIG_FILE` | `~/.config/skiff/config.yaml` | custom source 配置 |
 | `SOURCES_DIR` | `~/.local/share/skiff/sources/` | custom Git source 默认 checkout |