refactor: fold ack kit into skill

This commit is contained in:
2026-07-30 11:54:02 +08:00
parent e308d6a04c
commit 076d87e303
32 changed files with 592 additions and 619 deletions
+10 -20
View File
@@ -34,21 +34,20 @@ skiff status
```
skills/
├── _template/ # 新建 skill 的脚手架
├── ack/ # 完整 ACK skill,含 references/templates/scripts
├── 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/``kits/``skiff/``bin/skiff``registry.yaml``AGENTS.md`
**本仓库包含**`skills/``skiff/``bin/skiff``registry.yaml``AGENTS.md`
**本仓库不包含**:各项目的 skill 启用清单
---
@@ -68,20 +67,13 @@ AGENTS.md # 本文档
新建 skill:复制 `skills/_template/``skills/<name>/`,编辑 `SKILL.md`,在本仓库 commit。
### 规范包(Kits,不是 Skill
Skill 需要的稳定规范、模板、示例和脚本直接放在自己的目录中,例如
`skills/ack/references/``templates/``examples/``scripts/`。项目初始化只生成
项目状态,不复制或链接 Skill 内容:
`kits/` 放可复制到项目的流程规范、模板、检查清单和示例资料。它们不是 Agent Skill
- 不放 `SKILL.md` frontmatter
- 不由 `skiff install` / `skiff add` 安装
- 不会被 Agent 自动触发加载
- 使用方式是复制到目标项目文档目录,或在目标项目 `AGENTS.md` 中引用
| Kit | 说明 | 推荐落地位置 |
| --- | --- | --- |
| [ack](kits/ack/README.md) | 多 Agent 协作闭环规范包 | `docs/ack/` |
新建规范包:创建 `kits/<name>/README.md`,写清适用场景、复制到项目后的推荐目录、需要项目填充的占位符,并在本仓库 commit。已有 kit 可通过 `skiff kit init <name>` 初始化到项目。
```bash
skiff init ack
```
### 外部(External Git
@@ -136,8 +128,8 @@ npx skills find typescript
1. **SSOT** — 自研 skill 只存在于 `skills/<name>/`,不在 Agent 目录直接创建
2. **项目自治** — 每个项目自己维护 `.skills.yaml`,本仓库不维护项目清单
3. **软链优先** — 通过 symlink 映射到 Agent 目录,改 skill 即改 SSOT
4. **类型分离**`skills/` 只放可安装 skill;非 skill 的规范、模板包放 `kits/`
5. **一体维护** — skill、规范包与 CLI 同仓库维护;需要时再与独立 skiff 仓库同步
4. **能力内聚**Skill 使用的规范、模板和脚本与 `SKILL.md` 同目录维护
5. **一体维护** — skill 与 CLI 同仓库维护;需要时再与独立 skiff 仓库同步
---
@@ -146,7 +138,6 @@ npx skills find typescript
```
skills 仓库(本仓库) skiff CLI
skills/<name>/ ←── skiff install / enable
kits/<name>/ ←── 手动复制 / 项目文档引用
skiff/ ←── python3 -m skiff
registry.yaml ←── skiff add / fetch
@@ -173,7 +164,6 @@ registry.yaml ←── skiff add / fetch
| 类型 | 位置 | 维护方式 |
| --- | --- | --- |
| **Kit** | `kits/<name>/` | 本仓库 commit;复制到目标项目 `docs/` 或由项目 `AGENTS.md` 引用 |
| **OpenSpec 配置** | `openspec/` | 本仓库 commit;服务于本仓库自身的规格流程 |