diff --git a/docs/plans/2026-01-23-unified-playbook-cli-design.md b/docs/plans/2026-01-23-unified-playbook-cli-design.md
new file mode 100644
index 0000000..2b1d8ad
--- /dev/null
+++ b/docs/plans/2026-01-23-unified-playbook-cli-design.md
@@ -0,0 +1,47 @@
+# 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]`
+  - `[sync_standards]`
+  - `[install_skills]`
+  - `[format_md]`
+- 固定执行顺序（不支持 step list）：
+  `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 模板。
+- `install_skills` 将 `codex/skills` 复制到目标 `~/.codex` 或指定路径。
+- `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。