文档 / 总览
文档
装上 GitHub App,写好你的 maintainer.yml 策略,然后了解这支团队怎么分流、怎么交接、怎么交付。每一个动作都有审计。
# yaml-language-server: $schema=https://developerz.ai/schemas/maintainer.v1.json
version: 1- 快速上手
装上 GitHub App,加一个 .dz/maintainer/maintainer.yml,然后看第一条循环跑起来。
- maintainer.yml 参考
每一个策略字段,都配了示例。这个文件划定了 agent 能做什么。
- MCP 动词参考
全部 MCP 工具(用户级和运维级),含所需权限和对应动作。
- MCP 客户端接入
签发一个个人访问令牌,把 Claude Code、Cursor 或 tesote.ai 指向 mcp.developerz.ai,然后派出你的第一个任务。
- GitHub Copilot
通过 webhook 把修复交给 Copilot。agent 开出 PR;接下来怎么走由你的策略决定。
- Claude Code
在已分流的 issue 上触发 Claude Code。完整审计记录,每一次工具调用都有日志。
- OpenHands
把任务路由给 OpenHands 做自主编码。BYOK:你的密钥,你的账单。
- AI 代码审查
兼容 CodeRabbit、跑在你自己模型上的 AI 审查。把 .coderabbit.yaml 放进来,或者用原生的 review: 块。
- 从 CodeRabbit 迁移
把代码审查搬到你自己的密钥上,不用重写配置:你的 .coderabbit.yaml 照常生效。
- 自托管 CI
用你自己的 VPS 替掉 GitHub 托管的 runner。改一个标签即可:runs-on: [self-hosted, linux, developerz]。
- 自带机器
把一台虚拟机接进你的团队:前置要求、加入命令、加固方式,以及有什么东西永远不会碰到这台机器。
- 产物存储
agent 把文件存进你自己的 S3 桶,或者平台的桶。预签名 URL,按策略设置过期时间。
- 自带日志存储与保留期
原始的 CI / 审查 / 运行日志保留 72 小时。把你自己的 Postgres 指向平台,保留期由你定。
- 实时看板
用 JSON 定义的看板,通过 SSE 实时推送。可以从 Claude Code 或 Claude Desktop 里定义。
- REST API
以编程方式访问你的仓库、任务、runner、账单和审计日志。
- 出站 webhook
带签名投递到你的端点:信封结构、签名、重试,以及今天实际会触发哪些事件。
- 速率限制
每个令牌的读写额度、鉴权前的按 IP 桶,以及一个 429 到底长什么样。
- 升级机制
agent 什么时候会叫人:安全、破坏性变更,以及卡住的讨论线。
- BYOK
带你自己的模型密钥。我们负责编排;推理账单归你自己。
- 账单
席位、权益、消费上限和 Stripe 门户,以及为什么推理费用永远不会出现在我们的账单上。
- 团队与角色
owner、admin、member 和 viewer:各自能做什么、成员资格怎么授予,以及最后一个 owner 的规则。
- 安全
最小权限的 GitHub 授权范围、加密存储的密钥,以及只增不改的审计日志。
- 排查
agent 不说话了、PR 合不进去、机器离线了。这些检查能解决大部分上报。
- 术语表
AI 开发者、机器、席位、通道、交接、判定。这份文档用到的词,在这里定义一次。