武阳
34 lines
847 B
Markdown
34 lines
847 B
Markdown
# Task 002：项目级 Skills
|
||
|
||
## 目标
|
||
|
||
允许项目维护者直接在 workspace 根目录添加 skills：
|
||
|
||
```text
|
||
skills/
|
||
my-skill/
|
||
SKILL.md
|
||
```
|
||
|
||
## 查找顺序
|
||
|
||
当存在 workspace `cwd` 时：
|
||
|
||
1. `cwd/skills/*/SKILL.md`
|
||
2. `src/skills/bundled/*/SKILL.md`
|
||
3. Python 动态 skills
|
||
|
||
项目级 skills 优先于同名的内置目录 skill 或 Python 动态 skill。
|
||
|
||
## 接入点
|
||
|
||
- `Skill` 工具执行时，会通过当前 runtime `cwd` 解析项目级 skills。
|
||
- `/skills` 会列出当前 workspace 下的项目级 skills。
|
||
- Web UI `/api/skills` 会列出当前 Working dir 下的项目级 skills。
|
||
|
||
## 说明
|
||
|
||
- 项目级 skill 与内置目录化 skill 共用同一套 `SKILL.md` front matter 格式。
|
||
- `name`、`aliases`、`allowed_tools` 保持面向机器的英文字段。
|
||
- skill 正文可以使用中文或英文维护。
|