Squashed 'docs/standards/playbook/' changes from c3f8137..25d895d

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

playbook.toml.example

@@ -2,19 +2,20 @@
 # 配置文件所在目录默认作为 project_root。
 
 [playbook]
-# project_root = "."            # 可选：覆盖目标项目根目录
-# verbose = false               # 可选：输出更详细日志
-# dry_run = false               # 可选：仅预览，不写入
+# project_root = "."            # 可选：目标项目根目录
+# deploy_root = "docs/standards/playbook"  # 项目内已部署时可省略；从外部 clone 执行时必填；值始终是相对于 project_root 的项目内路径，不是外部 clone 的 playbook 路径
+# claude_md = "CLAUDE.md"       # 可选：CLAUDE.md 位置（默认自动检测：根目录 → .claude/CLAUDE.md → 自动创建）
 
 [vendor]
-# 将 playbook 裁剪快照写入 <project_root>/docs/standards/playbook
+# 当从外部 clone 的 playbook 向项目内部署快照时启用
+# 外部 clone 路径只用于执行脚本；快照仍会写入 <project_root>/<deploy_root>
 # langs = ["tsl"]               # 可选：默认仅 tsl
-# target_dir = "docs/standards/playbook"
 
 [sync_rules]
 # 同步 AGENT_RULES.md（配置节存在即启用）
 # force = false                 # 可选：覆盖已有文件
 # no_backup = false             # 可选：跳过备份
+# date = "2026-04-22"           # 可选：替换 {{DATE}}
 
 [sync_memory_bank]
 # 同步 memory-bank/（配置节存在即启用）
@@ -23,12 +24,14 @@
 # project_name = "MyProject"    # 可选：替换 {{PROJECT_NAME}}
 # force = false                 # 可选：覆盖已有文件（会先备份）
 # no_backup = false             # 可选：跳过备份
+# date = "2026-04-22"           # 可选：替换 {{DATE}}
 
 [sync_prompts]
 # 同步 docs/prompts/（配置节存在即启用）
 # 只更新框架提供的文件，项目新增的文件不会被删除
 # force = false                 # 可选：覆盖已有文件（会先备份）
 # no_backup = false             # 可选：跳过备份
+# date = "2026-04-22"           # 可选：替换 {{DATE}}
 
 [sync_standards]
 # langs = ["tsl", "cpp", "typescript"]  # 必填：要同步的语言
@@ -38,7 +41,9 @@
 [install_skills]
 # mode = "list"                 # list|all
 # skills = ["brainstorming"]    # mode=list 时必填
-# agents_home = "~/.agents"     # 可选：默认 ~/.agents
+# agents_home = "~/.agents"     # 部署目标；Codex CLI 用 "~/.agents"，Claude Code 用 "~/.claude"；默认 ~/.agents
+# skill_link = "~/.claude"      # 可选：在此目录下创建 skills/ 软链接指向 agents_home/skills/
+# no_backup = false             # 可选：跳过备份，直接删除旧 skill 后重装
 
 [format_md]
 # tool = "prettier"             # 仅支持 prettier