docs: separate agent collaboration kit from skills

Co-authored-by: Cursor <cursoragent@cursor.com>

AGENTS.md

@@ -1,12 +1,12 @@
 # Agent Skills 仓库
 
-自研 Agent Skills 的单一事实来源（SSOT）。Skill 内容在本仓库维护；安装与管理由 [skiff](https://git.yumee.top/laily/skiff) CLI 负责。
+自研 Agent Skills 与配套规范资料的单一事实来源（SSOT）。Skill 内容、规范包与可运行的 skiff CLI 在本仓库一并维护。
 
 
-| 仓库              | 地址                                                                       | 职责              |
-| --------------- | ------------------------------------------------------------------------ | --------------- |
-| **skills**（本仓库） | [https://git.yumee.top/laily/skills](https://git.yumee.top/laily/skills) | skill 内容与规范     |
-| **skiff**       | [https://git.yumee.top/laily/skiff](https://git.yumee.top/laily/skiff)   | 安装、symlink、健康检查 |
+| 仓库              | 地址                                                                       | 职责                         |
+| --------------- | ------------------------------------------------------------------------ | -------------------------- |
+| **skills**（本仓库） | [https://git.yumee.top/laily/skills](https://git.yumee.top/laily/skills) | skill、规范包、skiff CLI 的当前 SSOT |
+| **skiff**       | [https://git.yumee.top/laily/skiff](https://git.yumee.top/laily/skiff)   | skiff CLI 的独立来源 / 上游同步参考    |
 
 
 ---
@@ -35,18 +35,22 @@ skiff status
 ```
 skills/
 ├── _template/                  # 新建 skill 的脚手架
-├── declarative-openspec-loop/  # 自研 skill
+├── declarative-openspec-loop/  # 自研 skill，必须含 SKILL.md
 │   ├── SKILL.md
 │   └── reference.md
 ├── discussion-notes/           # 讨论沉淀笔记
 │   ├── SKILL.md
 │   └── reference.md
+kits/
+└── agent-collaboration-kit/    # 可复制到项目的协作规范包，不是 skill
+skiff/                          # CLI 源码（Python 3）
+bin/skiff                       # CLI 入口
 registry.yaml                   # 外部 Git skill 来源目录
 AGENTS.md                       # 本文档
 ```
 
-**本仓库包含**：`skills/`、`registry.yaml`、`AGENTS.md`  
-**本仓库不包含**：CLI 代码、各项目的 skill 启用清单
+**本仓库包含**：`skills/`、`kits/`、`skiff/`、`bin/skiff`、`registry.yaml`、`AGENTS.md`  
+**本仓库不包含**：各项目的 skill 启用清单
 
 ---
 
@@ -63,6 +67,21 @@ AGENTS.md                       # 本文档
 
 新建 skill：复制 `skills/_template/` → `skills/<name>/`，编辑 `SKILL.md`，在本仓库 commit。
 
+### 规范包（Kits，不是 Skill）
+
+`kits/` 放可复制到项目的流程规范、模板、检查清单和示例资料。它们不是 Agent Skill：
+
+- 不放 `SKILL.md` frontmatter
+- 不由 `skiff install` / `skiff add` 安装
+- 不会被 Agent 自动触发加载
+- 使用方式是复制到目标项目文档目录，或在目标项目 `AGENTS.md` 中引用
+
+| Kit | 说明 | 推荐落地位置 |
+| --- | --- | --- |
+| [agent-collaboration-kit](kits/agent-collaboration-kit/README.md) | 多 Agent 协作闭环规范包 | `docs/agent-collaboration-kit/` |
+
+新建规范包：创建 `kits/<name>/README.md`，写清适用场景、复制到项目后的推荐目录、需要项目填充的占位符，并在本仓库 commit。
+
 ### 外部（External Git）
 
 在 `registry.yaml` 中注册，通过 skiff 拉取安装：
@@ -94,7 +113,8 @@ npx skills find typescript
 1. **SSOT** — 自研 skill 只存在于 `skills/<name>/`，不在 Agent 目录直接创建
 2. **项目自治** — 每个项目自己维护 `.skills.yaml`，本仓库不维护项目清单
 3. **软链优先** — 通过 symlink 映射到 Agent 目录，改 skill 即改 SSOT
-4. **仓库分离** — skill 内容与 CLI 工具分仓库，互不影响更新
+4. **类型分离** — `skills/` 只放可安装 skill；非 skill 的规范包、模板包放 `kits/`
+5. **一体维护** — skill、规范包与 CLI 同仓库维护；需要时再与独立 skiff 仓库同步
 
 ---
 
@@ -103,6 +123,8 @@ npx skills find typescript
 ```
 skills 仓库（本仓库）              skiff CLI
 skills/<name>/              ←──   skiff install / enable
+kits/<name>/                ←──   手动复制 / 项目文档引用
+skiff/                      ←──   python3 -m skiff
 registry.yaml               ←──   skiff add / fetch
          ↑
     ~/.skills（symlink）
@@ -123,6 +145,13 @@ registry.yaml               ←──   skiff add / fetch
 | **External Git** | `~/.local/share/skills/externals/` | `skiff fetch`                   |
 | **External NPM** | `node_modules/`                    | `npx skills add` / `skills-npm` |
 
+### 非 Skill 资料分类
+
+| 类型 | 位置 | 维护方式 |
+| --- | --- | --- |
+| **Kit** | `kits/<name>/` | 本仓库 commit；复制到目标项目 `docs/` 或由项目 `AGENTS.md` 引用 |
+| **OpenSpec 配置** | `openspec/` | 本仓库 commit；服务于本仓库自身的规格流程 |
+
 
 ### 多 Agent 路径