🔧 feat(skills): install to agents home

This commit is contained in:
csh
2026-02-05 15:26:48 +08:00
parent 8b75747587
commit 872c1afc24
5 changed files with 41 additions and 16 deletions
+7 -7
View File
@@ -4,8 +4,8 @@
并给出与本 Playbook`docs/` + `rulesets/`)配套的技能编写建议与内置技能清单。
> 提示:Codex skills 是“按用户安装”的(默认在
> `~/.codex/skills`)。本仓库将 skills 以可分发的形式放在
> `codex/skills/`,并提供脚本一键安装到你的 `CODEX_HOME`。
> `~/.agents/skills`)。本仓库将 skills 以可分发的形式放在
> `codex/skills/`,并提供脚本一键安装到你的 `~/.agents`。
---
@@ -38,14 +38,14 @@ codex/skills/
最终安装到本机后,对应路径为:
```txt
$CODEX_HOME/skills/<skill-name>/SKILL.md
~/.agents/skills/<skill-name>/SKILL.md
```
---
## 3. 安装到本机(推荐)
使用统一入口 `playbook.py` 安装 skills(会把 `codex/skills/*` 复制到 `$CODEX_HOME/skills/`):
使用统一入口 `playbook.py` 安装 skills(会把 `codex/skills/*` 复制到 `~/.agents/skills/`):
```toml
# playbook.toml
@@ -54,7 +54,7 @@ project_root = "."
[install_skills]
mode = "all" # list|all
codex_home = "~/.codex"
agents_home = "~/.agents"
```
```bash
@@ -74,10 +74,10 @@ skills = ["style-cleanup", "commit-message"]
```toml
[install_skills]
mode = "all"
codex_home = "./.codex"
agents_home = "./.agents"
```
> 注意:Codex 只会从 `CODEX_HOME` 加载 skills;使用本地安装时,启动 Codex 需设置同样的 `CODEX_HOME`
> 注意:Codex 默认从 `~/.agents/skills` 加载 skills;使用本地安装时,需要确保 Codex 能发现该路径
如果你的项目通过 `git subtree` vendoring 本 Playbook(推荐前缀
`docs/standards/playbook`),则在目标项目里执行: