♻️ refactor(tsl-api): tighten docs and retire stale tests
This commit is contained in:
+18
-20
@@ -1,21 +1,22 @@
|
||||
# 🧪 Playbook 测试套件
|
||||
|
||||
本目录包含 Playbook 项目的测试,用于验证 CLI、模板与文档链接。
|
||||
本目录包含 Playbook 项目的可执行行为测试。
|
||||
|
||||
## 📋 目录结构
|
||||
|
||||
```txt
|
||||
test/
|
||||
├── README.md # 本文件:测试文档
|
||||
├── test_playbook.py # snapshot/subtree 参数化完整部署测试
|
||||
├── test_template_contracts.py # 模板内容、占位符、文案契约测试
|
||||
├── test_commit_message_policy.py # 提交信息校验器和 CI 委托行为
|
||||
├── test_gitea_fetch_ci_logs.py # Gitea CI 日志采集行为
|
||||
├── test_main_loop_cli.py # ticket 调度、隔离、证据与集成测试
|
||||
├── agent/ # Agent 题面/运行时验证测试定义
|
||||
├── test_thirdparty_skills_pipeline.py # thirdparty skills 流水线配置与同步产物测试
|
||||
├── test_tsl_playbook_sync.py # TSL Playbook 构建与同步边界测试
|
||||
├── test_tsl_syntax_reference.py # TSL 语法文档结构与检索测试
|
||||
└── integration/ # 集成测试
|
||||
└── check_doc_links.py # 文档链接有效性检查
|
||||
├── test_main_loop_scheduler.py # 全局调度器和依赖图行为
|
||||
├── test_playbook.py # snapshot/subtree 参数化完整部署测试
|
||||
├── test_thirdparty_skills_pipeline.py # thirdparty skills 流水线配置与同步行为
|
||||
├── test_tsl_api_framework.py # TSL API 索引和 Framework Profile 行为
|
||||
├── test_tsl_playbook_sync.py # TSL Playbook 构建与同步行为
|
||||
└── integration/ # 文档完整性检查
|
||||
└── check_doc_links.py # 本地 Markdown 链接目标检查
|
||||
```
|
||||
|
||||
## 🚀 快速开始
|
||||
@@ -24,10 +25,10 @@ test/
|
||||
# 进入 playbook 根目录
|
||||
cd /path/to/playbook
|
||||
|
||||
# 1. 运行 Python 测试(test/ 下的 test_*.py)
|
||||
# 运行 Python 测试(test/ 下的 test_*.py)
|
||||
python -X utf8 -B -m unittest discover -s test -p "test_*.py" -v
|
||||
|
||||
# 2. 运行文档链接检查
|
||||
# 文档链接检查
|
||||
python test/integration/check_doc_links.py
|
||||
```
|
||||
|
||||
@@ -51,20 +52,17 @@ python test/integration/check_doc_links.py
|
||||
- rules、memory bank、prompts、standards 和 skills 同步
|
||||
- 重复执行的幂等性与自定义文件保留
|
||||
|
||||
### 2. 模板合同测试 (`test_template_contracts.py`)
|
||||
|
||||
随 Python 测试检查通用模板的关键 marker、占位符和流程合同。
|
||||
|
||||
### 3. 主循环测试 (`test_main_loop_cli.py`)
|
||||
### 2. 主循环测试 (`test_main_loop_cli.py`)
|
||||
|
||||
使用临时 Git 仓库验证 ticket 队列、串行与 worktree 隔离、并发 claim、heartbeat/reclaim、
|
||||
验证与 review 证据绑定,以及 ticket/feature 两级集成。
|
||||
|
||||
### 4. TSL 契约测试
|
||||
### 3. TSL 和同步行为测试
|
||||
|
||||
- `test_tsl_api_framework.py`:验证 API 索引、class 查询和 Framework Profile 行为
|
||||
- `test_tsl_playbook_sync.py`:验证 TSL Playbook 构建和同步文件边界
|
||||
- `test_tsl_syntax_reference.py`:验证语法文档结构、section ID 与检索结果
|
||||
- `test_thirdparty_skills_pipeline.py`:验证 thirdparty manifest、workflow 和同步产物
|
||||
|
||||
### 5. 文档链接检查 (integration/)
|
||||
### 4. 文档链接检查 (`integration/`)
|
||||
|
||||
扫描 `docs/` 与模板文件中的本地链接,确保引用路径有效。
|
||||
扫描仓库中的 Markdown 文件,确保本地文档引用的目标路径有效。
|
||||
|
||||
Reference in New Issue
Block a user