Shep 开发编排器

在隔离的 Git worktree 中并行运行编码 Agent,并自动推进功能交付到 PR。

源仓库
shep-ai/shep
Star 数
★ 282
最近更新
18 天前
License
MIT
主语言
TypeScript

30 秒速览

运行形态
命令行工具网页应用
可在哪里用
通用 · 跨平台Codex · Claude CodeOpenAI API(部分支持)
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
Node.js 22+pnpm 10+GitGitHub CLI (gh)已认证的 Agent CLI,或受支持提供商的 API 密钥Shell / 命令行网络访问本地文件系统
典型场景
需要同时处理多个独立功能的个人开发者,可为每个任务启动一个隔离 worktree,减少分支冲突。
不适合
  • 需要多人共享一个集中式服务的团队
  • 要求合并前无需人工审核的团队
官网
shep.bot ↗ 来自 GitHub 仓库设置
维护状态
近 30 天有提交最近提交 2026-11-02最新版本 v1.253.1(2026-10-31)

这个 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。

  1. 需要同时处理多个独立功能的个人开发者,可为每个任务启动一个隔离 worktree,减少分支冲突。
  2. 希望从简短需求直接生成草稿 PR 的团队,可让 Shep 自动完成实现、提交、推送和 PR 创建。
  3. 使用不同编码 Agent 的开发者,可按功能或仓库切换内置 CLI、API 或本地模型提供商。
  4. 希望先审阅需求和计划再让代码落地的工程团队,可启用 spec-driven 阶段和审批关卡。
  5. 维护有 CI 的项目的开发者,可让 Shep 监视失败日志并安排 Agent 尝试修复。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • npx @shepai/cli
  • npm 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/cli
npm 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?

FollowAgents 源码审查 · FARS-2.1
缺口较多
53/ 100 五分制 2.7 / 5
信任安全 14/29
可靠稳定 6/14
适用触发 10/18
规范维护 12/18
有效结果 7/13
证据核验 4/8
查看各维度的扣分理由
信任安全14 / 29 · 2.4/5

README 說明 worktree 隔離、預設 draft PR、合併審批、停止命令與本機日誌;但又明確表示預設以權限繞過旗標非互動執行代理,因此最小權限僅部分成立。推送、建 PR 與自動合併可由旗標或設定啟用,提供審批閘門,但高影響操作的確認細節不充分。README 與 CLAUDE.md 說明遙測目的地、事件類型、停用方式及身份資料為選擇加入;設定資料庫中的 token 為明文,敏感資料保護仍薄弱。SECURITY.md 描述依賴風險治理與 CI 安全閘門,但提供的材料不足以確認依賴鎖定或逐項風險處理。外部效果包括代理執行、推送、PR 與遙測,並有部分控制說明;停止後保留 worktree、git 分支可供恢復,回復能力尚可。作者與 repo 有標示,但 publisher 身份未驗證,不能據此確認維護者身份。

可靠稳定6 / 14 · 2.1/5

文件描述隔離工作目錄、CI 監看與最多三次自動修復重試,也指出失敗後暫停;這支持一般流程可靠性,但 README、AGENTS.md 與其他材料對 CLI、產品範圍和工作流程的描述不完全一致,且 AGENTS.md 片段不完整。Node、pnpm、Git、GitHub CLI 與代理 CLI 等前置條件有列出,但依賴可用性與替代方案只部分說明。CLI 入口對資料庫初始化錯誤及 SQLite 原生模組錯誤有具體訊息與補救提示;可見錯誤處理尚稱清楚。

适用触发10 / 18 · 2.8/5

材料涵蓋個人、本機、多功能並行、不同代理供應商、既有 repo 與新 app 等情境,也列出快速與規格驅動流程。文件明確說明 Shep 不是安全掃描器、程式碼由所選代理處理,且大型 repo 受代理上下文限制;能力邊界有交代但不完整。技能描述包含部分精確觸發詞,但提供的技能樣本並非產品全部,且部分觸發描述寬泛,故觸發精度有限。安裝指南列出 Node 22、pnpm 10、平台工具與多種代理選項,環境適配說明充足。

规范维护12 / 18 · 3.3/5

