playbook/test/README.md

🧪 Playbook 测试套件

本目录包含 Playbook 项目的测试，用于验证 CLI、模板与文档链接。

📋 目录结构

test/
├── README.md                       # 本文件：测试文档
├── test_playbook.py                # snapshot/subtree 参数化完整部署测试
├── test_template_contracts.py      # 模板内容、占位符、文案契约测试
├── test_main_loop_cli.py           # main_loop CLI 测试
├── agent/                          # Agent 题面/运行时验证测试定义
├── test_thirdparty_skills_pipeline.py # thirdparty skills 流水线配置与同步产物测试
└── integration/                    # 集成测试
    └── check_doc_links.py          # 文档链接有效性检查

🚀 快速开始

# 进入 playbook 根目录
cd /path/to/playbook

# 1. 运行 Python 测试（test/ 下的 test_*.py）
python -m unittest discover -s test -p "test_*.py" -v

# 2. 运行文档链接检查
python test/integration/check_doc_links.py

🧭 CI 自动化测试

测试套件通过 Gitea Actions 自动运行（见 .gitea/workflows/test.yml）：

• 触发时机：
  • 推送到 main 分支
  • Pull Request 到 main 分支
  • 手动触发（workflow_dispatch）
• 运行平台：ubuntu-22.04

📚 测试详解

1. Playbook 部署测试 (test_playbook.py)

使用同一个完整 playbook.toml 参数化验证：

• snapshot 与 subtree 两种安装模式
• rules、memory bank、prompts、standards 和 skills 同步
• 重复执行的幂等性与自定义文件保留

2. 模板合同测试 (test_template_contracts.py)

随 Python 测试检查通用模板的关键 marker、占位符和流程合同。

3. 文档链接检查 (integration/)

扫描 docs/ 与模板文件中的本地链接，确保引用路径有效。