refactor: unify skill source model
This commit is contained in:
@@ -15,7 +15,7 @@ SSOT 固定在 `~/.skills/skills/<name>/`。内容通过 **symlink** 分发到
|
||||
|
||||
## 在项目中使用 skill
|
||||
|
||||
先浏览可用的 owned skill,再安装到当前项目:
|
||||
先浏览可用的 builtin skill,再安装到当前项目:
|
||||
|
||||
```bash
|
||||
skiff add --list
|
||||
@@ -61,11 +61,11 @@ skiff finalize <name>
|
||||
|
||||
1. 先记录最小证据:触发用户表达、使用的 skill 名称、实际结果、期望结果,以及能复现问题的必要项目上下文。
|
||||
2. 判断归属:
|
||||
- 通用工作流、触发条件或验证缺陷:回流 owned skill。
|
||||
- 通用工作流、触发条件或验证缺陷:回流 builtin skill。
|
||||
- 仅当前项目成立的命令、路径、业务规则:留在项目文档或项目配置,不写回通用 skill。
|
||||
- CLI 安装、软链或校验行为异常:修改 `~/.skills/skiff/` 中的 CLI 和测试。
|
||||
- 第三方 skill:不要复制成 owned skill 或直接改安装目录;整理证据反馈上游,除非用户明确决定维护 fork。
|
||||
3. 确认真实来源。Agent 目录通常是软链,owned skill 的 SSOT 固定为:
|
||||
- 第三方 skill:不要复制成 builtin skill 或直接改安装目录;整理证据反馈上游,除非用户明确决定维护 fork。
|
||||
3. 确认真实来源。Agent 目录通常是软链,builtin skill 的 SSOT 固定为:
|
||||
|
||||
```text
|
||||
~/.skills/skills/<name>/
|
||||
@@ -108,7 +108,7 @@ skiff add discussion-notes -a cursor -g -y
|
||||
skiff add discussion-notes -a cursor -a codex -g -y
|
||||
```
|
||||
|
||||
registry 条目既可以指向单个 skill,也可以指向包含多个 skill 目录的
|
||||
catalog source既可以指向单个 skill,也可以指向包含多个 skill 目录的
|
||||
collection。安装 collection 全部内容或其中一个:
|
||||
|
||||
```bash
|
||||
@@ -182,4 +182,4 @@ ACK 配置、检查接入状态或
|
||||
- 不要在 `project/.agents/skills/` 里直接改文件;应改 `~/.skills/skills/` 再 `publish`
|
||||
- 未完成的内容保留在 `~/.skills/.drafts/`,不要直接放进正式 `skills/`
|
||||
- symlink 正确时,**不需要 reinstall**;保存 SSOT 后各项目自动读到新内容
|
||||
- 社区 skill 用 `npx skills add`,不要用 skiff `registry add` 除非团队要 pin 版本
|
||||
- 社区 skill 用 `npx skills add`,不要用 skiff `catalog add` 除非团队要 pin 版本
|
||||
|
||||
Reference in New Issue
Block a user