docs: separate agent collaboration kit from skills

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-07-06 09:32:50 +08:00
parent c4c68572c3
commit 58de2650c2
10 changed files with 52 additions and 11 deletions
+14 -2
View File
@@ -18,7 +18,8 @@ skiff status
## 仓库结构
```
skills/ # 自研 skillSSOT
skills/ # 自研 skillSSOT:每个子目录必须有 SKILL.md
kits/ # 可复制到项目的规范包 / 模板包,不是 Agent Skill
skiff/ # CLI 源码(Python 3
bin/skiff # CLI 入口
registry.yaml # 外部 Git skill 目录
@@ -28,6 +29,7 @@ AGENTS.md # 详细规范与架构说明
| 路径 | 说明 |
|------|------|
| [skills/](skills/) | 自研 skill,每个子目录含 `SKILL.md` |
| [kits/](kits/) | 项目规范包、协作模板、可复制资料,不由 skiff 安装 |
| [skiff/](skiff/README.md) | 安装、软链、健康检查 CLI |
| [registry.yaml](registry.yaml) | 外部 Git skill 注册表 |
| [AGENTS.md](AGENTS.md) | 设计原则、编写规范、架构详解 |
@@ -39,6 +41,14 @@ AGENTS.md # 详细规范与架构说明
| [declarative-openspec-loop](skills/declarative-openspec-loop/SKILL.md) | 声明式编程循环:用户提供校验方式,Agent 自动迭代直到通过 |
| [discussion-notes](skills/discussion-notes/SKILL.md) | 讨论沉淀:边讨论边维护 Markdown 笔记 |
## 规范包(不是 Skill
`kits/` 用来维护可复制到项目里的规范说明、模板和检查清单。它们没有 `SKILL.md`,不会被 `skiff install``skiff add` 或 Agent 自动加载。
| Kit | 说明 |
|-----|------|
| [agent-collaboration-kit](kits/agent-collaboration-kit/README.md) | 多 Agent 协作闭环规范包,复制到项目 `docs/agent-collaboration-kit/` 后按项目情况填写 |
新建 skill
```bash
@@ -100,6 +110,7 @@ npx skills find typescript
```
本仓库
├── skills/<name>/ ←── skiff install / enable
├── kits/<name>/ ←── 手动复制 / 项目文档引用
├── registry.yaml ←── skiff add / fetch
└── skiff/ ←── python3 -m skiff
@@ -117,7 +128,8 @@ npx skills find typescript
1. **SSOT** — 自研 skill 只存在于 `skills/<name>/`
2. **项目自治** — 各项目自行维护 `.skills.yaml`
3. **软链优先** — 通过 symlink 映射到 Agent 目录,改 skill 即改 SSOT
4. **一体维护** — skill 与 CLI 同仓库,Python 3 直接运行,无需编译
4. **规范包分离** skill 的流程规范、模板包放在 `kits/<name>/`,不混入 `skills/`
5. **一体维护** — skill 与 CLI 同仓库,Python 3 直接运行,无需编译
## 文档