📝 docs(playbook): refresh guidance and examples

playbook.toml.example

@@ -31,7 +31,7 @@
 # no_backup = false             # 可选：跳过备份
 
 [sync_standards]
-# langs = ["tsl", "cpp"]        # 必填：要同步的语言
+# langs = ["tsl", "cpp", "typescript"]  # 必填：要同步的语言
 # gitattr_mode = "append"       # append(补全缺失)|overwrite(覆盖)|block(插入块)|skip(跳过)
 # no_backup = false             # 可选：跳过备份（.agents/.gitattributes）
 

templates/AGENT_RULES.template.md

@@ -151,6 +151,15 @@
 - **小步快跑**：每个 Plan 应该可快速完成
 - **可验证**：每个 Plan 必须包含验证步骤
 
+## 复利工程
+
+每次 Session 结束时：
+
+- **同一错误发生 2 次以上** → 立即更新 `AGENT_RULES.local.md` 或 `memory-bank/decisions.md`，避免下次重蹈
+- **发现项目特有规律**（如特定模块的注意事项、常见陷阱）→ 沉淀到 `AGENT_RULES.local.md`
+
+> 目标：让每次 Session 的起点比上次更高。
+
 ## 执行约束
 
 ### 代码修改
@@ -180,6 +189,16 @@
 - **避免循环**：避免重复调用同一工具获取相同信息
 - **优先专用工具**：文件操作用 Read/Edit/Write，搜索用 Grep/Glob
 
+## Context 管理
+
+以下情况应建议用户**开启新 Session**：
+
+- 当前方向明显跑偏，需要从头重新理解需求
+- 讨论阶段产生了多个候选方案，进入执行阶段时应清空对话
+- Session 过长导致注意力涣散，重复犯同类错误
+
+> 新 Session 在干净 context 下工作效果更好；切换不是失败，是重置起点。
+
 ## 需要确认的场景
 
 **常规模式**（可交互）：

tests/README.md

@@ -11,6 +11,7 @@ tests/
 │   └── test_playbook_cli.py        # playbook.py 基础功能测试
 ├── test_format_md_action.py        # format_md 动作测试
 ├── test_gitattributes_modes.py     # gitattr_mode 行为测试
+├── test_no_backup_flags.py         # no_backup 行为测试
 ├── test_sync_directory_actions.py  # sync_memory_bank/sync_prompts 行为测试
 ├── test_vendor_snapshot_templates.py # vendor 快照模板完整性测试
 ├── test_plan_progress_cli.py       # plan_progress CLI 测试