github.com/qiniu/go-sdk/v7@v7.27.0/.agents/skills/gh-view/SKILL.md (about)

     1  ---
     2  name: gh-view
     3  description: 分析 GitHub issues、PRs 与 discussions，提供见解或实施指导。在用户提供 GitHub URL、issue/PR 编号或询问仓库内容时使用。典型场景：看 issue/PR 状态、拉 diff 与 checks、要结论与建议下一步时。
     4  argument-hint: "<GitHub URL | owner/repo | issue/PR编号> [repo=qiniu/go-sdk]"
     5  allowed-tools:
     6    - Bash(gh repo view:*)
     7    - Bash(gh issue view:*)
     8    - Bash(gh pr view:*)
     9    - Bash(gh pr diff:*)
    10    - Bash(gh pr checks:*)
    11    - Bash(gh api *)
    12  ---
    13  
    14  # GitHub 内容分析
    15  
    16  开始时声明："我正在使用 gh-view skill 分析 GitHub 内容。"
    17  
    18  ## 快速开始
    19  
    20  1. 识别输入类型（repo / issue / pr / discussion / release）。
    21  2. 用 `gh` 拉取基础信息、评论、状态、代码差异。
    22  3. 输出结论：背景、关键点、风险、建议下一步。
    23  4. 默认只分析；仅在用户明确要求时执行写操作。
    24  
    25  ## 何时不要使用（Do NOT use）
    26  
    27  - 用户请求直接修改代码、提交 commit。
    28  - 用户主要目标是 CI 根因分析（优先 `ci-analyze`）。
    29  
    30  ## 触发样例与非样例
    31  
    32  - 应触发：
    33  - "看下这个 PR 的核心风险点：<GitHub URL>。"
    34  - "帮我总结这个 issue 的讨论重点。"
    35  - 不应触发：
    36  - "帮我把这个 PR 的代码直接改完并提交。"
    37  - "这个 pipeline fail 了，帮我查日志根因。"
    38  
    39  ## 使用示例
    40  
    41  ```bash
    42  # 分析 PR
    43  gh-view https://github.com/qiniu/go-sdk/pull/123
    44  
    45  # 分析 issue（使用当前仓库上下文）
    46  gh-view #456
    47  
    48  # 查看仓库概览
    49  gh-view qiniu/go-sdk
    50  ```
    51  
    52  ## 输入识别规则
    53  
    54  - 仓库：`owner/repo` 或 `https://github.com/owner/repo`
    55  - Issue：`owner/repo/issues/<n>` 或 `#<n>`（需 repo 上下文）
    56  - PR：`owner/repo/pull/<n>` 或 `#<n>`（需 repo 上下文）
    57  - 跨仓库编号：`owner/repo#<n>`
    58  
    59  补充规则：
    60  - 当输入是完整 URL 时，先提取 `owner/repo` 与对象编号，再执行 `gh` 命令。
    61  - 用户未显式给 `repo` 时，默认使用 `qiniu/go-sdk`。
    62  - 需要结构化信息时优先添加 `--json`。
    63  
    64  ## 命令矩阵（按对象）
    65  
    66  ```bash
    67  # 仓库
    68  gh repo view <owner/repo>
    69  gh repo view <owner/repo> --json name,description,defaultBranchRef,stargazerCount,forkCount,openIssuesCount
    70  
    71  # Issue
    72  gh issue view <n> --repo <owner/repo>
    73  gh issue view <n> --repo <owner/repo> --comments
    74  
    75  # PR
    76  gh pr view <n> --repo <owner/repo>
    77  gh pr view <n> --repo <owner/repo> --comments
    78  gh pr diff <n> --repo <owner/repo>
    79  gh pr checks <n> --repo <owner/repo>
    80  ```
    81  
    82  ## 输出模板
    83  
    84  ```text
    85  目标: <repo/issue/pr>
    86  背景: <一句话>
    87  
    88  关键信息:
    89  - ...
    90  - ...
    91  
    92  风险/阻塞:
    93  - ...
    94  
    95  建议下一步:
    96  1. ...
    97  2. ...
    98  3. ...
    99  ```
   100  
   101  ## 边界
   102  
   103  - 仅使用 `gh repo view` / `gh issue view` / `gh pr view` / `gh pr diff` / `gh pr checks` / `gh api` 等只读命令。
   104  - 不执行任何写操作（如 `gh pr comment`、`gh pr merge`、`gh issue comment`、打标签、关闭 issue）；未明确授权时仅分析不写入。
   105  - 信息不足时先问澄清，不猜测。
   106  
   107  ## 失败回退
   108  
   109  - URL 解析失败：提示用户检查 URL 格式，给出合法示例。
   110  - `gh` 命令 403/404：检查仓库权限或对象是否存在；输出实际命令和报错。
   111  - 信息不足以给出结论：明确标注"信息不足"，列出已获取内容和缺失项。
   112  
   113  ## 验收标准（统一）
   114  
   115  - 输入前提：参数与上下文可解析；缺省参数按 skill 默认值执行，并在输出中注明。
   116  - 产出要求：按 skill 约定的输出模板给出结果，并包含关键证据（命令、路径、链接或日志摘要）。
   117  - 通过判定：主流程步骤已完成且无阻塞；若有未完成项，必须明确标注影响范围与下一步。
   118  - 默认策略（非交互）：需要确认但用户未及时响应时，采用"推荐默认值/最小风险项"继续；需要交互选择时优先推荐项。
   119  - 阻塞升级：遇到权限、凭证、外部依赖缺失时立即停止该步骤，输出"阻塞点 + 已尝试 + 需要用户提供的信息"。
   120  
   121  ## 系统规范（AGENTS.md）
   122  
   123  执行本 skill 时同时遵守 `AGENTS.md` 中的系统规范；与本 skill 冲突时以本 skill 为准。