【免费下载链接】skillsSkills for Kotlin, Jetpack Compose, and Android development项目地址https://gitcode.com/gh_mirrors/skills33/skills点击查看免费下载Skills 项目的 shepherd 技能是一位专为合并请求PR/MR打造的AI 守护神自动轮询仓库状态、分诊评审评论、修复 CI 失败并批量推送全程以证据驱动、绝不越权合并。下面用新手友好的方式讲清它的工作方式、安全边界与快速上手方法。什么是 shepherdPR/MR 的自动守护神提过 PR 的开发者都熟悉这种煎熬提了合并请求之后要时刻盯着 CI 是否跑绿、评审人有没有新评论、自己修完推送后还要再等一轮验证……shepherd牧羊人就是为了解决这个问题而生的工作流技能。它接管盯着 PR这件事核心原则只有一句话用证据而非噪音推动一个已授权的 PR/MR轮询新变化 → 处理可行动项 → 本地修复批量合并成一次推送 → 解决已处理的讨论线程。它会自动完成这些保姆工作轮询通过ghGitHub或glabGitLab定期检查 PR/MR 状态分诊区分新评论和旧评论只处理真正的新增反馈修复格式、lint、编译、测试等小问题直接修架构类争议立即上报验证修复时跑受影响检查合并前跑必要的全量检查CI 只作最终确认守边界没有明确的合并授权绝不 merge完整流程定义在 skills/shepherd/SKILL.md项目总览见 README.md。它如何工作8 步守护流程shepherd 的流程设计得非常克制按顺序执行 8 步摘自 SKILL.md步骤做什么关键点1识别平台用git remote get-url origin判断用gh还是glab模糊就停下来问2建立目标与快照记录已处理的评论/评审 ID快照之外的才算新反馈3启用只读助手有子代理时派一个只读证据收集员自己保留所有写操作4轮询比对完整对比评论与 CI 状态不重复处理旧反馈、不发仅状态更新5先分诊后动手清晰的问题直接修架构/矛盾类反馈升级给人类6批量修复一次推每个目标独立 checkout已知问题攒成一次推送不逐条评论逐条推7推送后复核 CI稳定期 2–5 分钟轮询活跃修复期 30–60 秒卡住则降频8合并门禁需求、CI、冲突三项全绿且用户明确授权才合并两个细节特别值得新手学习快照机制每轮轮询后记录反馈 ID 和 CI 状态因此重启会话也不会漏掉或重复处理已有评论。CI 定位正确CI 是确认而不是迭代测试器——本地验证先行CI 兜底避免把 CI 当试错沙箱。GitHub 与 GitLab 通用内置各平台命令shepherd 内置了两大平台的只读检查命令详见 provider-commands.md平台查看反馈查看检查与日志GitHubgh pr view number --json comments,reviews,...gh pr checks numbergh run view run-id --log-failedGitLabglab mr view iid --commentsglab ci list --mr iidglab ci trace job-idGitLab 还有一个贴心的小规则疑似偶发flaky的 job 允许用glab ci retry job-id重试一次第二次失败就如实报告不无限重试。免轮询新姿势宿主监控模式如果你的客户端本身会在 PR 事件发生时唤醒AI 会话例如 Claude 桌面版的ccd_pr工具shepherd 会自动切换到事件驱动模式不再自己开定时器或循环轮询每次被唤醒时只完整读一次评审线程、检查状态、失败日志推送修复后报告 SHA把等 CI交给宿主监控结束时明确声明哪些事件不在监控范围内这套行为有专门的评估用例校准见 evals/cases/shepherd-host-monitor-direct/case.json。安全边界守护神绝不越权这是 shepherd 最让人放心的一面——它把守边界写进了规范⚠️绝不从批准推断合并授权合并必须有用户的明确或长期授权⚠️ 一次性查看、无开放目标、或需要人类判断时报告状态然后停止不启动持久轮询⚠️ 修复三轮仍未解决的失败、评审方向矛盾、冲突无法解决时立即升级给人类⚠️ 报告必须诚实实际跑了哪些检查就说哪些没跑就明说none负向用例 shepherd-negative 就模拟了CI 全绿但没给合并授权的场景——正确行为是什么都不做这个克制正是它和简单脚本的本质区别。快速上手三步开始使用1. 安装 Skills 插件包任选其一# skills CLI npx skills add chrisbanes/skills # 或作为 Claude Code 插件 /plugin marketplace add chrisbanes/skills /plugin install chrisbanes-skillschrisbanes-skills # 或作为 Codex 插件 codex plugin marketplace add chrisbanes/skills --ref main codex plugin add chrisbanes-skillschrisbanes-skills2. 在 PR 所在仓库中唤起直接用自然语言例如帮我盯一下这个 PR处理评审评论和 CI 失败。该技能默认不自动触发见 skills/shepherd/agents/openai.yaml需要你明确调用——这又是一道安全设计。3. 看它汇报每轮结束它会报告目标、当前 CI/评审状态、已执行的动作、实际运行的检查以及下一个需要人类做的决定。延伸阅读与配套资料想深入源码级了解推荐按此顺序阅读 skills/shepherd/SKILL.md — 完整 8 步流程与升级条件 references/provider-commands.md — GitHub/GitLab 命令速查与宿主监控规则 references/behavioral-review.md — 行为评审与两轮收敛审计 references/subagent-selection.md — 只读子代理的选型与交接简报 evals/cases/shepherd-direct/case.json — CI 失败后规划本地验证 的评估用例shepherd 在官方评估套件中的得分高达100%见 README.md 中的结果表是目前仓库里最稳的工作流技能之一。如果你正在为 PR 合并流程里的琐碎盯梢工作头疼这位 AI 牧羊人值得放进你的工具箱 ✨赞分享【免费下载链接】skillsSkills for Kotlin, Jetpack Compose, and Android development项目地址https://gitcode.com/gh_mirrors/skills33/skills点击查看免费下载相关推荐tldraw 仓库 PR 维护自动化用 shepherd-pr 技能自主评审 PR 评论、修复构建失败与清理线程tldraw 仓库 PR 维护自动化用 shepherd pr 技能自主评审 PR 评论、修复构建失败与清理线程 本篇技术指南围绕 tldraw 开源仓库m前端UI组件OpenWorker 实战指南用 security-fix-pr 技能把分诊后的安全发现打包成可评审的修复 PROpenWorker 实战指南用 security fix pr 技能把分诊后的安全发现打包成可评审的修复 PR 导读 本文围绕 OpenWorker 内置人工智能AI AgentAI 应用MCP Clients安全DeerFlow Maintainer Orchestrator:基于“评论面”安全模型的 GitHub Issue/PR 分诊与评审 Agent 技能DeerFlow Maintainer Orchestrator:基于“评论面”安全模型的 GitHub Issue/PR 分诊与评审 Agent 技能 本文基人工智能大模型AI Agent自主智能体工具调用MCP 服务Agent 沙箱AI 技能后端前端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考