Squashed 'docs/standards/playbook/' changes from b529012..a854534

a854534 ✨ feat(plan_progress): auto-detect env for blocked plans
0d9a8ec 🐛 fix(playbook): honor no_backup for sync
2d401fa ✅ test(templates): update prompts validation
e23474e 📝 docs(playbook): update prompts and sync notes
60ff3cd 🐛 fix(playbook): sync templates per file
816f036 ✅ test(playbook): add sync and vendor coverage
625cabb 📝 docs(memory_bank): reformat templates
2554c87 📝 docs(prompts): refresh prompt templates
6774a9d ✨ feat(plan_progress): track plan status in progress.md
73d5c26 🔧 chore(playbook): split sync_templates into sections
278750e ✨ feat(playbook): add plan progress tracking and rules updates
6efd637 🐛 fix(sync): keep agents block blank lines
ea00d43 🐛 fix(playbook): support toml without tomllib
ab0dd11 📝 docs(playbook): drop docs/plans snapshots
398696c ✨ feat(playbook): merge unified cli
d959f80 🎨 style(docs): format markdown
b4f712a 🗑️ remove(legacy): drop old scripts and tests
0c4cd0e ✨ feat(actions): add install_skills and format_md
3d1582c ✨ feat(sync): add templates and standards actions
49bbfa1 ✨ feat(vendor): add playbook snapshot generation
8cfcc25 ✨ feat(cli): parse toml config and dispatch actions
05903c3 ✨ feat(cli): add toml config and dispatch order
65d216e ✅ test(cli): add basic playbook cli tests
f0bcf54 📝 docs(plans): add unified playbook cli plan
0885309 📝 docs(plans): add unified playbook cli design
3483d8a 🔧 chore(git): ignore .worktrees dir
eb75036 🔧 chore(templates): align agent templates and docs
efb93f1 📝 docs(playbook): drop todo/confirm mentions
4a85306 🗑️ remove(workflow): drop todo/confirm artifacts
9c5ee9f 🎨 style(markdown): format docs with prettier
5a2925f 🐛 fix(scripts): repair windows script parsing
26a35e0 ✅ test(ci): update required skills list
8df3883 🐛 fix(test): skip external root doc links
b067fc1 📦 deps(skills): sync superpowers
c03cda0 🔧 chore(ci): sync from origin main
55e05cb 🔧 chore(ci): use superpowers sync script
73c97f3 🔧 chore(ci): centralize superpowers sync
945704f 🔧 chore(ci): add superpowers sync workflow
e5d2c93 🗑️ remove(skills): drop duplicate workflows
3ae9708 🐛 fix(ci): update tests for flag-only scripts
c44b9aa 🔧 chore(scripts): require flag-driven args
e4e1d14 🔧 chore(scripts): unify single-dash options
b2eb475 ✅ test(templates): add template coverage
fc230b7 🎨 style(markdown): format markdown files
8dc8924 🔧 chore(markdown): add prettier config and usage
2045dd4 ✨ feat(vendor_playbook): add apply-templates option
872d8cf ✨ feat(templates): add sync templates scaffolding
5b1ca45 📝 docs(skills): clarify todo-plan template
054967a ✨ feat(skills): add todo-plan skill
cc340f1 🔧 chore(ci): align standards-check workflow template
e9de0aa 🔧 chore(ci): drop removed skill check
e5dd7d9 🔧 fix(sync): avoid backtick expansion
087b0b9 🔧 chore(sync): align agents block across ps1/bat
9481510 🔧 chore(sync): scope agents block to existing langs
b0ca842 🔧 fix(sync): rewrite docs path in agents
c98d65c 🔧 chore(sync): rewrite agents docs paths
c33611c 🗑️ remove(skills): drop unused skills and update references
2b37860 🎨 style(markdown): format markdown files
e3ecd26 📝 docs(tsl): align syntax annotations and examples
37546fe 🐛 fix(playbook): enforce rulesets to agents flow
f2df89d 🐛 fix(scripts): include language list in AGENTS.md
c0d0737 🐛 fix(playbook): add agents mirror for sync
3b8b99b 🎨 style(markdown): normalize md headings and lists
31f3000 ♻️ refactor(playbook): rename agents template directory to rulesets
11b2bed ✨ feat(markdown): add ruleset and sync support
5b89580 ✅ test(scripts): quiet git init warnings
5822a87 ♻️ refactor(playbook): streamline agents and refresh tsl docs