README 連結到 CLI、架構、設定、安全、開發與入門文件,資訊架構清楚;入門與設定指南有安裝步驟、命令與示例。產品名稱和概念大致穩定,但材料中出現「Autonomous AI Native SDLC Platform」等不同定位,且 README 的精簡命令表與 CLI 入口命令清單範圍不同。README 有 FAQ,並說明安全能力限制與部分未支援代理。LICENSE 明確提供 MIT 授權及完整條款,給滿分。package.json 有版本號,SECURITY.md 說明僅支援最新版本,AGENTS.md 提及語義化發布規則;提供材料沒有完整變更紀錄。安全政策列出私下通報管道與回應時程,維護責任有部分交代;publisher 未驗證,不加分也不扣分。

有效结果7 / 13 · 2.7/5

CLI、Web UI、worktree、並行代理、CI 修復和 PR 流程能產生可供審閱的分支與草稿 PR,輸出對一般開發工作可用。相對直接使用單一代理,Shep 增加並行協調、持續狀態、重試與整合流程,顯示有實際增值。成本面只部分說明:推理 effort、模型與多代理並行會影響成本與延遲,但材料沒有量化費用或資源消耗,因此成本效益分數保守。

证据核验4 / 8 · 2.5/5

README 對遙測、審批、安全邊界與命令有相應文件連結,package.json 提供版本與腳本,SECURITY.md 列出安全流程,主要主張可追溯至文件。部分主張由 README、安裝指南和設定指南重複支持,但可見版本或命令描述存在差異,且沒有足夠源碼樣本逐項核對,因此跨來源佐證僅部分成立。文件把產品說明、設定事項及限制分開陳述;本評估將明確文件陳述視為證據,未把未提供的檔案推斷為缺失。

风险与缓解建议
  • README 表示代理預設以權限繞過旗標執行;使用前應檢視所選代理的實際權限設定,並留意 worktree 隔離不會限制代理在主機上可做的所有事。
  • README 說明 token 會以明文存於本機設定資料庫;保護 Shep 資料目錄,避免把 token 放入不受信任的環境。
  • 遙測預設啟用;雖然文件列出停用方式與事件範圍,仍應在部署前確認本機設定與組織政策。
  • 此靜態評估僅依據提供的文件與程式碼片段,未執行產品或核對未提供的檔案。
证据充分度:低 评估于 2026年11月13日 审查版本 56301d59a0d5
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/shep.svg?lang=zh)](https://followagents.com/zh/agents/shep)
<a href="https://followagents.com/zh/agents/shep"><img src="https://followagents.com/badge/shep.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v1.253.1
    发布说明摘录
    <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 查看 ↗
  2. v1.253.0
    发布说明摘录
    <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 查看 ↗
  3. v1.252.2
    发布说明摘录
    <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 会把我的代码发送到哪里?
README 称 Shep 将数据保存在本地;代码只会发送给你配置的 Agent,并受该 Agent 自身隐私条款约束。
Agent 写出有问题的代码时会怎样?
Shep 创建草稿 PR 并运行项目 CI。CI 失败时,Agent 可读取日志并尝试修复,默认最多重试 3 次;之后会暂停并通知你。
Shep 会自动合并 PR 吗?
默认不会。只有明确启用 --allow-merge 才允许 CI 通过后自动合并。
Shep 适合多人共享一个服务吗?
README 描述的是每位开发者本地运行。功能以分支和 PR 交付,沿用现有代码审查流程。
Shep 开发编排器 官网是什么?
Shep 开发编排器 的 GitHub 仓库填写的官网是 https://shep.bot。这个链接由仓库作者设置;源码在 GitHub(shep-ai/shep)。
Shep 开发编排器 免费吗?
软件本身免费,但 Shep 开发编排器 要调用 AI 模型,模型的调用费用由你向模型服务商支付(也可以接本地模型)。
Shep 开发编排器 开源吗?
开源。源码在 GitHub(shep-ai/shep),许可证是 MIT。
Shep 开发编排器 安全吗?
FollowAgents 的 FARS 评审(2026年11月13日)给 Shep 开发编排器 的“信任与安全”打了 14/29 分。评审检查的 8 项安全措施没有完全缺失的。
Shep 开发编排器 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-02,在最近 30 天内。最新版本是 v1.253.1(2026-10-31)。
Shep 开发编排器 是谁开发的?
Shep 开发编排器 由 GitHub 账号 shep-ai 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念