在 GitHub 上编辑 content/zh/development.md ↗

开发

本页是 FlyBot 变更的验收契约。硬性 DSH 规则见 AGENTS.md 与 CONTRIBUTING.md;有日期的教训写入 LESSONS.md,至少三天后再提升到本页。

验证者诚实

报告变更状态时:

  1. Tip SHA:写明确切提交(git rev-parse HEAD)。
  2. Ran:列出你在该 tip 亲自运行过的每条命令与结果。
  3. Not run:列出未运行的重要检查(smoke、Desktop、真实模型)。缺少证据是缺口,不是 PASS。
  4. 不借信用:作者声明与其他 SHA 的旧 CI 不是你的结果。
  5. PASS 措辞:只写证据支持的内容,例如“unit + lint 在 abc1234 通过;smoke 未运行”。

先失败再修复

修复类,而不是样本

审查发现一条逃逸路径时,修复共享 helper 并覆盖同类标记(untrusted-message、untrusted-file、可信 header)。同类问题写入本页或 LESSONS.md,不要用特例掩盖。

列表同步

维护成员、名单或在线状态的变更必须显式处理四个坑:

静默捕获与 fence

循环

issue → claim → branch/worktree → red test → fix → gates → PR
      → review at the tip → risk tier → merge queue → release
  1. Issue。 从可复现缺陷或明确维护需求开始。先搜索开放与已关闭 issue。报告包含预期/实际行为、最小复现、file:line 与环境。
  2. 认领。 跳过已有 assignee 或活跃 claim 的 issue。分配维护者账号,添加 agent-working,评论分支与一行计划。
  3. 分支与失败测试。 从最新 main 开分支;一个 issue、一个分支、一个 PR。测试类。
  4. 门禁。 在将要链接的确切 tip,于 core/ 运行:
npm ci
npm run harness          # 一次性安装测试用的 DSH 包
npm run build
npm test
npm run lint
npm run arch-docs

客户端变更还要运行 node scripts/build-client.mjs --check;host 变更运行 smoke bench。用户可见变更需要 changelog fragment。

合并规则