git-subtree-dir: docs/standards/playbook
git-subtree-split: a85453439f65b0c0aa05a5bbece773a02216ce76

templates/prompts/README.md

@@ -0,0 +1,48 @@
+# 提示词库
+
+本目录包含 AI 代理的工作流程参考模板。
+
+## 目录结构
+
+```text
+prompts/
+├── README.md              # 本文件
+├── system/
+│   └── agent-behavior.md  # 工作模式参考
+├── coding/
+│   ├── clarify.md         # 需求澄清模板
+│   └── review.md          # 复盘总结模板
+└── meta/
+    └── prompt-generator.md # 元提示词生成器
+```
+
+## 使用方式
+
+| 模板                    | 触发场景                       |
+| ----------------------- | ------------------------------ |
+| **agent-behavior.md**   | 切换工作模式（探索/开发/调试） |
+| **clarify.md**          | 需求不明确时澄清               |
+| **review.md**           | Plan 完成后复盘总结            |
+| **prompt-generator.md** | 创建新的专用提示词             |
+
+## 工作流程
+
+```
+需求不清 → clarify.md
+    ↓
+头脑风暴 → $brainstorming skill
+    ↓
+生成计划 → $writing-plans skill → docs/plans/*.md
+    ↓
+执行计划 → AGENT_RULES 主循环（留痕）
+    ↓
+完成复盘 → review.md
+    ↓
+沉淀提示词 → prompt-generator.md（可选）
+```
+
+> **核心规则在 `AGENT_RULES.md`**，第三方 skills 负责规划，主循环负责执行和留痕。
+
+---
+
+**最后更新**：{{DATE}}

templates/prompts/coding/clarify.template.md

@@ -0,0 +1,52 @@
+# 需求澄清模板
+
+<!--
+按需使用：当需求不明确或存在歧义时参考本模板。
+Vibe-coding 场景下可跳过，直接开始实现。
+-->
+
+## 何时使用
+
+- 需求描述不明确
+- 存在多种理解方式
+- 缺少关键信息
+
+---
+
+## 澄清步骤
+
+### 1. 复述需求
+
+```text
+我理解你的需求是：[用自己的话复述]
+```
+
+### 2. 识别歧义
+
+- 歧义 1：[描述不明确的地方]
+- 歧义 2：[可能有多种理解的地方]
+
+### 3. 提出问题
+
+> 只问阻塞问题，最多 1–2 个；优先给出选项让用户选择。
+
+- 这个功能是否包括 [场景 A]？
+- 当 [条件 X] 时，应该 [行为 Y] 还是 [行为 Z]？
+
+### 4. 提供选项
+
+**选项 A**：[方案描述]
+
+- 优点：...
+- 缺点：...
+
+**选项 B**：[方案描述]
+
+- 优点：...
+- 缺点：...
+
+**推荐**：[推荐哪个，为什么]
+
+---
+
+**最后更新**：{{DATE}}

templates/prompts/coding/review.template.md

@@ -0,0 +1,66 @@
+# 复盘模板
+
+<!--
+用途：Plan 或阶段完成后的回顾总结
+触发：主循环汇总报告时、阶段性工作完成时
+-->
+
+## 何时使用
+
+- 一批 Plan 执行完毕后
+- 阶段性工作告一段落
+- 遇到重大阻塞需要总结
+
+---
+
+## 复盘格式
+
+```markdown
+# 复盘: [日期/阶段名称]
+
+## 完成情况
+
+### 已完成
+- [x] Plan 1: 简述
+- [x] Plan 2: 简述
+
+### 阻塞
+- [ ] Plan 3: 阻塞原因
+
+### 跳过
+- [ ] Plan 4: 跳过原因
+
+## 关键发现
+
+### 做得好的
+- 发现1
+- 发现2
+
+### 待改进
+- 问题1 → 建议改进方式
+- 问题2 → 建议改进方式
+
+## 决策记录
+
+| 决策 | 理由 | 影响 |
+|------|------|------|
+| 决策1 | 为什么 | 影响范围 |
+
+## 下一步
+
+- [ ] 待处理事项1
+- [ ] 待处理事项2
+```
+
+---
+
+## 复盘原则
+
+- **客观记录**：如实记录完成/阻塞/跳过
+- **提取经验**：总结做得好的和待改进的
+- **决策留痕**：重要决策记录到 decisions.md
+- **明确下一步**：列出后续待处理事项
+
+---
+
+**最后更新**：{{DATE}}

