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