Shep 开发编排器
在隔离的 Git worktree 中并行运行编码 Agent,并自动推进功能交付到 PR。
- 源仓库
- shep-ai/shep
- Star 数
- ★ 282
- 最近更新
- 18 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 53/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude CodeOpenAI API(部分支持)
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 需要同时处理多个独立功能的个人开发者,可为每个任务启动一个隔离 worktree,减少分支冲突。
- 不适合
- 需要多人共享一个集中式服务的团队
- 要求合并前无需人工审核的团队
- 官网
- shep.bot ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-02最新版本 v1.253.1(2026-10-31)
- 源码审查
- 53/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
Shep 是一款本地优先的开源开发编排工具,通过 CLI 和 localhost:4050 的网页控制中心管理并行编码任务。每个功能都在独立 Git worktree 和分支中运行,支持 Claude Code、Kimi Code、Codex CLI、Copilot CLI、Cursor CLI、Gemini CLI、Cline,以及多个 API 或本地 HTTP 提供商。默认流程从功能描述开始,依次实现、提交、推送并创建 PR;Shep 还可监视 CI,并在失败时让 Agent 尝试修复。复杂任务可启用基于 YAML 的需求、研究和计划阶段,并在写入代码前设置审批关卡。它运行在开发者本机,数据保存在 ~/.shep/ 的 SQLite 中,最终产物是供人审核的分支和草稿 PR。
运行 shep feat new <description> 后,Shep 为功能创建独立 worktree 和分支,并调用配置的 Agent CLI 或受支持的 API 提供商来实现任务。可选的 spec-driven 流程会生成版本化 YAML 需求、研究和计划,并在各阶段等待批准。完成后,Shep 可提交代码、推送分支、创建草稿 PR、监视 CI,并在 CI 失败时读取日志、尝试修复,默认最多重试 3 次。CLI 提供功能、Agent、仓库和设置管理;网页控制中心展示实时状态、差异审查和交互式聊天,并可一键在 IDE 中打开 worktree。
- 需要同时处理多个独立功能的个人开发者,可为每个任务启动一个隔离 worktree,减少分支冲突。
- 希望从简短需求直接生成草稿 PR 的团队,可让 Shep 自动完成实现、提交、推送和 PR 创建。
- 使用不同编码 Agent 的开发者,可按功能或仓库切换内置 CLI、API 或本地模型提供商。
- 希望先审阅需求和计划再让代码落地的工程团队,可启用 spec-driven 阶段和审批关卡。
- 维护有 CI 的项目的开发者,可让 Shep 监视失败日志并安排 Agent 尝试修复。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npx @shepai/clinpm i -g @shepai/cli
- 运行环境
- Node.js 22+
如何安装或部署这个 Agent?
需要 Node.js 22+、pnpm 10+、Git、GitHub CLI(gh)以及已认证的受支持 Agent CLI;使用 API 提供商时需要相应 API 密钥。可用 npx 试运行,或全局安装 CLI:
npx @shepai/clinpm i -g @shepai/cli如何使用这个 Agent?
在目标 Git 仓库中创建功能,并让 Shep 推送分支和创建 PR:
cd ~/projects/my-app
shep feat new "add a /health endpoint that returns uptime and version" --push --pr打开网页控制中心:
shep start默认地址为 localhost:4050。复杂功能可加 --no-fast 启用完整的 spec-driven 流程;多个 shep feat new 命令可分别启动并行任务。
这个 Agent 有哪些优点和局限?
- 每个功能都使用独立 Git worktree 和分支,避免改动当前工作目录并减少并行任务冲突。
- 可从功能描述自动推进到提交、推送、草稿 PR 和 CI 监视,CI 失败时还支持 Agent 自动尝试修复。
- 内置多种 CLI Agent,以及 OpenRouter、Together AI、Ollama 和兼容 OpenAI 的代理等路径,可按功能切换。
- 复杂任务可以用版本化 YAML 需求、研究和计划以及审批关卡控制代码开始前的流程。
- 需要 Node.js、pnpm、Git 和 GitHub CLI;创建 PR 的流程还依赖已认证的 GitHub CLI。
- 使用编码 Agent 需要预先安装并认证对应 CLI,或提供受支持 API 提供商的密钥;模型或 API 费用由用户承担。
- 默认以非交互方式运行 Agent,并传递权限绕过标志;更严格的权限控制需要单独配置 Agent。
- Shep 本身不是安全扫描器,也不能防护 CI 未发现的漏洞;默认采集使用指标,尽管可关闭。
- 产品按每位开发者本地运行;来源未说明集中式团队服务或共享部署模式。
这个 Agent 与同类方案有什么区别?
README 将 Shep 与直接单独使用编码 Agent 作了对比:Agent 编写代码,Shep 管理 worktree、提交、推送、PR 和 CI 监视。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Shep 开发编排器 当前 | 53 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 282 | 18 天前 | TypeScript | Codex · Claude Code |
| dmux | 55 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.8k | 3 个月前 | HTML | Codex · Claude Code · OpenAI API |
| Open Dynamic Workflows | 69 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 115 | 1 个月前 | TypeScript | Codex · Claude Code |
| Agor | 68 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1.5k | 1 天前 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
README 說明 worktree 隔離、預設 draft PR、合併審批、停止命令與本機日誌;但又明確表示預設以權限繞過旗標非互動執行代理,因此最小權限僅部分成立。推送、建 PR 與自動合併可由旗標或設定啟用,提供審批閘門,但高影響操作的確認細節不充分。README 與 CLAUDE.md 說明遙測目的地、事件類型、停用方式及身份資料為選擇加入;設定資料庫中的 token 為明文,敏感資料保護仍薄弱。SECURITY.md 描述依賴風險治理與 CI 安全閘門,但提供的材料不足以確認依賴鎖定或逐項風險處理。外部效果包括代理執行、推送、PR 與遙測,並有部分控制說明;停止後保留 worktree、git 分支可供恢復,回復能力尚可。作者與 repo 有標示,但 publisher 身份未驗證,不能據此確認維護者身份。
文件描述隔離工作目錄、CI 監看與最多三次自動修復重試,也指出失敗後暫停;這支持一般流程可靠性,但 README、AGENTS.md 與其他材料對 CLI、產品範圍和工作流程的描述不完全一致,且 AGENTS.md 片段不完整。Node、pnpm、Git、GitHub CLI 與代理 CLI 等前置條件有列出,但依賴可用性與替代方案只部分說明。CLI 入口對資料庫初始化錯誤及 SQLite 原生模組錯誤有具體訊息與補救提示;可見錯誤處理尚稱清楚。
材料涵蓋個人、本機、多功能並行、不同代理供應商、既有 repo 與新 app 等情境,也列出快速與規格驅動流程。文件明確說明 Shep 不是安全掃描器、程式碼由所選代理處理,且大型 repo 受代理上下文限制;能力邊界有交代但不完整。技能描述包含部分精確觸發詞,但提供的技能樣本並非產品全部,且部分觸發描述寬泛,故觸發精度有限。安裝指南列出 Node 22、pnpm 10、平台工具與多種代理選項,環境適配說明充足。
README 連結到 CLI、架構、設定、安全、開發與入門文件,資訊架構清楚;入門與設定指南有安裝步驟、命令與示例。產品名稱和概念大致穩定,但材料中出現「Autonomous AI Native SDLC Platform」等不同定位,且 README 的精簡命令表與 CLI 入口命令清單範圍不同。README 有 FAQ,並說明安全能力限制與部分未支援代理。LICENSE 明確提供 MIT 授權及完整條款,給滿分。package.json 有版本號,SECURITY.md 說明僅支援最新版本,AGENTS.md 提及語義化發布規則;提供材料沒有完整變更紀錄。安全政策列出私下通報管道與回應時程,維護責任有部分交代;publisher 未驗證,不加分也不扣分。
CLI、Web UI、worktree、並行代理、CI 修復和 PR 流程能產生可供審閱的分支與草稿 PR,輸出對一般開發工作可用。相對直接使用單一代理,Shep 增加並行協調、持續狀態、重試與整合流程,顯示有實際增值。成本面只部分說明:推理 effort、模型與多代理並行會影響成本與延遲,但材料沒有量化費用或資源消耗,因此成本效益分數保守。
README 對遙測、審批、安全邊界與命令有相應文件連結,package.json 提供版本與腳本,SECURITY.md 列出安全流程,主要主張可追溯至文件。部分主張由 README、安裝指南和設定指南重複支持,但可見版本或命令描述存在差異,且沒有足夠源碼樣本逐項核對,因此跨來源佐證僅部分成立。文件把產品說明、設定事項及限制分開陳述;本評估將明確文件陳述視為證據,未把未提供的檔案推斷為缺失。
- README 表示代理預設以權限繞過旗標執行;使用前應檢視所選代理的實際權限設定,並留意 worktree 隔離不會限制代理在主機上可做的所有事。
- README 說明 token 會以明文存於本機設定資料庫;保護 Shep 資料目錄,避免把 token 放入不受信任的環境。
- 遙測預設啟用;雖然文件列出停用方式與事件範圍,仍應在部署前確認本機設定與組織政策。
- 此靜態評估僅依據提供的文件與程式碼片段,未執行產品或核對未提供的檔案。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
<p align="center"> <a href="https://github.com/shep-ai/shep"> <img src="https://raw.githubusercontent.com/shep-ai/shep/main/docs/screenshots/shep-card.jpg" alt="Shep — run multiple AI agents in parallel" width="720" /> </a> </p> 🚀 Shep [v1.253.1](/compare/v1.253.0...v1.253.1) · _2026-10-31_ > _Routine maintenance pass_ — no new features, just keeping the internals tidy so the next release lands clean. 🐛 Bug Fixes …在 GitHub 查看 ↗ -
发布说明摘录
<p align="center"> <a href="https://github.com/shep-ai/shep"> <img src="https://raw.githubusercontent.com/shep-ai/shep/main/docs/screenshots/shep-card.jpg" alt="Shep — run multiple AI agents in parallel" width="720" /> </a> </p> 🚀 Shep [v1.253.0](/compare/v1.252.2...v1.253.0) · _2026-10-30_ > _No user-facing changes_ — purely internal upkeep to keep the codebase tidy under the hood. ✨ Features …在 GitHub 查看 ↗ -
发布说明摘录
<p align="center"> <a href="https://github.com/shep-ai/shep"> <img src="https://raw.githubusercontent.com/shep-ai/shep/main/docs/screenshots/shep-card.jpg" alt="Shep — run multiple AI agents in parallel" width="720" /> </a> </p> 🚀 Shep [v1.252.2](/compare/v1.252.1...v1.252.2) · _2026-10-29_ > All 40 open Dependabot alerts _cleared in one sweep_ — Next 16.4, TypeSpec 1.17 and patched transitive deps. 🐛 Bug Fixes …在 GitHub 查看 ↗
常见问题
Shep 会把我的代码发送到哪里?
Agent 写出有问题的代码时会怎样?
Shep 会自动合并 PR 吗?
--allow-merge 才允许 CI 通过后自动合并。Shep 适合多人共享一个服务吗?
Shep 开发编排器 官网是什么?
Shep 开发编排器 免费吗?
Shep 开发编排器 开源吗?
Shep 开发编排器 安全吗?
Shep 开发编排器 还在维护吗?
Shep 开发编排器 是谁开发的?
谢谢反馈,我们会据此改进页面。