feat(workflow): enforce auditable agent rules

This commit is contained in:
csh
2026-08-12 12:40:31 +08:00
parent 1d9590f6a1
commit 91b6f8453e
7 changed files with 1273 additions and 318 deletions
+17 -5
View File
@@ -42,13 +42,15 @@ templates/
- 更新标记区块时保留区块外的项目内容
- 已有的人工入口和项目补充说明继续由项目维护
### 2. 初始化后由项目维护
### 2. 流程由 Playbook 维护,补充由项目维护
- `AGENT_RULES.md`项目采用的完整工程流程与执行规则
- `AGENT_RULES.md``<!-- playbook:rules:start/end -->` 区块内的工程流程由 Playbook
维护,重新同步时刷新;项目自己的补充写在区块外,同步不会动它
- `AGENT_RULES.local.md`:项目私有规则,Playbook 不覆盖
- `memory-bank/`:稳定项目定位、技术上下文和当前系统模式,不承载机器状态
Playbook 只处理框架提供的同名文件。项目新增的 `memory-bank/*` 不会被删除。
没有标记区块的旧 `AGENT_RULES.md` 保持原样,不会被静默改写。
### 3. 参考模板
@@ -72,15 +74,23 @@ heartbeat、ticket 或集成状态;机器状态只以 `.scratch/` 和 `main_lo
### AGENT_RULES.template.md
部署为项目的 `AGENT_RULES.md`,是 Matt Pocock 工程主链、ticket 调度、worktree、
验证和集成协议的唯一流程权威。项目私有规则写入 `AGENT_RULES.local.md`;该文件由
项目维护,Playbook 不覆盖。
部署为项目的 `AGENT_RULES.md`,是任务入口路由、Matt Pocock 工程主链、ticket 调度、
worktree、验证和集成协议的唯一流程权威。`<!-- playbook:rules:start/end -->` 区块内的
内容由 Playbook 维护并在重新同步时刷新,项目补充写在区块外。项目私有规则写入
`AGENT_RULES.local.md`;该文件由项目维护,Playbook 不覆盖。
### AGENTS.template.md
部署为项目的 `AGENTS.md`,只提供语言规则、核心规则和工程上下文导航。
标记区块的更新约束见下文“AGENTS 模板标记”。
## 任务入口
四个入口按成本递增,取第一个满足的:直接执行(零行为变更)、单切片改动(单模块、
已有 seam、一个 session 内)、已明确预期行为的 bug(`diagnosing-bugs` Phase 1-6)、
新 feature 或设计变更(完整主链)。边界不清时从单切片改动起步,触到升级条件再转入
完整主链,不要预付最重的流程。判据与升级条件见 `AGENT_RULES.template.md`
## 部署
```toml
@@ -101,6 +111,8 @@ local markdown tracker。
## 正式开发流程
只有第四个入口(新 feature 或设计变更)走这条链;前三个入口不入队、不建 ticket branch。
```text
setup-matt-pocock-skills
-> grill-with-docs