♻️ refactor(playbook): streamline agents and refresh tsl docs

This commit is contained in:
csh
2026-01-10 16:55:44 +08:00
parent b529012c59
commit 5822a8736d
88 changed files with 103561 additions and 130104 deletions
+44 -4
View File
@@ -63,6 +63,28 @@ sh scripts/install_codex_skills.sh
sh scripts/install_codex_skills.sh style-cleanup code-review-workflow
```
如果希望“项目内本地安装”(不污染全局),可用以下方式:
```bash
# 安装到当前目录的 .codex/skills/
sh scripts/install_codex_skills.sh --local
# 或手动指定 CODEX_HOME
CODEX_HOME="$(pwd)/.codex" sh scripts/install_codex_skills.sh
```
PowerShell / Windows
```powershell
powershell -File scripts/install_codex_skills.ps1 -Local
```
```bat
scripts\install_codex_skills.bat --local
```
> 注意:Codex 只会从 `CODEX_HOME` 加载 skills;使用本地安装时,启动 Codex 需设置同样的 `CODEX_HOME`。
如果你的项目通过 `git subtree` vendoring 本 Playbook(推荐前缀
`docs/standards/playbook`),则在目标项目里执行:
@@ -123,8 +145,27 @@ sh docs/standards/playbook/scripts/install_codex_skills.sh
位于 `codex/skills/`
- `commit-message`:基于 staged
diff 自动建议提交信息(`:emoji: type(scope): subject`
### 语言特定 Skills
- **`tsl-guide`**:TSL/TSF 语法与编码完整指南
- 渐进式教学体系:基础语法 → 高级特性 → 函数库 → 最佳实践
- 包含 4 个子文档:primer.md / advanced.md / functions_index.md / common_patterns.md
- 总计 962 行,按需加载
- 触发词:TSL 语法, 写 TSL, TSL 函数, TSL class, 矩阵操作, TS-SQL 等
### 通用工作流 Skills
- **`performance-optimization`**:跨语言性能优化工作流
- 适用:TSL / Python / C++
- 流程:度量基线 → 定位瓶颈 → 优化策略 → 验证效果
- 109 行
- **`testing-workflow`**:跨语言测试策略
- 适用:TSL / Python / C++
- 覆盖:单元测试 / 集成测试 / 回归测试
- 108 行
- `commit-message`:基于 staged diff 自动建议提交信息(`:emoji: type(scope): subject`
- `create-plan`:生成简明计划(适用于用户明确要求规划编码任务)
- `code-review-workflow`:结构化代码评审(正确性/安全/性能/测试)
- `style-cleanup`:整理代码风格(优先使用仓库既有 formatter/lint 工具链)
@@ -133,8 +174,7 @@ sh docs/standards/playbook/scripts/install_codex_skills.sh
- `defense-in-depth`:关键路径分层校验/多道防线
- `bulk-refactor-workflow`:批量重构(安全做法 + 验证契约)
- `document-workflow`PDF/DOCX/PPTX/XLSX 文档工作流(带开源 fallback)
- `pdf-workflow` / `docx-workflow` / `pptx-workflow` /
`xlsx-workflow`:按格式拆分的文档子工作流
- `pdf-workflow` / `docx-workflow` / `pptx-workflow` / `xlsx-workflow`:按格式拆分的文档子工作流
- `verification-before-completion`:先验证再宣称完成(证据链优先)
---