✨ feat(playbook): add plan progress tracking and rules updates
This commit is contained in:
@@ -1,8 +1,7 @@
|
||||
# SKILLS
|
||||
|
||||
本文件定义:如何在仓库中落地与维护 **Codex CLI
|
||||
skills**(实验功能),并给出与本 Playbook(`docs/` +
|
||||
`.agents/`)配套的技能编写建议与内置技能清单。
|
||||
本文件定义:如何在仓库中落地与维护 **Codex CLI skills**(实验功能),
|
||||
并给出与本 Playbook(`docs/` + `rulesets/`)配套的技能编写建议与内置技能清单。
|
||||
|
||||
> 提示:Codex skills 是“按用户安装”的(默认在
|
||||
> `~/.codex/skills`)。本仓库将 skills 以可分发的形式放在
|
||||
@@ -136,16 +135,17 @@ python docs/standards/playbook/scripts/playbook.py -config playbook.toml
|
||||
|
||||
---
|
||||
|
||||
## 8. 本 Playbook 内置 skills
|
||||
## 8. 本 Playbook 原生 skills
|
||||
|
||||
位于 `codex/skills/`:
|
||||
位于 `codex/skills/`(Playbook 自维护部分),当前共 4 个。
|
||||
第三方 superpowers 列表见第 9 节。
|
||||
|
||||
### 语言特定 Skills
|
||||
|
||||
- **`tsl-guide`**:TSL/TSF 语法与编码完整指南
|
||||
- 渐进式教学体系:基础语法 → 高级特性 → 函数库 → 最佳实践
|
||||
- 包含 4 个子文档:primer.md / advanced.md / functions_index.md / common_patterns.md
|
||||
- 总计 962 行,按需加载
|
||||
- 总计约 1000 行,按需加载
|
||||
- 触发词:TSL 语法, 写 TSL, TSL 函数, TSL class, 矩阵操作, TS-SQL 等
|
||||
|
||||
### 通用工作流 Skills
|
||||
@@ -156,17 +156,10 @@ python docs/standards/playbook/scripts/playbook.py -config playbook.toml
|
||||
|
||||
---
|
||||
|
||||
## 9. 运行时排障
|
||||
## 9. Third-party Skills (superpowers)
|
||||
|
||||
- 不触发:
|
||||
- 确认已启用 `[features] skills = true`
|
||||
- 确认 skill 已安装到 `$CODEX_HOME/skills/<name>/SKILL.md`
|
||||
- 重启 `codex`(skills 只在启动时加载)
|
||||
- 触发错:减少不同 skill 的 `description`
|
||||
关键词重叠;让触发词更具体(语言/工具/目录名/流程名)。
|
||||
- 启动报错:通常是 YAML frontmatter 不合法或字段超长;修复后重启即可。
|
||||
|
||||
### Third-party Skills (superpowers)
|
||||
来源:`codex/skills/.sources/superpowers.list`(第三方来源清单)。
|
||||
本节仅列出 superpowers 体系 skills,与本 Playbook 原生 skills 分离。
|
||||
|
||||
<!-- superpowers:skills:start -->
|
||||
|
||||
@@ -185,3 +178,19 @@ python docs/standards/playbook/scripts/playbook.py -config playbook.toml
|
||||
- writing-plans
|
||||
- writing-skills
|
||||
<!-- superpowers:skills:end -->
|
||||
|
||||
---
|
||||
|
||||
## 10. 运行时排障
|
||||
|
||||
- 不触发:
|
||||
- 确认已启用 `[features] skills = true`
|
||||
- 确认 skill 已安装到 `$CODEX_HOME/skills/<name>/SKILL.md`
|
||||
- 重启 `codex`(skills 只在启动时加载)
|
||||
- 触发错:减少不同 skill 的 `description`
|
||||
关键词重叠;让触发词更具体(语言/工具/目录名/流程名)。
|
||||
- 启动报错:通常是 YAML frontmatter 不合法或字段超长;修复后重启即可。
|
||||
|
||||
---
|
||||
|
||||
**最后更新**:2026-01-26
|
||||
|
||||
Reference in New Issue
Block a user