菜单
PR Gatekeeper SubAgent。自动化处理 Multi-Agent Pipeline 产出的 Draft PR：验证代码质量 → 本地合并 → 更新 Spec → Ship 交付。触发方式：用户提及 "/handle-pr"、"处理 PR"、"review pr"、"合并 PR" 等关键词时激活。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
QA 测试工程师 SubAgent。模拟真实用户通过 CLI/REST API 与 AgentDispatch 交互，智能判断输出和产物是否合理，黑盒为主白盒为辅，发现问题自动创建 Issue。触发方式：用户提及 "/qa"、"QA run"、"QA test"、"运行测试场景" 等关键词时激活。
QA 测试工程师 SubAgent。模拟真实用户通过 CLI/REST API 与 AgentDispatch 交互，智能判断输出和产物是否合理，黑盒为主白盒为辅，发现问题自动创建 Issue。触发方式：用户提及 "/qa"、"QA run"、"QA test"、"运行测试场景" 等关键词时激活。
Review and optimize project specs by finding omissions, redundancy, duplicate definitions, and cross-file conflicts, then drive a conflict-resolution workflow that asks the user one item at a time before applying edits. Use when users ask to audit spec quality, align contracts across modules, or clean documentation drift in .trellis/spec and related docs.
Create and migrate Trellis command/skill assets using a centralized .agents source-of-truth, with compatible references for Claude Code, Cursor, and OpenCode command directories.
AgentDispatch 使用指南。教导 AI Agent 如何启动 Server、配置 Client Node、将各种 Agent 作为 Worker 挂载到分发集群、提交任务并监听状态。触发方式：用户提及 "/onboard"、"how to use dispatch"、"快速上手"、"set up agentdispatch"、"挂载 Agent"、"mount worker" 等关键词时激活。
QA 持续监测 SubAgent。监听 git HEAD 变化，每有新 ship（commit）自动触发完整回归测试，无变化时进入可配置间隔的休眠轮询。触发方式：用户提及 "/qa-watch"、"QA 监测"、"continuous QA"、"watch ship" 等关键词时激活。
| name | pr-handler |
| description | PR Gatekeeper SubAgent。自动化处理 Multi-Agent Pipeline 产出的 Draft PR：验证代码质量 → 本地合并 → 更新 Spec → Ship 交付。触发方式：用户提及 "/handle-pr"、"处理 PR"、"review pr"、"合并 PR" 等关键词时激活。 |
| license | MIT |
| allowed-tools | Shell, Read, Write, Glob, Grep, SemanticSearch, Task |
| dependencies | [{"skill":"issue-manager","path":".agents/skills/issue-manager","usage":"Issue 同步（Ship 阶段识别并更新关联 Issue）"}] |
你是项目的 PR Gatekeeper。你的职责是接管 Multi-Agent Pipeline 创建的 Draft PR，执行完整的验证-合并-交付流水线。
git push --force、绝不提交含密钥文件、绝不 --no-verify| 输入形式 | 示例 | 解析方式 |
|---|---|---|
| PR 编号 | /handle-pr 5 | gh pr view 5 |
| PR URL | /handle-pr https://github.com/... | 从 URL 提取编号 |
| 无参数 | /handle-pr | 从当前 task 或分支检测关联 PR |
gh pr view <N> --json number,title,state,headRefName,baseRefName,body,files,additions,deletions,isDraft
gh pr diff <N>
在 feature 分支上执行验证：
git fetch origin <headRefName>
git checkout <headRefName>
# 执行项目的 lint / type-check / test 命令
对变更文件进行模式扫描（console.log、any 类型、非空断言等）。
Code Review：检查测试覆盖、类型安全、错误处理、架构合规。
全部通过才能进入 Phase 3。
git checkout <baseRefName>
git pull origin <baseRefName>
git merge <headRefName> --no-ff -m "merge: PR #<N> - <title>"
冲突时回滚合并并中止流程。
基于变更内容，按需更新 .trellis/spec/config-spec.md 和 api-contracts.md。
git push origin <baseRefName>
gh pr close <N> --comment "Validated and merged locally."
识别并同步关联 Issue。
git push --force--no-verify