shep
一个用于并行运行多个AI编码代理的开源编排器,实现从需求到PR的自动化开发流程。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:shep。 它的用途是:一个用于并行运行多个AI编码代理的开源编排器,实现从需求到PR的自动化开发流程。 完整的 Skill 内容见:https://321skill.com/skills/shep/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“为我的项目添加一个健康检查端点”,Shep会创建一个新的Git工作树,启动你配置的AI代理(如Claude Code)在该隔离环境中实现功能,完成后自动提交代码、推送到远程仓库并创建一个待合并的Pull Request。你可以在本地控制面板实时监控所有并行任务的状态。
介绍
Shep 是一个开源的、本地优先的AI代理编排器,旨在解决多代理并行开发时的混乱问题。它允许开发者在同一个项目中,同时运行多个AI编码代理(如Claude Code、Cursor CLI等),每个代理都在自己独立的Git工作树中工作,从而避免分支冲突,实现从一行功能描述到代码提交、推送、CI监控、自动修复直至创建PR的全流程自动化。
使用Shep非常简单。通过命令行工具,你可以快速启动一个本地控制面板,并使用类似 shep feat new "添加功能描述" --push --pr 的命令来创建新功能分支并启动代理。整个过程无需触碰你的主工作目录,所有开发都在隔离的环境中进行。
它非常适合需要同时推进多个功能或修复的开发团队、全栈工程师以及智能体开发者。当你需要高效并行处理多个开发任务,但又担心手动管理分支和代理状态会带来混乱时,Shep就是理想的解决方案。
建议在使用前确保已安装Node.js 22+、Git、GitHub CLI以及至少一个已认证的AI代理CLI。对于复杂功能,可以使用 --no-fast 参数启用完整的规范驱动流程,在编码前生成需求、研究和计划文档供你审批。
核心特点
Shep的核心区别在于其“代理无关”和“本地优先”的并行编排能力。它不绑定特定AI模型,能同时管理多个不同代理在独立Git工作树中并行工作,并通过自动化流程将功能从想法直接推进到PR,有效解决了多代理协同开发时的状态管理和冲突问题。
注意事项
不适合仅需单次、简单代码片段生成或不愿配置Git、GitHub CLI及AI代理CLI环境的场景。
常见问题
Shep支持哪些AI代理?
内置支持Claude Code、Cursor CLI、Gemini CLI,同时支持任何能在终端运行的通用代理CLI。
使用Shep会影响我本地的代码吗?
不会。Shep使用Git工作树,每个功能都在完全独立的分支和目录中开发,你的主工作区保持不变。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/shep/raw/index.md 读取 shep 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/shep/raw/index.md(查看排版版本)