feat(playbook): version durable scratch workflow state

This commit is contained in:
csh
2026-08-14 17:11:54 +08:00
parent 9487dbddf1
commit 8f1056130d
8 changed files with 237 additions and 17 deletions
+11
View File
@@ -25,6 +25,7 @@ playbook/
templates/
├── AGENTS.template.md # 项目主入口与导航模板
├── AGENT_RULES.template.md # Matt Pocock ticket-native 执行规则模板
├── gitignore.template # .scratch 持久状态与本机运行时忽略规则
├── memory-bank/ # 稳定项目知识模板(3 个),不是机器状态源
├── cpp/ # C++ 工具链模板
└── python/ # Python 工具链模板
@@ -47,6 +48,7 @@ templates/
- `AGENT_RULES.md``<!-- playbook:rules:start/end -->` 区块内的工程流程由 Playbook
维护,重新同步时刷新;项目自己的补充写在区块外,同步不会动它
- `AGENT_RULES.local.md`:项目私有规则,Playbook 不覆盖
- `.gitignore`:Playbook 维护专属标记区块,仅忽略 `.scratch` 下的本机运行时产物
- `memory-bank/`:稳定项目定位、技术上下文和当前系统模式,不承载机器状态
Playbook 只处理框架提供的同名文件。项目新增的 `memory-bank/*` 不会被删除。
@@ -119,12 +121,14 @@ setup-matt-pocock-skills
-> to-spec
-> to-tickets
-> main_loop.py enqueue
-> 提交 planning baselinespec + tickets + queue
-> main_loop.py claim
-> 本地 ticket 执行协议(tdd
-> commit
-> code-review
-> main_loop.py finish
-> main_loop.py integrate
-> 提交 final workflow state
```
产物和职责:
@@ -136,6 +140,12 @@ setup-matt-pocock-skills
- `docs/adr/`:长期架构决策
- `docs/agents/*.md`tracker 与领域文档配置
本批次 feature 全部 `enqueue` 后,先把对应 spec、tickets 和 queue 提交为一个 planning
baseline,再开始任何 `claim`。生成和入队步骤本身不隐式提交。
feature 集成成功后,再在主干提交该 feature 的最终 `.scratch` 持久状态。此提交位于 feature
merge commit 之后,并与其他活动 feature 的未提交状态隔离。
明确串行时可用 in-place,不创建 worktree;计划多个 session 并发时,第一个 claim
就指定 worktree。并发 sessions 必须共享同一文件系统与 Git common directory
`main_loop.py` 不支持跨机器、独立 clone 或远程 tracker adapter。Matt skills 可单独
@@ -175,6 +185,7 @@ project/
├── AGENTS.md # 任一 sync_* 节启用时创建或按区块更新
├── AGENT_RULES.md # [sync_rules]
├── AGENT_RULES.local.md # 首次成功写入规则时创建,后续由项目维护
├── .gitignore # [sync_rules] 更新 Playbook .scratch 标记区块
├── CLAUDE.md # 默认位置;也可使用 .claude/CLAUDE.md
├── .agents/ # [sync_standards]
├── .gitattributes # [sync_standards] 按配置同步