📝 docs(tsl): rebuild canonical syntax and routing manual
This commit is contained in:
@@ -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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user