📝 docs(tsl): rebuild canonical syntax and routing manual

This commit is contained in:
csh
2026-04-22 16:59:20 +08:00
parent 3ed5052e61
commit 96b705b00b
83 changed files with 46446 additions and 323 deletions
+9 -13
View File
@@ -24,7 +24,7 @@ skills = true
## 2. 本仓库的 skills 目录结构
本 Playbook 以“可 vendoring”的方式提供 skills
本 Playbook 以“可分发、可安装”的方式提供 skills
```txt
codex/skills/
@@ -79,13 +79,14 @@ agents_home = "./.agents"
> 注意:Codex 默认从 `~/.agents/skills` 加载 skills;使用本地安装时,需要确保 Codex 能发现该路径。
如果你的项目通过 `git subtree` vendoring 本 Playbook(推荐前缀
`docs/standards/playbook`),则在目标项目里执行:
如果你的项目已经把本 Playbook 部署到项目内(无论来自 `git subtree`,还是外部 clone 后部署到自定义根目录),则在目标项目里执行:
```bash
python docs/standards/playbook/scripts/playbook.py -config playbook.toml
python <deploy_root>/scripts/playbook.py -config playbook.toml
```
其中 `<deploy_root>` 默认为 `docs/standards/playbook`,也可以是 `custom/playbook` 等自定义目录。
安装后重启 `codex`,即可在运行时看到 `## Skills` 列表。
---
@@ -129,24 +130,19 @@ python docs/standards/playbook/scripts/playbook.py -config playbook.toml
- C++`docs/cpp/code_style.md``docs/cpp/naming.md``docs/cpp/toolchain.md`
- Python`docs/python/style_guide.md``docs/python/tooling.md``docs/python/configuration.md`
若你的项目通过 git subtree 引入本 Playbook,常见路径为
`docs/standards/playbook/docs/...`;把上述 `docs/` 前缀替换为
`docs/standards/playbook/docs/` 即可。
若你的项目把本 Playbook 部署到项目内,文档根路径为
`<deploy_root>/docs/...`;其中 `<deploy_root>` 默认为 `docs/standards/playbook`,也可以按项目配置改成 `custom/playbook` 等自定义目录。
---
## 8. 本 Playbook 原生 skills
位于 `codex/skills/`(Playbook 自维护部分),当前共 4 个。
位于 `codex/skills/`(Playbook 自维护部分),当前共 3 个。
第三方 skills 来源见第 9 节。
### 语言特定 Skills
- **`tsl-guide`**:TSL/TSF 语法与编码完整指南
- 渐进式教学体系:基础语法 → 高级特性 → 函数库 → 最佳实践
- 包含 4 个子文档:primer.md / advanced.md / functions_index.md / common_patterns.md
- 总计约 1000 行,按需加载
- 触发词:TSL 语法, 写 TSL, TSL 函数, TSL class, 矩阵操作, TS-SQL 等
当前仓库不再内置语言特定 skill;TSL 相关问题请直接查阅 `rulesets/tsl/index.md``docs/tsl/`
### 通用工作流 Skills