feat(playbook): add plan progress tracking and rules updates

This commit is contained in:
csh
2026-01-26 16:51:23 +08:00
parent 6efd637119
commit 278750e3c9
23 changed files with 919 additions and 275 deletions
+25 -16
View File
@@ -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