pr-watcher
PR 轮询守护 SubAgent。持续监控 GitHub 上的 Open PR,自动调用 pr-handler 逐一处理,连续 N 轮无新可处理 PR 后退出。触发方式:用户提及 "/watch-prs"、"轮询 PR"、"watch prs" 等关键词时激活。
- License 许可
- MIT
- 最近更新
- 2026-03-03
- Stars
- ★ 1
- Forks
- 1
01 前言 Front Matter
- name
- pr-watcher
- license
- MIT
- description
- PR 轮询守护 SubAgent。持续监控 GitHub 上的 Open PR,自动调用 pr-handler 逐一处理,连续 N 轮无新可处理 PR 后退出。触发方式:用户提及 "/watch-prs"、"轮询 PR"、"watch prs" 等关键词时激活。
- dependencies
- [ { "path": ".agents/skills/pr-handler", "skill": "pr-handler", "usage": "单个 PR 的验证-合并-交付流水线" } ]
- allowed-tools
- Shell, Read, Write, Glob, Grep, SemanticSearch, Task
02 资源文件 2
- 参考文档commands/claude.md1.0 KB
- 参考文档commands/cursor.md1.0 KB
03 SKILL.md 正文
PR Watcher SubAgent
角色定义
你是项目的 PR Watcher。持续轮询 GitHub 上的 Open PR,发现新 PR 后调用 pr-handler 逐一处理。
核心约束
- 循环守护:每轮间隔 1 分钟轮询
- 智能跳过:记录已处理 PR,同一 PR 不重复处理(除非检测到新 push)
- 退出条件:连续 N 轮(默认 60)无新可处理 PR 后自动退出
- 继承安全规则:所有 pr-handler 的安全约束同样适用
指令参数
| 参数 | 说明 | 默认值 |
|---|---|---|
--max-idle <N> |
连续无新 PR 的最大轮次 | 60 |
--interval <seconds> |
轮询间隔(秒) | 60 |
--include <numbers> |
仅处理指定编号的 PR | 全部 |
--exclude <numbers> |
排除指定编号的 PR | 无 |
--retry-failed |
对有新 push 的失败 PR 重新验证 | false |
运行流程
while idleCount < maxIdle:
prs = gh pr list --state open
newPRs = filter(prs, not processed, not excluded)
if newPRs is empty:
idleCount++; sleep(interval); continue
idleCount = 0
for pr in newPRs:
执行 pr-handler 五阶段流程
记录结果(成功/失败)
输出 Session Summary
安全规则
继承 pr-handler 全部安全规则。轮询循环必须有 maxIdle 退出条件。
04 同仓库更多 Skills
qa-monitor
QA 持续监测 SubAgent。监听 git HEAD 变化,每有新 ship(commit)自动触发完整回归测试,无变化时进入可配置间隔的休眠轮询。触发方式:用户提及 "/qa-watch"、"QA 监测"、"continuous QA"、"watch ship" 等关键词时激活。
qa-engineer
QA 测试工程师 SubAgent。模拟真实用户通过 CLI/REST API 与 AgentDispatch 交互,智能判断输出和产物是否合理,黑盒为主白盒为辅,发现问题自动创建 Issue。触发方式:用户提及 "/qa"、"QA run"、"QA test"、"运行测试场景" 等关键词时激活。
pr-handler
PR Gatekeeper SubAgent。自动化处理 Multi-Agent Pipeline 产出的 Draft PR:验证代码质量 → 本地合并 → 更新 Spec → Ship 交付。触发方式:用户提及 "/handle-pr"、"处理 PR"、"review pr"、"合并 PR" 等关键词时激活。
issue-manager
GitHub-first Issue 管理 SubAgent。Issue 编号和内容以 GitHub Issues 为准,本地 .trellis/issues/ 为 Obsidian 兼容缓存。触发方式:用户提及 "/issue"、"创建 issue"、"create issue"、"新建问题"、"提 bug" 等关键词时激活。
git-commit
Execute git commit with conventional commit message analysis, intelligent staging, and message generation. Use when user asks to commit changes, create a git commit, or mentions "/commit". Supports: (1) Auto-detecting type and scope from changes, (2) Generating conventional commit messages from diff, (3) Interactive commit with optional type/scope/description overrides, (4) Intelligent file staging for logical grouping
agent-dispatch-use
AgentDispatch 使用指南。教导 AI Agent 如何启动 Server、配置 Client Node、将各种 Agent 作为 Worker 挂载到分发集群、提交任务并监听状态。触发方式:用户提及 "/onboard"、"how to use dispatch"、"快速上手"、"set up agentdispatch"、"挂载 Agent"、"mount worker" 等关键词时激活。