🎨 style(docs): format markdown

docs/plans/2026-01-23-unified-playbook-cli-design.md

@@ -1,20 +1,24 @@
 # Unified Playbook CLI Design
 
 ## 目标
+
 - 提供单一入口 `scripts/playbook.py`，以 TOML 配置驱动所有动作。
 - 取消旧的 sh/ps1/bat 脚本与参数兼容，减少心智负担。
 - 保持功能覆盖：vendoring、同步模板、同步标准、安装 skills、格式化 Markdown。
 
 ## 非目标
+
 - 不保留旧脚本的参数兼容层。
 - 不引入新的依赖（Markdown 格式化仅使用已有 Prettier）。
 
 ## CLI 设计
+
 - 入口：`python scripts/playbook.py -config <path>`。
 - 仅支持两个参数：`-config`（必填）与 `-h/-help`。
 - `project_root` 默认取配置文件所在目录。
 
 ## TOML 结构
+
 - 通过 section 是否存在决定是否执行：
   - `[vendor]`
   - `[sync_templates]`
@@ -25,6 +29,7 @@
   `vendor → sync_templates → sync_standards → install_skills → format_md`。
 
 ## 行为要点
+
 - `vendor` 仅生成快照，不再隐式触发 `sync_standards`。
 - `sync_standards` 负责 `.agents/`、`AGENTS.md` 区块与 `.gitattributes`。
 - `sync_templates` 负责 memory-bank、docs/prompts、AGENTS/AGENT_RULES 模板。
@@ -32,16 +37,19 @@
 - `format_md` 仅调用已有 Prettier（可通过 globs 指定范围）。
 
 ## 预期输出
+
 - 新增：`scripts/playbook.py`、`playbook.toml.example`。
 - 删除：旧的 sh/ps1/bat 脚本与对应测试。
 - 更新：README/模板说明/CI/test.yml。
 
 ## 测试策略
+
 - 用 Python `unittest` 覆盖核心路径：
   - TOML 解析与动作触发顺序。
   - vendor/sync 模拟执行与关键输出文件检查。
 - 保留现有模板验证与文档链接检查。
 
 ## 风险
+
 - 旧脚本移除会影响现有用户；通过 README 与示例配置降低迁移成本。
 - Windows 环境权限可能影响 `npm install` 与符号链接；测试不依赖 npm。

docs/plans/2026-01-23-unified-playbook-cli.md

@@ -13,6 +13,7 @@
 ### Task 1: Create CLI test harness and basic argument handling
 
 **Files:**
+
 - Create: `tests/cli/test_playbook_cli.py`
 - Modify: `tests/README.md`
 
@@ -88,6 +89,7 @@ git commit -m ":white_check_mark: test(cli): add basic playbook cli tests"
 ### Task 2: Parse TOML config and enforce dispatch order
 
 **Files:**
+
 - Modify: `scripts/playbook.py`
 - Create: `playbook.toml.example`
 - Modify: `README.md`
@@ -156,6 +158,7 @@ git commit -m ":sparkles: feat(cli): add toml config and dispatch order"
 ### Task 3: Implement `vendor` action (snapshot only)
 
 **Files:**
+
 - Modify: `scripts/playbook.py`
 - Modify: `playbook.toml.example`
 - Modify: `README.md`
@@ -209,6 +212,7 @@ git commit -m ":sparkles: feat(vendor): add playbook snapshot generation"
 ### Task 4: Implement `sync_templates` and `sync_standards`
 
 **Files:**
+
 - Modify: `scripts/playbook.py`
 - Modify: `playbook.toml.example`
 - Modify: `templates/README.md`
@@ -283,6 +287,7 @@ git commit -m ":sparkles: feat(sync): add templates and standards actions"
 ### Task 5: Implement `install_skills` and `format_md`
 
 **Files:**
+
 - Modify: `scripts/playbook.py`
 - Modify: `playbook.toml.example`
 - Modify: `README.md`
@@ -336,6 +341,7 @@ git commit -m ":sparkles: feat(actions): add install_skills and format_md"
 ### Task 6: Remove legacy scripts and update CI/test docs
 
 **Files:**
+
 - Delete: `scripts/*.sh`, `scripts/*.ps1`, `scripts/*.bat`
 - Delete: `tests/scripts/*.bats`
 - Modify: `.gitea/workflows/test.yml`
@@ -386,6 +392,7 @@ git commit -m ":wastebasket: remove(legacy): drop old scripts and tests"
 ### Task 7: Final cleanup and formatting
 
 **Files:**
+
 - Modify: `README.md`, `templates/README.md`, `tests/README.md`
 
 **Step 1: Run Markdown format (exclude third-party skills)**