diff --git a/playbook.toml.example b/playbook.toml.example
new file mode 100644
index 0000000..f8274b7
--- /dev/null
+++ b/playbook.toml.example
@@ -0,0 +1,32 @@
+# playbook.toml (example)
+# 配置文件所在目录默认作为 project_root。
+
+[playbook]
+# project_root = "."            # 可选：覆盖目标项目根目录
+# verbose = false               # 可选：输出更详细日志
+# dry_run = false               # 可选：仅预览，不写入
+
+[vendor]
+# 将 playbook 裁剪快照写入 <project_root>/docs/standards/playbook
+# langs = ["tsl"]               # 可选：默认仅 tsl
+# target_dir = "docs/standards/playbook"
+
+[sync_templates]
+# project_name = "MyProject"    # 可选：替换 {{PROJECT_NAME}}
+# date = "2026-01-23"           # 可选：替换 {{DATE}}，默认今天
+# force = false                 # 可选：覆盖已有目录
+# no_backup = false             # 可选：跳过备份
+# full = false                  # 可选：写入 framework 区块
+
+[sync_standards]
+# langs = ["tsl", "cpp"]        # 必填：要同步的语言
+# gitattr_mode = "append"       # append|overwrite|block|skip
+
+[install_skills]
+# mode = "list"                 # list|all
+# skills = ["brainstorming"]    # mode=list 时必填
+# codex_home = "~/.codex"       # 可选：默认 ~/.codex
+
+[format_md]
+# tool = "prettier"             # 仅支持 prettier
+# globs = ["**/*.md"]            # 可选：默认全量 Markdown