laily
d791f5584c
- skills/manage-release -> skills/releaser（git mv，内容不变） - releaser 的 frontmatter/标题改名，description 保留旧名作为触发词 - skills/manage-release/ 保留为纯弃用占位（SKILL.md + README.md，指向 releaser）， 已装软链与旧项目 .pouch.yaml 不再悬空或失效 - 同步或引用：AGENTS.md、README.md、docs/getting-started.md、orc（routing/SKILL/README）、 ack delivery、builder（SKILL/README/contract）、memory-distill、pouch onboard 与 suggest_skills - 测试：catalog 需列出旧名占位，新增弃用占位断言，orc children 纳入旧名占位
50 lines
1.9 KiB
Markdown
50 lines
1.9 KiB
Markdown
# 在当前项目接入 skill
|
||
|
||
用户说「把 skill 接上」「在这个项目初始化 skill」「这个仓库该用哪些 pouch skill」时执行。
|
||
安装和初始化是两步，不要只 `pouch add` 就当接入完成。
|
||
|
||
当前目录是 pouch 仓库本身（有 `install.sh`、`skills/pouch/SKILL.md`、`bin/pouch`）时停：
|
||
这是维护 SSOT 的仓库，不要按业务项目接入。改 skill 走「创建」或「问题或优化回流」。
|
||
|
||
## 1. 看仓库信号
|
||
|
||
```bash
|
||
python3 <pouch-skill-dir>/scripts/suggest_skills.py
|
||
```
|
||
|
||
只根据脚本输出建议，不要为了「可能有用」推荐 eli5、note-style、host-sec-check 这类无仓库信号的 skill。
|
||
用户点名的除外。
|
||
|
||
## 2. 安装
|
||
|
||
把 `suggested` 和 `already` 都列为应安装的 skill（`already` 表示项目里已有状态，
|
||
软链仍要 `pouch add`，除非已经装上）。用户说「接上该用的」时只装这两类，不要全装 builtin。
|
||
只对 `init` 列问要不要初始化。
|
||
|
||
默认当前项目：
|
||
|
||
```bash
|
||
pouch add <name> -a cursor -a claude -a codex -a agents -y
|
||
```
|
||
|
||
只有用户明确要所有项目都能用时才加 `-g`。cwd 是 pouch 仓库时不要走到这一步。
|
||
|
||
## 3. 问一句要不要初始化
|
||
|
||
对已经装上、或本来就在的 ack / builder / deployer，看脚本的 `init` 列：
|
||
|
||
| Skill | 尚未初始化时对用户说 | 不要 |
|
||
| --- | --- | --- |
|
||
| ack | `/ack 初始化` 或 `pouch init ack` | 静默 `pouch init` |
|
||
| builder | 「用 builder 初始化」 | `pouch init builder` |
|
||
| deployer | 「用 deployer 初始化」 | `pouch init deployer` |
|
||
|
||
一次问清要初始化哪些。用户没点名不要自己跑初始化。ACK 初始化**不会**自动初始化
|
||
deployer / builder，需要的话要另说。
|
||
|
||
orc、releaser 和其余 builtin 装上就能用，不必项目初始化。
|
||
|
||
## 4. 介绍怎么喊
|
||
|
||
装完后跑 `catalog.py`，只念本次装上的那几行「可以这么说」。
|