✨ feat(playbook): add playbook root boundary placeholder
This commit is contained in:
@@ -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
@@ -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` 等)。
|
||||
|
||||
Reference in New Issue
Block a user