✨ feat(workflow): enforce auditable agent rules
This commit is contained in:
+17
-5
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user