diff --git a/playbook.toml.example b/playbook.toml.example index fe91a93..6771f28 100644 --- a/playbook.toml.example +++ b/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) diff --git a/templates/AGENT_RULES.template.md b/templates/AGENT_RULES.template.md index a38bc86..a92d8b0 100644 --- a/templates/AGENT_RULES.template.md +++ b/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 下工作效果更好;切换不是失败,是重置起点。 + ## 需要确认的场景 **常规模式**(可交互): diff --git a/tests/README.md b/tests/README.md index 7f25ef3..c3c7cb8 100644 --- a/tests/README.md +++ b/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 测试