csh
3d83740f88
25d895d 🐛 fix(gitea_workflow): clean up temp repos after job steps 2bc3b11 🐛 fix(gitea_workflow): clean up temporary repo dirs in workflows 98c3f30 📝 docs(agent_rules): allow plan execution on current branch 16c7230 📝 docs(prompts): define custom verify layering 8efc4dd 🐛 fix(skills): quote commit-message description bc8498f 🐛 fix(ci): install tomli for gitea tests 55cda3b 🐛 fix(tests): report missing toml parser clearly c0729c7 🐛 fix(playbook): import Optional for cli compatibility 63e24bf 📦 deps(skills): sync thirdparty skills d2f9356 🐛 fix(ci): isolate gitea workflow repos 588b81d 🐛 fix(ci): inline gitea workflow bootstrap e0b1c3a ♻️ refactor(skills): standardize first-party skill contracts 2c5050d ♻️ refactor(skills): rename repo skills source dir f049dfb 📦 deps(skills): drop duplicate first-party superpowers skills 234b335 ✨ feat(workflow): add superpowers planning and execution state tracking c1702a6 📝 docs(markdown): format tracked markdown and drop stale templates 2325409 📝 docs(markdown): clarify optional markdownlint usage 214c44e 🔧 chore(markdown): add markdownlint baseline and lint fixes a22b324 📝 docs(templates): add execution and memory-bank prompt templates 223a797 📝 docs(templates): update README for Claude Code and current features 4ac8672 📝 docs: simplify README + platform-agnostic tools + auto-create local rules 2431c9d 📝 docs: add claude_md config and use cross-platform paths d64b248 📝 docs: fix README.md inaccuracies and add Claude Code info c8d6bf2 🐛 fix(playbook): use relative paths in CLAUDE.md when not at project root 6518f0f ✨ feat(playbook): auto-create CLAUDE.md with path discovery 6ec9a45 ✨ feat(skills): add skill_link symlink support + platform-agnostic prompt 9f8b6b5 📝 docs: update README and config example for Claude Code support 79cff6c 📝 docs(skills): add Claude Code platform support 452c6f5 ✨ feat(playbook): auto-inject AGENTS.md into CLAUDE.md e1dbf3c 🐛 fix(skills): remove dual-path from commit-message skill f3a7259 🔧 chore(ci): use prepare_repo.sh in both workflows da08212 🔧 chore(ci): extract prepare_repo.sh and clean up workflows 7ade85e 🗑️ remove(tsl): drop syntax_book/, data/ source and build script f94dba0 ♻️ refactor(skills): update playbook.py and tests for thirdparty/ layout b3df412 ♻️ refactor(skills): separate thirdparty skills into thirdparty/ subdirectory 64950e7 📦 deps(skills): sync thirdparty skills a2e3cb0 ✨ feat(playbook): add no_backup deploy controls 8609d59 🐛 fix(docs): repair reference catalog source links 956da11 🐛 fix(playbook): publish hidden ci test fixes 3f67754 📦 deps(skills): sync thirdparty skills 08ca87b 📦 deps(skills): add karpathy thirdparty sync 96b705b 📝 docs(tsl): rebuild canonical syntax and routing manual 3ed5052 📦 deps(skills): sync thirdparty skills 60108dd 📦 deps(skills): sync thirdparty skills da85d4e 🐛 fix(thirdparty): prune nested project snapshots a2a697e 📦 deps(skills): sync thirdparty skills 9df610a 🐛 fix(thirdparty): exclude duplicated superpowers skills 33dd5bb 🐛 fix(thirdparty): preserve optional manifest fields 91b0ea7 🐛 fix(thirdparty): preserve manifest during snapshot update 2e26f98 🔧 chore(thirdparty): generalize skills sync pipeline 5b9c1e3 📦 deps(skills): sync superpowers 2f2d34a 📝 docs(readme): normalize subtree command spacing 62db7db 🐛 fix(ci): serialize superpowers update and sync 3463223 🐛 fix(ci): use literal superpowers sync paths 48f6de8 📦 deps(skills): sync superpowers 4b23529 🔧 chore(ci): merge superpowers update and sync workflow a56d75b 📦 deps(skills): sync superpowers 84bcefa 🔧 chore(ci): use ci[bot] commit author name 00a07e5 📦 deps(skills): sync superpowers 7b84daf 🐛 fix(templates): enforce main loop progress tracking 51373d7 🔧 chore(ci): automate superpowers sync workflow eaaa39c 🐛 fix(ci): prevent stale superpowers sync from restoring skills block 79755c6 📦 deps(skills): sync superpowers 836d878 📦 deps(skills): sync superpowers 8216c9f 📦 deps(skills): sync superpowers 9439505 🐛 fix(playbook): address reported repo issues git-subtree-dir: docs/standards/playbook git-subtree-split: 25d895d8b3f56624ccfe99ad7289e9eb49e0f316
82 lines
3.1 KiB
Markdown
82 lines
3.1 KiB
Markdown
# 🧪 Playbook 测试套件
|
||
|
||
本目录包含 Playbook 项目的测试，用于验证 CLI、模板与文档链接。
|
||
|
||
## 📋 目录结构
|
||
|
||
```txt
|
||
tests/
|
||
├── README.md # 本文件：测试文档
|
||
├── cli/ # Python CLI 测试（unittest）
|
||
│ └── test_playbook_cli.py # playbook.py 基础功能测试
|
||
├── test_format_md_action.py # format_md 动作测试
|
||
├── test_gitea_workflow_bootstrap.py # Gitea workflow 自举顺序回归测试
|
||
├── test_firstparty_skills_quality.py # first-party skills 元数据与结构质量测试
|
||
├── test_gitattributes_modes.py # gitattr_mode 行为测试
|
||
├── test_no_backup_flags.py # no_backup 行为测试
|
||
├── test_playbook_typing_imports.py # playbook.py typing 导入兼容性测试
|
||
├── test_sync_directory_actions.py # sync_memory_bank/sync_prompts 行为测试
|
||
├── test_vendor_snapshot_templates.py # vendor 快照模板完整性测试
|
||
├── test_main_loop_cli.py # main_loop CLI 测试
|
||
├── test_thirdparty_skills_pipeline.py # thirdparty skills 流水线配置与同步产物测试
|
||
├── test_sync_templates_placeholders.py # 占位符替换测试（sync_rules/sync_standards）
|
||
├── test_toml_edge_cases.py # TOML 解析边界测试
|
||
├── 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 # 文档链接有效性检查
|
||
```
|
||
|
||
## 🚀 快速开始
|
||
|
||
```bash
|
||
# 进入 playbook 根目录
|
||
cd /path/to/playbook
|
||
|
||
# 1. 运行 Python CLI 测试
|
||
python -m unittest discover -s tests/cli -v
|
||
|
||
# 1.1 运行其他 Python 测试（tests/ 下的 test_*.py）
|
||
python -m unittest discover -s tests -p "test_*.py" -v
|
||
|
||
# 2. 运行模板验证测试
|
||
sh tests/templates/validate_python_templates.sh
|
||
sh tests/templates/validate_cpp_templates.sh
|
||
sh tests/templates/validate_ci_templates.sh
|
||
sh tests/templates/validate_project_templates.sh
|
||
|
||
# 3. 运行文档链接检查
|
||
sh tests/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 配置解析与动作顺序
|
||
- vendor/sync_rules/sync_memory_bank/sync_prompts/sync_standards 等基础动作落地
|
||
|
||
### 2. 模板验证测试 (templates/)
|
||
|
||
通过脚本检查各类模板文件结构与关键字段（如占位符、关键配置项）。
|
||
|
||
### 3. 文档链接检查 (integration/)
|
||
|
||
扫描 `docs/` 与模板文件中的本地链接，确保引用路径有效。
|