Squashed 'docs/standards/playbook/' changes from e504a68..b529012

b529012 ✅ test(tests): avoid hardcoded missing path
07583c8 🐛 fix(tests): make doc link check awk-portable
6244aa3 🔧 chore(ci): relax gitattributes check
31dd0c5 🐛 fix(scripts): require existing project root
15d4d63 🔧 chore(ci): install python3-pip
90c6313 🔧 chore(ci): run tests in a single job
d84eff0 🔧 chore(ci): make actions base url configurable
395598d 🔧 chore(ci): fix yaml step names
4ae2733 ✨ feat(sync_standards): auto-detect existing languages
e97fb00 ✨ feat(sync_standards): default gitattributes to append
da0ef2b ✅ test: add automated tests and ci workflow
99bef30 🎨 style(markdown): format all markdown files with prettier
7e96bc8 ♻️ refactor(tsl): split function.md into 44 modular files
0d6b2a0 📝 docs(readme): add quick decision table and TL;DR for distribution methods
3b2188f 🎨 style(markdown): format markdown files with prettier
41fc43b 📝 docs(tsl): document {Unit.}Type source annotation
3dceaf7 📝 docs(tsl): clarify tsf-only top-level rules and type annotations
3a63829 📝 docs(skills): add create-plan skill
f02a707 🐛 fix(scripts): escape markdown backticks in vendor_playbook
064aa92 🐛 fix(scripts): correct bat scripts
4881feb 🔧 chore(gitattributes): enforce crlf for bat files
1fa3e2a 🐛 fix(scripts): escape parentheses in sync_standards output
3958cad 📝 docs(vendor_playbook): mention ci templates
9d059cf ✨ feat(templates): add gitea ci example
a52bb24 📝 docs(codex_skills): normalize markdown formatting
cc8ad4c 📝 docs(skills): slim commit-message
2a98e15 🐛 fix(skills): quote YAML descriptions
8f78d22 🐛 fix(sync_standards): generate minimal AGENTS.md
5547665 ✨ feat(skills): add commit-message suggestion skill
3fe8bd7 🔧 chore(sync_standards): create AGENTS.md on sync
283d311 ✨ feat(playbook): add syntax book and codex skills tooling
5b97ed5 📝 docs(tsl): clarify syntax references
27e0700 ✨ feat(skills): add pdf/docx/pptx/xlsx wrapper workflows
5551363 ✨ feat(skills): add debugging and bulk refactor workflows
1d4f548 ✨ feat(skills): add built-in workflow skills
c0895dd 📝 docs(skills): add anthropics document-skills integration
cf9f80d 🔧 chore(playbook): add Claude Code skills guide and align python templates

git-subtree-dir: docs/standards/playbook
git-subtree-split: b529012c59c5d67c3073884d7b617763647417fd

docs/tsl/toolchain.md

@@ -2,6 +2,12 @@
 
 本文件提供一份**通用占位模板**，用于在不同 TSL 项目中快速补齐“工具链与如何验证”的关键上下文。
 
+最小必填清单（落地到具体项目时必须补齐，否则文档不可用）：
+
+- 工具名称、可执行命令、安装方式（版本要求可选）
+- 至少一个可运行的“最小冒烟”命令（或脚本入口）
+- 失败处理约定（含：无法执行时的替代验证方式）
+
 使用方式：
 
 - 在具体项目中复制本模板并把占位符替换为真实信息；
@@ -12,10 +18,12 @@
 ### 1.1 解释器/编译器（必填）
 
 - 工具名称：`<tsl/tslcli/内部工具名>`
-- 可执行命令：
-  - macOS/Linux：`<command>`（例：`tsl` / `tslcli` / `sh scripts/tsl.sh`）
-  - Windows：`<command>`（例：`tsl.exe` / `tslcli.exe` / `powershell -File scripts/tsl.ps1`）
-- 版本要求：`<固定版本或范围，例如：= 3.2.1 / >=3.2,<4.0>`
+- 可执行命令（统一用 `<tsl>` 表示 TSL 可执行入口）：
+  - macOS/Linux：`<tsl>`（例：`tsl` / `sh scripts/tsl.sh`）
+  - Windows：`<tsl>`（例：`tsl.exe` / `powershell -File scripts/tsl.ps1`）
+- 基本执行方式：`<tsl> <path/to/script.tsl> <args...>`（TSL 通常直接执行脚本文件）
+- 版本要求（可选）：`<固定版本或范围，例如：= 3.2.1 / >=3.2,<4.0>`（未知可留空或写
+  `N/A`）
 - 安装方式：`<内部安装包/路径/IDE 自带/CI 镜像等>`
 - 推荐统一入口脚本：`scripts/tsl.{sh,ps1}`（封装参数与环境变量，避免每个任务重复猜测）
 
@@ -26,6 +34,8 @@
 - 运行约束：
   - 是否允许联网：`<yes/no>`
   - 是否需要许可证/凭证：`<说明如何在本地与 CI 提供；禁止写入仓库>`
+  - 约定：凭证/许可证等敏感信息通过环境变量或 CI
+    secrets 注入；文档只写变量名/获取方式，不写明文值。
 
 ## 2. 验证命令
 
@@ -33,30 +43,34 @@
 
 ### 2.1 最小冒烟（必须能跑）
 
-- macOS/Linux：`<tsl> run <path/to/SmokeTest.tsl> -- <args>`
-- Windows：`<tsl.exe> run <path\\to\\SmokeTest.tsl> -- <args>`
+- macOS/Linux：`<tsl> <path/to/SmokeTest.tsl> <args...>`
+- Windows：`<tsl> <path\\to\\SmokeTest.tsl> <args...>`
 - 或统一入口：
   - `sh scripts/smoke.sh`
   - `powershell -File scripts/smoke.ps1`
+- Success
+  signal（建议写清）：退出码为 0；并给出“成功时的关键输出/产物路径”（例如输出包含某行、或生成某文件）。
 
 ### 2.2 单元测试（如有）
 
 - `sh scripts/test.sh`
-- 或：`<tsl> test <tests/>`
-- 或：`<tsl> run <path/to/TestRunner.tsf>`
+- 或：`<tsl> <path/to/TestRunner.tsl> <args...>`
+- Success signal：退出码为 0；失败时能定位到具体用例/输入。
 
 ### 2.3 静态检查/格式化（如有）
 
 - `sh scripts/lint.sh`
 - `sh scripts/format.sh`
-- 或：`<tsl> check <src/>` / `<tsl> fmt <src/>`
+- Success
+  signal：退出码为 0；formatter 二次运行无新增 diff（若项目提供 formatter）。
 
 ### 2.4 构建/打包（如有）
 
 - `sh scripts/build.sh`
-- 或：`<tsl> build <project-file>`
+- Success signal：退出码为 0；产物路径明确且可复现（例如输出目录/包名）。
 
 ### 2.5 失败处理约定（必填）
 
 - 只修复与本次改动直接相关的失败；无关失败在输出中说明并隔离。
 - 若某验证步骤无法执行（缺环境/缺凭证），必须明确写出原因与替代验证手段（例如最小复现脚本/手动检查清单）。
+- 建议在输出中记录：执行的命令、退出码、以及关键日志片段（便于 review 与复现）。