# Pr Analyze

> Comprehensive GitHub PR analysis workflow for VS Code Copilot. Use when user provides a PR number or URL and asks to analyze purpose, impact, CI status, related PRs, and review risks.

- **Type:** Skill
- **Install:** `agentstack add skill-sakurapainting-you-skills-pr-analyze`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Sakurapainting](https://agentstack.voostack.com/s/sakurapainting)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Sakurapainting](https://github.com/Sakurapainting)
- **Source:** https://github.com/Sakurapainting/you-skills/tree/dev/copilot/pr-analyze

## Install

```sh
agentstack add skill-sakurapainting-you-skills-pr-analyze
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# PR Analyze

用于在 VS Code Copilot 中对 GitHub Pull Request 做结构化分析，并输出中文结论。

## 何时使用

当用户出现以下意图时自动使用本技能：
- 帮我分析 PR
- 这个 PR 是干什么的
- 看下这个 PR 的影响范围
- 评估这个 PR 能不能合并
- 用户直接给出 PR 链接或 `owner/repo#123` 形式

## 输入格式

支持以下输入：
- PR 编号：`123`（当前目录是目标仓库）
- PR URL：`https://github.com/owner/repo/pull/123`
- 简写：`owner/repo#123`

## 依赖要求

- 必须安装并已登录 GitHub CLI：`gh auth status`
- 当前目录建议是 git 仓库根目录

## 标准流程

1. 识别仓库与 PR
- 如果是 URL 或 `owner/repo#123`，直接提取 owner/repo 与编号。
- 如果只有编号，先用 git remote 推断仓库。

2. 拉取 PR 基础信息
- `gh pr view  --repo  --json title,body,state,author,baseRefName,headRefName,files,additions,deletions,commits,mergeable,labels`
- `gh pr diff  --repo `

3. 生成功能摘要
- 用 1-3 句话说明 PR 目标、改动面、主要收益。
- 如果 PR 关联 Issue（Closes/Fixes/Resolves），提取并记录。

4. 兼容性与风险评估
- 从以下维度评估：
  - API/协议兼容性
  - 配置与环境变量
  - 数据结构/存储
  - 依赖升级与许可证风险
  - 安全与权限边界
- 结论用 `低/中/高` 风险等级。

5. 查重与关联 PR
- 根据关键词搜索历史 PR：
  - `gh pr list --repo  --state all --search "" --json number,title,state,author`
- 标注关系类型：重复/互补/依赖/冲突/无关。

6. CI 与可合并性检查
- `gh pr checks  --repo `
- 若失败，列出失败项、可能原因、建议修复顺序。

7. 代码评审重点（轻量）
- 优先找：
  - 行为回归风险
  - 边界条件遗漏
  - 错误处理与日志缺失
  - 测试覆盖不足
- 输出 `阻塞问题` 与 `建议优化` 两类。

8. 输出结构化报告
- 使用以下模板输出，必须中文：

```markdown
# PR 分析报告

## 1. 基本信息
- 仓库：
- PR：
- 标题：
- 作者：
- 状态：
- 目标分支 / 来源分支：

## 2. 这个 PR 做了什么
-

## 3. 改动范围
- 文件数 / 增删行：
- 主要模块：

## 4. 兼容性与风险
| 维度 | 结论 | 说明 |
|---|---|---|
| API | 低/中/高 | |
| 配置 | 低/中/高 | |
| 数据 | 低/中/高 | |
| 依赖 | 低/中/高 | |
| 安全 | 低/中/高 | |

## 5. 关联项
- 关联 Issue：
- 相关 PR：

## 6. CI 与可合并性
- CI 状态：
- 可合并性：

## 7. 评审发现
### 阻塞问题
1.

### 建议优化
1.

## 8. 结论
- 建议：可合并 / 修复后合并 / 暂不合并
- 需要行动：
```

## 执行约束

- 优先基于命令输出给结论，不要臆测。
- 如果信息不足，明确写证据不足，并给出下一条应执行命令。
- 不要输出与 PR 无关的大段背景知识。
- 每次分析必须同时输出到对话和 Markdown 文件（不可省略落盘）。

## 报告落盘（必需）

每次执行分析都必须保存一份 Markdown 报告，规则如下：

1. 目录规则
- 默认目录：`$HOME/.copilot/skills/pr-analyze/reports`
- 如果目录不存在，先创建目录。

2. 文件命名
- 文件名格式：`pr-{repo_slug}-{pr_number}-{YYYYMMDD-HHMMSS}.md`

3. 执行步骤
- 写入 Markdown 文件。
- 最后回显“报告已保存到: ”。

## 失败兜底

当 `gh` 不可用或未登录时：
1. 明确提示缺失条件（CLI 或鉴权）。
2. 给出最小修复步骤：
   - `gh --version`
   - `gh auth login`
3. 请求用户提供 PR URL 后重试。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Sakurapainting](https://github.com/Sakurapainting)
- **Source:** [Sakurapainting/you-skills](https://github.com/Sakurapainting/you-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-sakurapainting-you-skills-pr-analyze
- Seller: https://agentstack.voostack.com/s/sakurapainting
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.