unblock-pr-datadog-labs-agent-skills

1. 基本信息

项目	内容
名称	unblock-pr（datadog-labs/agent-skills 合集仓库子技能）
作者/维护者	Datadog（datadog-labs 官方组织）
来源链接	https://github.com/datadog-labs/agent-skills/tree/main/dd-software-delivery/unblock-pr
许可证	MIT（GitHub API 获取）
GitHub Stars / Forks	合集仓库整体 146 / 19（GitHub API 获取；该数字属整个 agent-skills 合集，不代表本技能自身热度，本技能自身证据见第 7 章取证方式说明）
最新版本	SKILL.md 内声明 1.0.0
安装方式	`cp -r` 复制目录，或 `npx skills add` 命令行安装（详见第 10 章）

2. 功能介绍与亮点

unblock-pr 用于诊断“PR 的 CI 流水线变红了，问题出在哪”这一几乎每个开发者都会遇到的场景。核心能力：

自动分类失败原因：对每个失败的 CI 任务判定为 flaky（不稳定）、infra（基础设施问题）或 regression（本次改动引入的回归），判断依据包括是否在默认分支上同样失败、是否跨多个分支出现
PR 健康度汇总：同时拉取代码覆盖率、代码质量与安全扫描结果，一次性给出 PR 整体健康状况
针对性处理建议：flaky 类失败会自动移交给同仓库的 triage-flaky-test 技能做深度根因分析并给出修复或隔离（quarantine）建议；infra 类失败会先判断是否为瞬时故障，仅在判定为可重试时才建议重跑
双后端支持：优先使用 Datadog MCP 工具，未连接 MCP 时自动降级为 pup 命令行工具，两种路径均有完整实现
官方持续维护：所属合集仓库最近一次提交为 2026-07-23（GitHub API 获取），本技能自身最近一次提交为 2026-05-29 的 bug 修复

3. 适用场景

所属分类：工程效率与代码质量

适合已在使用 GitHub Actions 等 CI 且团队接入了 Datadog 的开发者：PR 提交后 CI 报红，希望 AI agent 先自动分诊“是我的代码问题还是环境问题”，节省手动翻日志、比对历史失败记录的时间。尤其适合测试套件规模较大、flaky test 频发、团队已对“退化 vs 环境抖动”感到疲于排查的工程团队。

4. 跨 Agent 兼容性

Claude Code：原生支持——README 明确给出 cp -r ... ~/.claude/skills 安装路径
Codex CLI：原生支持——README 顶部明确列出 “Datadog skills for Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, OpenCode, and other AI agents”
OpenClaw：未验证——README 未点名，但技能遵循标准 SKILL.md 规范，理论上可安装
Hermes Agent：未验证——同上，README 未点名

5. 推荐理由

CI 报红后先分清“是不是我的锅”是每天都会发生的高频场景，这个技能把分诊、追责、处理建议一次性打包，还内建了“先判断是否值得重试”这类经验规则，比人工翻日志更系统。

6. 评分

维度	分数	说明
受欢迎程度	7	Datadog 官方出品，合集仓库整体持续活跃维护；子技能自身提交与讨论记录较薄，未发现独立于官方渠道的第三方评价
可用性	8	安装步骤清晰（一条 `cp -r` 或 `npx` 命令），README 与 SKILL.md 文档完整、含示例与故障排查表；需要 Datadog 账号与 MCP/CLI 认证配置，非开箱即用
安全性	8	见下方检查清单

安全检查清单：

检查项	结果
① Shell 命令与权限范围	会执行 `git remote get-url origin` 等只读命令，以及在判定为“瞬时故障”时执行 `gh run rerun` 重跑 CI 任务；用途在文档中说明清晰，且仅限重跑已失败的 CI 任务，不触及用户代码或系统文件
② 联网外发	连接 Datadog 官方 MCP 端点（`mcp.datadoghq.com`）或调用 `pup` 命令行工具与 Datadog API 通信，目标透明、无隐藏第三方地址
③ 凭据存储	依赖用户已配置的 Datadog 认证（MCP OAuth 或 `pup auth login`），凭据存取交由官方 `pup` 工具处理
④ 可疑指令	未发现提示注入或隐蔽指令
⑤ 作者信誉	Datadog 为知名上市可观测性公司，datadog-labs 为其官方 GitHub 组织
⑥ License	MIT，明确
⑦ 维护时间	合集仓库 2026-07-23 仍有提交，本技能自身 2026-05-29 有 bug 修复

7. 跟同类 Skills 相比的优势

方案	定位	差异
unblock-pr（本技能）	通用 CI 失败分诊 agent skill	不绑定单一 CI 供应商，通过 git/gh 与 Datadog CI Visibility 数据工作，可覆盖多种测试框架
CircleCI 原生 Test Quality Agent	CI 平台内置功能	仅限 CircleCI 用户，深度绑定该平台，无法用于其他 CI 系统
开源 flaky test 分析 GitHub Action（如 Jest 专用分析器）	CI 流水线内的检测步骤	仅针对特定测试框架（如 Jest），且是被动检测报告，不具备本技能这种“分类 + 移交深度诊断 + 给出重试/修复/隔离建议”的 agent 交互式工作流

8. 用户评价

该技能目前在第三方平台尚无具名用户评价。

9. 安装使用方式

# 前置：安装并认证 pup CLI（Datadog 官方 CLI）
brew tap datadog-labs/pack
brew install datadog-labs/pack/pup
pup auth login

# 方式一：直接复制到 Claude Code 技能目录
git clone https://github.com/datadog-labs/agent-skills.git
cp -r agent-skills/dd-software-delivery/unblock-pr ~/.claude/skills
cp -r agent-skills/dd-software-delivery/triage-flaky-test ~/.claude/skills

# 方式二：通过 npx 安装器
npx skills add datadog-labs/agent-skills \
  --skill dd-software-delivery/unblock-pr \
  --skill dd-software-delivery/triage-flaky-test \
  --full-depth -y

可选：连接 Datadog MCP 服务器以获得更完整的功能（PR 代码质量/安全洞察、原生 GitHub Actions 重跑）：

claude mcp add --scope user --transport http "datadog-mcp" \
  'https://mcp.datadoghq.com/api/unstable/mcp-server/mcp?toolsets=core,software-delivery'

安装后直接在对话中输入 unblock-pr（自动从当前 git 仓库检测分支）或 unblock-pr <分支名> 触发，无需重启。

10. 注意事项

需要团队已有 Datadog 账号（付费可观测性平台）；无 Datadog 订阅的个人开发者无法使用
未连接 MCP、仅用 pup 模式时，代码质量/安全洞察部分会显示“无数据”，且 CI 重跑改用 gh run rerun，需额外配置 GitHub CLI 认证
目前仅验证支持 GitHub Actions 的原生重跑；其他 CI 供应商需手动前往对应平台界面重跑