refactor: unify skill source model

AGENTS.md

@@ -43,24 +43,24 @@ skills/
 │   └── reference.md
 skiff/                          # CLI 源码（Python 3）
 bin/skiff                       # CLI 入口
-registry.yaml                   # 外部 Git skill 来源目录
+catalog.yaml                   # skiff 预置 Skill 来源目录
 AGENTS.md                       # 本文档
 ```
 
-**本仓库包含**：`skills/`、`skiff/`、`bin/skiff`、`registry.yaml`、`AGENTS.md`
+**本仓库包含**：`skills/`、`skiff/`、`bin/skiff`、`catalog.yaml`、`AGENTS.md`
 **本仓库不包含**：各项目的 skill 启用清单
 
 ---
 
 ## Skill 目录
 
-### 自研（Owned）
+### 内置（Builtin）
 
 
 | 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 自动 propose/apply/校验并迭代直到通过 |
 | [discussion-notes](skills/discussion-notes/SKILL.md)                   | 讨论沉淀：边讨论边维护 Markdown 笔记，无 .raw.md                 |
 
@@ -75,19 +75,19 @@ Skill 需要的稳定规范、模板、示例和脚本直接放在自己的目
 skiff init ack
 ```
 
-### 外部（External Git）
+### 预置目录（Catalog）
 
-在 `registry.yaml` 中注册，通过 skiff 拉取安装：
+在 `catalog.yaml` 中预置，通过 skiff 拉取安装：
 
 
-| Skill       | 来源                                                                         |
-| ----------- | -------------------------------------------------------------------------- |
-| superpowers | [https://github.com/obra/superpowers](https://github.com/obra/superpowers) |
+| Source | 来源 |
+| --- | --- |
+| waza | [https://github.com/tw93/Waza](https://github.com/tw93/Waza) |
 
 
 ```bash
-skiff fetch superpowers
-skiff install-external superpowers
+skiff fetch waza
+skiff add waza/think -g
 ```
 
 ### 自定义仓库（Custom Sources）
@@ -139,7 +139,7 @@ npx skills find typescript
 skills 仓库（本仓库）              skiff CLI
 skills/<name>/              ←──   skiff install / enable
 skiff/                      ←──   python3 -m skiff
-registry.yaml               ←──   skiff add / fetch
+catalog.yaml               ←──   skiff add / fetch
          ↑
     ~/.skills（symlink）
          │
@@ -155,8 +155,8 @@ registry.yaml               ←──   skiff add / fetch
 
 | 层级               | 位置                                 | 维护方式                            |
 | ---------------- | ---------------------------------- | ------------------------------- |
-| **Owned**        | `skills/<name>/`                   | 本仓库 commit                      |
-| **External Git** | `~/.local/share/skills/externals/` | `skiff fetch`                   |
+| **Builtin**        | `skills/<name>/`                   | 本仓库 commit                      |
+| **Catalog** | `catalog.yaml` + checkout 缓存 | `skiff catalog add / fetch` |
 | **Custom Source** | `~/.local/share/skiff/sources/` 或本地路径 | `skiff source add/fetch` |
 | **External NPM** | `node_modules/`                    | `npx skills add` / `skills-npm` |
 
@@ -186,10 +186,10 @@ registry.yaml               ←──   skiff add / fetch
 ```yaml
 # .skills.yaml（在项目根目录）
 skills:
-  - declarative-openspec-loop
-  - name: superpowers
-    source: registry
-    ref: main
+  - name: declarative-openspec-loop
+    source: builtin
+  - name: think
+    source: catalog:waza
   - name: internal-review
     source: company
 
@@ -231,9 +231,9 @@ skiff sync
 | `skiff bootstrap`                      | 将 skiff 项目 skill 全局安装到所有 Agent |
 | `skiff list`                           | 列出所有 skill          |
 | `skiff status`                         | 安装状态总览              |
-| `skiff install <name>`                 | 全局安装（symlink）       |
-| `skiff uninstall <name>`               | 移除 symlink          |
-| `skiff add / fetch / install-external` | 外部 Git skill        |
+| `skiff add <name> [-g]`                | 项目或全局安装（symlink） |
+| `skiff remove <name> [-g]`             | 移除 symlink |
+| `skiff catalog add` / `skiff fetch`    | 管理和拉取 catalog source |
 
 
 ### 草稿与健康检查