cshandClaude Fable 5
bb8bc6dff9
删除静态文档中对 tsl-syntax-reference / tsl-api-reference 的导航路由， 改由运行时按需自动触发；语法/API 事实的所有权与 fail-closed 约束 只保留在 rulesets/tsl/index.md 这一唯一权威载体。 - docs/tsl/index.md：删 4 行 skill 路由及重复的所有权/fail-closed 段，回归纯分流 - docs/tsl/modules/index.md：删 API 路由及指向已删 syntax 的 3 处回跳 - docs/index.md：删 skill 导航行及 2 条指向不存在文件的死 catalog 链 - docs/tsl/syntax/index.md：删除旧路径兼容 stub，不再保留任何兼容 - rulesets/tsl/index.md：删首跳 2 条 skill 导航，保留事实边界与 Fail closed - 同步修正相关测试断言 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
🧪 Playbook 测试套件
本目录包含 Playbook 项目的测试，用于验证 CLI、模板与文档链接。
📋 目录结构
test/
├── README.md # 本文件：测试文档
├── test_gitea_workflow_bootstrap.py # Gitea workflow 自举顺序回归测试
├── test_playbook_config_actions.py # playbook.toml 驱动的同步/部署行为测试
├── test_playbook_toml_parser.py # TOML parser/load_config 边界测试
├── test_template_contracts.py # 模板内容、占位符、文案契约测试
├── test_main_loop_cli.py # main_loop CLI 测试
├── agent/ # Agent 题面/运行时验证测试定义
├── test_thirdparty_skills_pipeline.py # thirdparty skills 流水线配置与同步产物测试
├── templates/ # 模板验证测试
│ ├── validate_python_templates.sh # Python 模板验证
│ ├── validate_cpp_templates.sh # C++ 模板验证
│ ├── validate_ci_templates.sh # CI 模板验证
│ └── validate_project_templates.sh # 项目模板验证
└── integration/ # 集成测试
└── check_doc_links.sh # 文档链接有效性检查
🚀 快速开始
# 进入 playbook 根目录
cd /path/to/playbook
# 1. 运行 Python 测试（test/ 下的 test_*.py）
python -m unittest discover -s test -p "test_*.py" -v
# 2. 运行模板验证测试
sh test/templates/validate_python_templates.sh
sh test/templates/validate_cpp_templates.sh
sh test/templates/validate_ci_templates.sh
sh test/templates/validate_project_templates.sh
# 3. 运行文档链接检查
sh test/integration/check_doc_links.sh
🧭 CI 自动化测试
测试套件通过 Gitea Actions 自动运行（见 .gitea/workflows/test.yml）：
- 触发时机：
- 推送到
main分支 - Pull Request 到
main分支 - 手动触发（workflow_dispatch）
- 推送到
- 运行平台：ubuntu-22.04
📚 测试详解
1. Python CLI 测试 (cli/)
使用 unittest 运行，覆盖 scripts/playbook.py 的核心行为：
- CLI 参数解析与帮助信息
- TOML 配置解析与动作顺序
- snapshot install/sync_rules/sync_memory_bank/sync_prompts/sync_standards 等基础动作落地
2. 模板验证测试 (templates/)
通过脚本检查各类模板文件结构与关键字段（如占位符、关键配置项）。
3. 文档链接检查 (integration/)
扫描 docs/ 与模板文件中的本地链接，确保引用路径有效。