30分钟让你的GitHub仓库跑起来Babysitter AI编排流水线:action.yml配置实战指南
【免费下载链接】babysitterBabysitter enforces obedience on agentic workforces and enables them to manage extremely complex tasks and workflows through deterministic, hallucination-free self-orchestration项目地址: https://gitcode.com/GitHub_Trending/ba/babysitter
想在 30 分钟内让 GitHub 仓库自动跑起Babysitter AI 编排流水线?本文带你一步步完成action.yml 配置实战:Babysitter 通过确定性、无幻觉的自编排机制"管住"AI 工作流——每个步骤强制执行、质量门禁通过才能推进、关键节点需人工批准、所有决策写入不可篡改日志。作为 Harness 无关的 GitHub Action,它一个接口即可切换 pi、claude-code、codex、gemini-cli 等多种 AI 工具,让你无需改工作流结构就更换 AI 引擎。
🚀 为什么选 Babysitter 做 CI 编排?
| 痛点 | Babysitter 的解法 |
|---|---|
| AI 输出不确定、会"胡编" | 确定性自编排,过程用代码定义,每一步强制执行 |
| 质量全靠自觉 | 硬编码质量门禁(确定性检查,结果不可协商) |
| 换 AI 工具要重写流水线 | Harness 无关:改一个harness输入即可切换 |
| 过程不透明 | 每个决策记入不可变日志(journal),运行产物自动归档 |
它和厂商官方 Action 的最大区别:厂商 Action 锁死一家模型,Babysitter Action 一个配置管所有 harness,适合想"模型可替换、流程可审计"的团队。
📋 30分钟接入清单
- ✅ 在仓库 Settings → Secrets 中配置一个模型供应商的 API Key(约 5 分钟)
- ✅ 在工作流中引用 Babysitter Action 并填入
prompt(约 10 分钟) - ✅ 触发一次运行,下载
babysitter-runs产物查看编排日志(约 5 分钟) - ✅ 按需调整
max-iterations、timeout-minutes等参数(约 10 分钟)
第一步:action.yml 最小可用配置实战
Action 内部已自动完成 Node.js 22 环境搭建和 Agent Runtime 构建(见 action.yml 中的Build Babysitter Agent Runtime步骤),你只需在仓库的.github/workflows/下新建一个工作流:
name: Babysitter on: workflow_dispatch: jobs: babysitter: runs-on: ubuntu-latest timeout-minutes: 30 permissions: contents: write pull-requests: write issues: write steps: - uses: actions/checkout@v4 with: fetch-depth: 1 - uses: a5c-ai/babysitter@main with: prompt: '审查仓库代码质量与安全问题,修复发现的问题并提交 PR' model: anthropic:claude-sonnet-4-20250514 anthropic-api-key: ${{ secrets.ANTHROPIC_API_KEY }}💡 需要本地体验完整仓库时,可克隆:
git clone https://gitcode.com/GitHub_Trending/ba/babysitter(仓库为只读,请勿修改)。
核心输入参数速查
| 输入 | 默认值 | 说明 |
|---|---|---|
prompt | — | 任务提示词,支持 GitHub 上下文变量 |
harness | internal | AI 引擎:internal / pi / claude-code / codex / gemini-cli |
model | — | 格式为provider:modelId,决定需要哪个 API Key |
process-path | — | 指定已有流程定义文件(JS),跳过 Phase 1 访谈阶段 |
max-iterations | 256 | 最大编排迭代次数 |
timeout-minutes | 30 | 超时建议值,请设置到 job 级别 |
verbose | false | 开启调试输出 |
第二步:API Key 与模型选择
模型采用provider:modelId格式,只需提供匹配供应商的那一个 Key:
| 供应商 | Action 输入 | 示例模型 |
|---|---|---|
| Anthropic | anthropic-api-key | anthropic:claude-sonnet-4-20250514 |
| OpenAI | openai-api-key | openai:gpt-4.1、openai:o4-mini |
| Google Gemini | gemini-api-key | 裸模型名自动从已有凭据推断 |
| Azure OpenAI | azure-openai-api-key+ 项目/部署名 | azure-openai-responses:gpt-4.1 |
切换 harness 只需改一行输入,例如用 Codex:
- uses: a5c-ai/babysitter@main with: prompt: '实现并测试该功能' harness: codex model: openai:o4-mini openai-api-key: ${{ secrets.OPENAI_API_KEY }}第三步:四种高频触发场景
prompt支持 GitHub 上下文变量(github.repository、github.event.issue.number等),下面是官方推荐的典型玩法(完整示例见 docs/github-actions-setup-babysitter.md):
| 场景 | 触发事件 | 关键配置 |
|---|---|---|
| @提及即开工 | issue 评论含@babysitter | 用if:过滤评论内容,prompt 直接取评论 |
| PR 自动审查 | pull_request打开/更新 | prompt 带入 PR 编号,审查质量与安全 |
| 标签触发 TDD 开发 | issue 打上feature-request标签 | timeout-minutes: 60+max-iterations: 50 |
| 定时安全扫描 | schedule每周一 0 点 | 需要security-events: write权限 |
第四步:读取输出与运行产物
Action 暴露 4 个输出,方便后续步骤做断言或通知:
- uses: a5c-ai/babysitter@main id: babysitter # ... - name: Check results run: | echo "Run ID: ${{ steps.babysitter.outputs.run-id }}" echo "Status: ${{ steps.babysitter.outputs.status }}" echo "Iterations: ${{ steps.babysitter.outputs.iterations }}"| 输出 | 含义 |
|---|---|
run-id | 本次编排运行 ID |
run-dir | 运行状态目录路径 |
status | completed/failed/timeout |
iterations | 实际执行的编排迭代数 |
Action 还会自动把 journal(编排日志)、任务结果、blobs 打包为babysitter-runs产物(默认保留 7 天),运行失败也能下载排查——这正是"每个决策可审计"的落地。编排引擎的构建入口位于 packages/genty/platform/,质量门禁组件可参考 deterministic-quality-gate.js。
⚠️ 排错指南:4个高频问题
| 症状 | 最快解决方案 |
|---|---|
| Runtime 构建失败 | 确认 Action 内actions/setup-node@v4使用 Node 22 |
| 认证报错 | 核对 Key 与 harness 匹配:internal+Anthropic 模型 →ANTHROPIC_API_KEY;codex →OPENAI_API_KEY |
| 运行超时 | 调低max-iterations(如 50)、调大 job 级timeout-minutes、任务拆小 |
| 无输出/结果异常 | 开启verbose: 'true'看调试日志 |
📚 延伸资料
- 完整 Action 定义:action.yml
- GitHub Action 官方使用指南(含 8 个场景模板):docs/github-actions-setup-babysitter.md
- Harness 无关架构说明:docs/user-guide/features/adapters.md
- 仓库总览与快速上手:README.md
按上面四步走下来,你的仓库就会拥有一条模型可替换、流程可审计、质量有门禁的 AI 编排流水线——把重复的开发工作交给 Babysitter,你只负责批准关键决策。
【免费下载链接】babysitterBabysitter enforces obedience on agentic workforces and enables them to manage extremely complex tasks and workflows through deterministic, hallucination-free self-orchestration项目地址: https://gitcode.com/GitHub_Trending/ba/babysitter
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考