gh-view

# GitHub 内容分析 开始时声明："我正在使用 gh-view skill 分析 GitHub 内容。" ## 快速开始 1. 识别输入类型（repo / issue / pr / discussion / release）。 2. 用 `gh` 拉取基础信息、评论、状态、代码差异。 3. 输出结论：背景、关键点、风险、建议下一步。 4. 默认只分析；仅在用户明确要求时执行写操作。 ## 何时不要使用（Do NOT use） - 用户请求直接修改代码、提交 commit。 - 用户主要目标是 CI 根因分析（优先 `ci-analyze`）。 ## 触发样例与非样例 - 应触发： - "看下这个 PR 的核心风险点：<GitHub URL>。" - "帮我总结这个 issue 的讨论重点。" - 不应触发： - "帮我把这个 PR 的代码直接改完并提交。" - "这个 pipeline fail 了，帮我查日志根因。" ## 使用示例 ```bash # 分析 PR gh-view https://github.com/qiniu/qshell/pull/123 # 分析 issue（使用当前仓库上下文） gh-view #456 # 查看仓库概览 gh-view qiniu/qshell ``` ## 输入识别规则 - 仓库：`owner/repo` 或 `https://github.com/owner/repo` - Issue：`owner/repo/issues/<n>` 或 `#<n>`（需 repo 上下文） - PR：`owner/repo/pull/<n>` 或 `#<n>`（需 repo 上下文） - 跨仓库编号：`owner/repo#<n>` 补充规则： - 当输入是完整 URL 时，先提取 `owner/repo` 与对象编号，再执行 `gh` 命令。 - 用户未显式给 `repo` 时，默认使用 `qiniu/qshell`。 - 需要结构化信息时优先添加 `--json`。 ## 命令矩阵（按对象） ```bash # 仓库 gh repo view <owner/repo> gh repo view <owner/repo> --json name,description,defaultBranchRef,stargazerCount,forkCount,openIssuesCount # Issue gh issue view <n> --repo <owner/repo> gh issue view <n> --repo <owner/repo> --comments # PR gh pr view <n> --repo <owner/repo> gh pr view <n> --repo <owner/repo> --comments gh pr diff <n> --repo <owner/repo> gh pr checks <n> --repo <owner/repo> ``` ## 输出模板 ```text 目标: <repo/issue/pr> 背景: <一句话> 关键信息: - ... - ... 风险/阻塞: - ... 建议下一步: 1. ... 2. ... 3. ... ``` ## 边界 - 仅使用 `gh repo view` / `gh issue view` / `gh pr view` / `gh pr diff` / `gh pr checks` / `gh api` 等只读命令。 - 不执行任何写操作（如 `gh pr comment`、`gh pr merge`、`gh issue comment`、打标签、关闭 issue）；未明确授权时仅分析不写入。 - 信息不足时先问澄清，不猜测。 ## 失败回退 - URL 解析失败：提示用户检查 URL 格式，给出合法示例。 - `gh` 命令 403/404：检查仓库权限或对象是否存在；输出实际命令和报错。 - 信息不足以给出结论：明确标注"信息不足"，列出已获取内容和缺失项。 ## 验收标准（统一） - 输入前提：参数与上下文可解析；缺省参数按 skill 默认值执行，并在输出中注明。 - 产出要求：按 skill 约定的输出模板给出结果，并包含关键证据（命令、路径、链接或日志摘要）。 - 通过判定：主流程步骤已完成且无阻塞；若有未完成项，必须明确标注影响范围与下一步。 - 默认策略（非交互）：需要确认但用户未及时响应时，采用"推荐默认值/最小风险项"继续；需要交互选择时优先推荐项。 - 阻塞升级：遇到权限、凭证、外部依赖缺失时立即停止该步骤，输出"阻塞点 + 已尝试 + 需要用户提供的信息"。 ## 系统规范（AGENTS.md） 执行本 skill 时同时遵守 `AGENTS.md` 中的系统规范；与本 skill 冲突时以本 skill 为准。