refactor: unify skill source model

README.md

@@ -9,7 +9,7 @@ git clone https://git.yumee.top/laily/skills.git ~/.skills
 cd ~/.skills
 ./install.sh  # 安装 CLI，并将 skiff 项目 skill 安装到所有 Agent
 
-skiff install declarative-openspec-loop
+skiff add declarative-openspec-loop -g
 skiff select  # 交互式选择并批量安装
 skiff list
 skiff status
@@ -21,7 +21,7 @@ skiff status
 skills/           # 自研 skill（SSOT）：每个子目录必须有 SKILL.md
 skiff/            # CLI 源码（Python 3）
 bin/skiff         # CLI 入口
-registry.yaml     # 外部 Git skill 目录
+catalog.yaml      # skiff 预置 Skill 来源目录
 AGENTS.md         # 详细规范与架构说明
 ```
 
@@ -29,7 +29,7 @@ AGENTS.md         # 详细规范与架构说明
 |------|------|
 | [skills/](skills/) | 自研 skill，每个子目录含 `SKILL.md`，可附带 references、templates 和 scripts |
 | [skiff/](skiff/README.md) | 安装、软链、健康检查 CLI |
-| [registry.yaml](registry.yaml) | 外部 Git skill 注册表 |
+| [catalog.yaml](catalog.yaml) | skiff 预置 Skill 来源目录 |
 | [AGENTS.md](AGENTS.md) | 设计原则、编写规范、架构详解 |
 
 ## 自研 Skill
@@ -37,7 +37,7 @@ AGENTS.md         # 详细规范与架构说明
 | Skill | 说明 |
 |-------|------|
 | [ack](skills/ack/SKILL.md) | 显式初始化、检查并运行 ACK 三角色协作闭环 |
-| [skiff](skills/skiff/SKILL.md) | 在项目中创建、安装、反馈和维护 owned skill |
+| [skiff](skills/skiff/SKILL.md) | 在项目中创建、安装、反馈和维护 builtin skill |
 | [declarative-openspec-loop](skills/declarative-openspec-loop/SKILL.md) | 声明式编程循环：用户提供校验方式，Agent 自动迭代直到通过 |
 | [discussion-notes](skills/discussion-notes/SKILL.md) | 讨论沉淀：边讨论边维护 Markdown 笔记 |
 
@@ -65,8 +65,8 @@ skiff add my-skill -g   # 全局安装验证
 ### 全局（用户级）
 
 ```bash
-skiff install <name>                  # 安装到 ~/.cursor/skills/ 等
-skiff install <name> --target cursor
+skiff add <name> -g                   # 安装到 ~/.cursor/skills/ 等
+skiff add <name> -g -a cursor
 ```
 
 ### 项目级
@@ -75,10 +75,10 @@ skiff install <name> --target cursor
 
 ```yaml
 skills:
-  - declarative-openspec-loop
-  - name: superpowers
-    source: registry
-    ref: main
+  - name: declarative-openspec-loop
+    source: builtin
+  - name: think
+    source: catalog:waza
 
 targets:          # 可选，默认 all
   - cursor
@@ -87,18 +87,25 @@ targets:          # 可选，默认 all
 ```
 
 ```bash
-skiff enable declarative-openspec-loop
+skiff add declarative-openspec-loop
 skiff sync
-skiff disable declarative-openspec-loop
+skiff remove declarative-openspec-loop
 ```
 
-## 外部 Skill
+## Catalog 与 Custom Source
 
-**Git 来源**（经 skiff 管理）：
+安装 catalog 中预置的来源：
 
 ```bash
-skiff fetch superpowers
-skiff install-external superpowers
+skiff fetch waza
+skiff add waza/think -g
+```
+
+接入团队自己的本地目录或 Git 仓库：
+
+```bash
+skiff source add company --local ~/code/company-skills --skills-path skills
+skiff add company/internal-review -g
 ```
 
 **社区来源**（Vercel CLI）：
@@ -113,7 +120,7 @@ npx skills find typescript
 ```
 本仓库
 ├── skills/<name>/     ←── skiff install / enable
-├── registry.yaml      ←── skiff add / fetch
+├── catalog.yaml       ←── 预置来源发现与 fetch
 └── skiff/             ←── python3 -m skiff
          ↑
     ~/.skills（symlink）