feat(playbook): add syntax book and codex skills tooling

This commit is contained in:
csh
2025-12-22 13:39:49 +08:00
parent 5b97ed5322
commit 283d311d4f
41 changed files with 247368 additions and 646 deletions
+30 -2
View File
@@ -49,9 +49,9 @@ PlaybookTSL`.tsl`/`.tsf`+ C++ + Python 工程规范与代理规则合
- `.agents/cpp/`C++ 规则集(入口:`.agents/cpp/index.md`)。
- `.agents/python/`Python 规则集(入口:`.agents/python/index.md`)。
## SKILLSClaude Code
## SKILLSCodex CLI
如需在目标项目中为 Claude Code 配置 Skills(例如 code review 工作流),参考:`SKILLS.md`
本仓库内置一组 Codex CLI skills(见 `codex/skills/`),用于 code review / 格式化 / 调试等工作流;安装与编写规范见 `SKILLS.md`
## 在其他项目中使用本 Playbook
@@ -201,6 +201,34 @@ sh docs/standards/playbook/scripts/sync_standards.sh tsl cpp
该方式没有自动同步能力,后续更新需重复上述复制流程。
### 方式三:脚本裁剪复制(按语言,离线)
当你希望“只 vendoring 需要的语言规范”(例如只需要 `tsl` + `cpp`)时,可直接运行本仓库提供的裁剪脚本:
- macOS/Linux
```bash
sh <PLAYBOOK_ROOT>/scripts/vendor_playbook.sh <target-project-root> tsl cpp
```
- PowerShell
```powershell
powershell -File <PLAYBOOK_ROOT>\\scripts\\vendor_playbook.ps1 -DestRoot <target-project-root> -Langs tsl,cpp
```
- Windows bat
```bat
<PLAYBOOK_ROOT>\\scripts\\vendor_playbook.bat <target-project-root> --langs tsl,cpp
```
脚本会:
- 生成裁剪快照到 `docs/standards/playbook/`(包含 `docs/common/` + 选定语言目录 + 对应 `.agents/<lang>/` + `scripts/` + `.gitattributes` + 相关 `templates/<lang>/`
- 自动执行 `docs/standards/playbook/scripts/sync_standards.*`,把 `.agents/<lang>/` 与 `.gitattributes` 落地到目标项目根目录
- 生成 `docs/standards/playbook/SOURCE.md` 记录来源与版本信息
### 多语言项目落地(TSL + C++/其他语言)
多语言项目建议把规范拆成两类: