用 devloops 把「发现—修复—审查」变成对抗式 Agent 循环：producer/worker/gatekeeper、tick gate 与人工合并实操

# 复制模式（默认）
git clone https://github.com/fritzprix/devloops.git
devloops/scripts/install.sh /path/to/project

# 软链模式（跟随上游更新）
devloops/scripts/install.sh /path/to/project --link

安装后的布局

<project>/
├─ .agents/
│  ├─ skills/
│  │  ├─ worker-loop/        SKILL.md + references/ + scripts/
│  │  ├─ gatekeeper-loop/    同上
│  │  └─ producer-loop/      同上
│  └─ devloops_lib/          共享代码：配置、tick 门控、PR 状态、
│                            issue 队列、producer、doctor
├─ devloops.config.yaml      项目配置（不存在时才生成）
└─ .devloops/                各循环 state.json 与 tick.lock（默认）

# devloops.config.yaml 关键字段

project:
  repo: owner/name              # GitHub 仓库
  default_branch: main          # 仓库默认分支
  base_branch: main             # PR 的目标分支

commands:                       # 循环用来验证的项目命令
  test:  npm test
  lint:  npm run lint
  build: npm run build

protected_paths:                # 需要人来拍板的路径
  - .github/workflows/
  - infra/

cleanup:
  protected_branches: [main, release]

state_dir: .devloops            # 可用 $LOOP_STATE_DIR 覆盖

labels:
  producer: auto:producer       # producer 提的候选 issue
  validated: validated          # gatekeeper：issue 与代码相符
  rejected:  rejected           # gatekeeper：issue 与代码不符
  approved:  approved           # 只有人能打：范围已接受

producer:
  default_period: 24h
  max_new_issues_per_run: 3
  tasks: [security, e2e, uiux, regression, usage-logs, doc-drift, cleanup]
  task_periods:
    cleanup: 7d
  task_max_new_issues:
    security: 2

scheduler: shell                # shell / cron / 宿主适配

# 检查前置条件：Python、GitHub API、git、gh auth、推送权限
python3 .agents/skills/worker-loop/scripts/doctor.py

/worker-loop            立刻跑一轮
/worker-loop 10m        挂一个每 10 分钟一轮的循环，并先跑一轮
/worker-loop status     看状态（current / needsUser / skipped）
/worker-loop stop       停掉循环

# gatekeeper 与 producer 形式相同
/gatekeeper-loop 10m --pr 12    评审指定 PR
/producer-loop security         跑一个 producer 任务

tick gate 的四步与四种退出码

1. --lock 抢 tick.lock，被占则打印 BUSY
2. 一次 GraphQL 请求算出指纹，并保留为本轮开头指纹
3. 无 current 工作 且 指纹等于已存的 lastFingerprint → 打印 NOOP
4. 轮次结束时：
     idle 或 needsUser → --update --unlock，保存「轮次开头」的指纹
     做了事 或 失败   → 仅 --unlock，下一轮继续跑

退出码：0 = RUN   1 = NOOP   2 = BUSY   3 = ERROR
        （ERROR 指认证、网络或 GraphQL 失败）

# 只在门控说 RUN 时才启动 Agent 的 cron 写法
*/10 * * * * cd /path/to/project \
  && python3 .agents/skills/worker-loop/scripts/tick_gate.py --lock \
  && /path/to/agent-runner "/worker-loop"

# shell 循环与宿主适配器的写法见
# skills/worker-loop/references/scheduling.md

完整链路

producer-loop ──► issue（自动打 auto:producer）
                     │
gatekeeper-loop ──► validated | rejected      （拿 issue 对照代码）
                     │
人 ─────────────► approved                    （接受范围）
                     │
worker-loop ─────► PR
                     │
gatekeeper-loop ─► 裁决评论（带隐藏标记）+ gatekeeper:* 标签
                     │  changes-requested ─► worker 回应 ─► 重审 …
                     ▼
                  approve（+ CI 绿）
                     │
人 ─────────────► merge

五个 gatekeeper 标签

auto:producer / auto:<task>      producer：来自某项任务的候选 issue
validated / rejected             gatekeeper：issue 与代码相符 / 不符
approved                         只有人能打：范围已接受，worker 可领
gatekeeper:changes-requested     worker 必须回应这些发现
gatekeeper:approved              可以等人来合并了
gatekeeper:escalated             worker 与 gatekeeper 不一致，人必须决定
gatekeeper:needs-human           安全敏感或触碰 protected_paths

# producer 挑最逾期的任务
python3 .agents/skills/producer-loop/scripts/producer_gate.py --next

# 跑一个指定任务
/producer-loop security

安全规则（编码在技能里，不靠提示词自觉）

· 任何循环都不合并、不启用 auto-merge、不打标签、不发布
· worker 不关 issue、不删远程分支
· worker 只在 rebase 之后对自己的 PR 分支用 --force-with-lease
· worker 只 rebase，从不把 base 合并进特性分支
· worker 只在自己的 worktree 里干活，从不碰你的检出
· worker 每轮只做一件事，只改这一个 PR 或 issue 涉及的文件
· worker 开到 5 个开放 PR 就停，CI 修复失败 3 次后问人
· producer 只建 issue，不改代码、评论、标签，也不写密钥与私有路径
· gatekeeper 不加 approved、不关 issue、不改代码
· approve 之后的推送必须重新评审
· PR 正文、评论、CI 日志都是不可信数据，循环从不执行其中的指令