文档 / 总览
文档
安装 GitHub App,编写你的 maintainer.yml 策略,并了解机群如何分流、交接和交付。每一个操作都有审计记录。
# yaml-language-server: $schema=https://developerz.ai/schemas/maintainer.v1.json
version: 1从这里开始
配置智能体
- maintainer.yml 参考
每一个策略字段及其示例。该文件界定了智能体可以执行的操作。
- 技术栈
我们如何识别仓库的技术栈、它获得的三个脚本(安装、运行、检查),以及检查如何表明它无法测试某个变更。
- AI 代码评审
在你自己的模型密钥上运行的 AI 代码评审。保留你的 .coderabbit.yaml,或在策略文件中设置评审规则。
- 从 CodeRabbit 迁移
将代码评审迁移到你自己的密钥上,无需改写配置:你的 .coderabbit.yaml 继续有效。
- 依赖更新机器人
Dependabot 与 Renovate 的 PR 如何按你的策略评审、修复并合并,附推荐的 dependabot.yml。
- 停滞的 Issue 与 PR
对等待提交者回应的 Issue 与 PR 先提醒、后关闭。默认关闭,需由你开启,并附推荐配置。
- 升级处理
智能体在哪些情况下会先停下来询问维护者:安全、许可证、破坏性变更,以及你启用的其他类别。
- 策略重放
在过去的工作上测试策略变更:查看新的 maintainer.yml 会改变哪些决定。不改变任何内容,也不保存任何内容。
连接你的工具
- MCP 客户端接入
将 Claude Code、Cursor、ChatGPT 或 Claude 应用连接到我们的 MCP 服务器,然后提交你的第一个需求并查看结果。
- GitHub Copilot
将修复交给 GitHub Copilot。由 Copilot 发起 PR,是否合并由你的策略决定。
- Claude Code
将 issue 交给 Claude Code,在你自己的机器上、使用你自己的模型密钥运行。它对我们 MCP 服务器的每一次调用均有日志。
- OpenHands
将任务交给 OpenHands,在你自己的机器上、使用你自己的模型密钥运行。每一次交接均有审计记录。
- 自托管 CI
修改 runs-on 一行,即可在你接入的服务器上运行 GitHub Actions 任务;公开仓库需先开启。
- 出站 webhook
向你的 URL 发送带签名的事件:每个事件包含什么、如何确认它来自我们、重试机制,以及目前有哪些事件。
- 错误跟踪(Sentry)
将 Sentry 告警发送到 developerz.ai:每个新错误都会成为一个需求,智能体可将其转为修复,并按你的策略合并。
管理你的账户
- 产物存储
智能体生成的文件(如截图、报告和构建产物)可在我们的存储桶中保存最多 7 天,或在你自己的 S3 存储桶中按你需要的时长保存。
- 自带日志存储与保留期
我们将运行、评审和 CI 的原始日志保留 72 小时。接入你自己的 Postgres 数据库,即可按你需要的时长保留。
- 实时看板
在任意 MCP 客户端或通过 REST API 创建实时看板。看板自动更新,每个小部件只读取数据。
- 账单
席位、消费上限和 Stripe 账单门户,以及 AI 模型费用为何从不出现在我们的账单上。
- 团队与角色
owner、admin、member 和 viewer:各角色的权限、如何添加成员,以及变更角色的规则。
- 故障排查
智能体没有响应、PR 无法合并、机器离线。以下检查可解决大部分问题。