Squashed 'docs/standards/playbook/' changes from 8b75747..c3f8137

c3f8137 📦 deps(skills): sync superpowers
35e827d 📦 deps(skills): sync superpowers
e546ffb 📦 deps(skills): sync superpowers
f7f2c57 🔧 chore(ci): use ci-bot identity for superpowers sync commits
fa247a7 📦 deps(skills): sync superpowers
a97c333 🔧 chore(ci): add resilient upstream fetch fallback for superpowers update
484f9d3 🔧 chore(ci): automate thirdparty superpowers refresh and sync base
c19e53e 📝 docs(playbook): refresh guidance and examples
52046b4 📝 docs(prompts): add code-review template and align docs flow
9ac8a4c 📝 docs(typescript): clarify ts and js support boundaries
1f46203  feat(typescript): add standards docs and sync rewrite coverage
872c1af 🔧 feat(skills): install to agents home

git-subtree-dir: docs/standards/playbook
git-subtree-split: c3f81371e24d63b603de9b6eb92bf7e4c453a2b4
This commit is contained in:
csh
2026-03-04 15:56:21 +08:00
parent 4c9ed050ba
commit 35e6a301aa
26 changed files with 842 additions and 59 deletions
+29 -22
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`),则在目标项目里执行:
@@ -161,22 +161,29 @@ python docs/standards/playbook/scripts/playbook.py -config playbook.toml
来源:`codex/skills/.sources/superpowers.list`(第三方来源清单)。
本节仅列出 superpowers 体系 skills,与本 Playbook 原生 skills 分离。
<!-- superpowers:skills:start -->
### Third-party Skills (superpowers)
- brainstorming
- dispatching-parallel-agents
- executing-plans
- finishing-a-development-branch
- receiving-code-review
- requesting-code-review
- subagent-driven-development
- systematic-debugging
- test-driven-development
- using-git-worktrees
- using-superpowers
- verification-before-completion
- writing-plans
- writing-skills
### Third-party Skills (superpowers)
### Third-party Skills (superpowers)
### Third-party Skills (superpowers)
<!-- superpowers:skills:start -->
- \
- \
- \
- \
- \
- \
- \
- \
- \
- \
- \
- \
- \
- \
<!-- superpowers:skills:end -->
---