templates/prompts/meta/prompt-generator.template.md

@@ -0,0 +1,126 @@
+# 提示词生成器（元提示词）
+
+<!--
+用途：根据场景自动生成专用提示词
+原理：α-prompts（生成）+ Ω-prompts（优化）递归循环
+-->
+
+## 何时使用
+
+- 需要为新场景创建专用提示词
+- 现有提示词不满足特定需求
+- 需要批量生成同类提示词
+
+---
+
+## 生成流程（α循环）
+
+### 1. 分析场景
+
+```markdown
+**场景名称**：[名称]
+**目标用户**：[AI/人类/两者]
+**触发条件**：[何时使用这个提示词]
+**预期输出**：[使用后应该产出什么]
+```
+
+### 2. 提取约束
+
+```markdown
+**必须做**：
+- 约束1
+- 约束2
+
+**禁止做**：
+- 禁止1
+- 禁止2
+
+**边界条件**：
+- 边界1
+- 边界2
+```
+
+### 3. 生成草稿
+
+```markdown
+# [提示词标题]
+
+<!--
+用途：[一句话描述]
+触发：[触发条件]
+-->
+
+## 何时使用
+
+- 场景1
+- 场景2
+
+## [核心内容]
+
+[根据场景填充]
+
+## [约束/原则]
+
+- 约束1
+- 约束2
+
+---
+
+**最后更新**：{{DATE}}
+```
+
+---
+
+## 优化流程（Ω循环）
+
+### 1. 评估维度
+
+| 维度       | 问题                   |
+| ---------- | ---------------------- |
+| **清晰度** | 指令是否明确无歧义？   |
+| **完整度** | 是否覆盖所有必要场景？ |
+| **简洁度** | 是否有冗余内容可删除？ |
+| **可操作** | AI 能否直接执行？      |
+
+### 2. 迭代优化
+
+```
+草稿 → 评估 → 修改 → 再评估 → ... → 定稿
+```
+
+### 3. 验证测试
+
+- 用实际场景测试提示词效果
+- 收集反馈，持续迭代
+
+---
+
+## 提示词模板库
+
+### 标准结构
+
+```markdown
+# [标题]
+
+<!--
+用途：
+触发：
+-->
+
+## 何时使用
+## [核心内容]
+## [约束/原则]
+
+---
+
+**最后更新**：{{DATE}}
+```
+
+### 命名规范
+
+- 文件名：`[动词]-[对象].template.md`
+- 示例：`clarify-requirement.template.md`
+
+---
+
+**最后更新**：{{DATE}}

templates/prompts/system/agent-behavior.template.md

@@ -0,0 +1,62 @@
+# 工作模式参考
+
+<!--
+本文件定义三种工作模式，供 AI 根据任务类型选择。
+核心规则（安全红线、验证清单等）见 AGENT_RULES.md。
+-->
+
+## 模式 1: 探索模式（Explore）
+
+**目的**：理解代码库、分析问题、收集信息
+
+**行为**：
+
+- 使用搜索工具探索代码
+- 输出分析报告和发现
+- 不修改任何代码
+
+**适用场景**：
+
+- 理解某个模块的实现
+- 分析 bug 的根本原因
+- 评估功能实现的可行性
+
+---
+
+## 模式 2: 开发模式（Develop）
+
+**目的**：实现功能、修复 bug、重构代码
+
+**行为**：
+
+- 先读取相关文件，理解现有逻辑
+- 进行精确修改
+- 修改后运行测试验证
+
+**适用场景**：
+
+- 实现新功能
+- 修复已知 bug
+- 优化性能
+
+---
+
+## 模式 3: 调试模式（Debug）
+
+**目的**：诊断问题、对比差异、验证行为
+
+**行为**：
+
+- 收集相关日志和输出
+- 分析差异原因
+- 修复后重新验证
+
+**适用场景**：
+
+- 测试失败
+- 输出不符合预期
+- 性能问题诊断
+
+---
+
+**最后更新**：{{DATE}}