feat(playbook): add playbook root boundary placeholder

This commit is contained in:
csh
2026-06-01 14:22:11 +08:00
parent f2ab57b39f
commit 02ad5e5f4a
3 changed files with 43 additions and 4 deletions
+17
View File
@@ -41,6 +41,23 @@
- 只做当前任务需要的改动,不顺手加功能、不顺手重构
- 不为一次性操作增加抽象,不为假设的未来需求设计
## 项目边界
### Playbook 目录
- `{{PLAYBOOK_ROOT}}/` 是 Playbook 模板/供应商目录,不是业务项目源码、
业务文档或当前项目私有规则
- 除非用户明确要求维护、升级或调试 Playbook 本身,不得修改
`{{PLAYBOOK_ROOT}}/` 下内容
- 当前项目已生效的规则入口是项目根目录的 `AGENT_RULES.md`
`AGENT_RULES.local.md``AGENTS.md``.agents/`
- `{{PLAYBOOK_ROOT}}/templates/``{{PLAYBOOK_ROOT}}/rulesets/`
是模板源;不要把它们当作当前项目已生效规则
- 可按 `.agents/` 指向读取 `{{PLAYBOOK_ROOT}}/docs/` 作为标准文档;
读取不代表该目录属于业务改动范围
- 搜索、批量修改、代码审查、归档/提交时,默认排除 `{{PLAYBOOK_ROOT}}/`
只有任务目标明确涉及 Playbook 时才纳入
## 会话启动
每次新会话开始时,按顺序加载以下上下文:
+5 -1
View File
@@ -141,7 +141,7 @@ python scripts/playbook.py -config playbook.toml
- **force**:默认 false,已存在则跳过;设为 true 时覆盖框架文件(会先备份)
- **no_backup**:默认 false;设为 true 时跳过备份直接覆盖
- **不删除项目文件**:只更新框架提供的文件,项目新增的文件不会被删除
- **占位符替换**:自动替换 `{{DATE}}``{{PROJECT_NAME}}``{{PLAYBOOK_SCRIPTS}}`
- **占位符替换**:自动替换 `{{DATE}}``{{PROJECT_NAME}}``{{PLAYBOOK_ROOT}}``{{PLAYBOOK_SCRIPTS}}`
### 典型场景
@@ -229,11 +229,15 @@ project/
| `{{PROJECT_NAME}}` | 项目名称 | ✅ 可选 |
| `{{PROJECT_GOAL}}` | 项目目标 | ❌ 手动 |
| `{{PROJECT_DESCRIPTION}}` | 项目描述 | ❌ 手动 |
| `{{PLAYBOOK_ROOT}}` | Playbook 根 | ✅ 是 |
| `{{PLAYBOOK_SCRIPTS}}` | 脚本路径 | ✅ 是 |
| 其他 `{{...}}` | 项目特定内容 | ❌ 手动 |
`{{PROJECT_NAME}}` 可通过 `sync_memory_bank.project_name` 自动替换;
未配置时保持原样。
`{{PLAYBOOK_ROOT}}` 自动替换为项目内 Playbook 根目录
(默认 `docs/standards/playbook`
也可按项目配置改成 `custom/playbook` 等)。
`{{PLAYBOOK_SCRIPTS}}` 自动替换为 Playbook 脚本路径
(默认 `docs/standards/playbook/scripts`
也可按项目配置改成 `custom/playbook/scripts` 等)。