需求背景

OpenLibing 工作区的 gitcode-pr-report skill 需要生成 release 分支「已合并 PR → 关联 Issue」门禁报告。根据 AGENTS.md 约束，所有 GitCode 远端交互应统一走 gitcode CLI（认证、分页、JSON 输出），避免脚本自封装 HTTP 与 token 管理。

当前 skill 脚本 gitcode-api.mjs 仍通过自封装 fetch 调用部分 API。经调研（gitcode v0.6.0，Windows，GC_TOKEN 认证），以下能力缺口导致无法完全迁移到 CLI。

功能描述

缺口 1：pr issues 子命令（优先级最高）

现状：gitcode pr 无 issues 子命令；gitcode pr view --json 不含 linked issues 字段。

当前 workaround：

gitcode api repos/{owner}/{repo}/pulls/{number}/issues

期望：

gitcode pr issues <number> -R owner/repo --json

对应 API：GET /api/v5/repos/{owner}/{repo}/pulls/{number}/issues

用例：release 报告需对每个 merged PR 查询关联 Issue（N+1 调用）。有一等命令后可删除脚本内自封装 fetch。

缺口 2：repo branch view 子命令

现状：gitcode repo 无 branch 相关子命令。

当前 workaround：

gitcode api repos/{owner}/{repo}/branches/{branch}

期望（二选一，推荐前者以保持与 repo view 风格一致）：

gitcode repo branch view <branch> -R owner/repo --json
# 或
gitcode repo view -R owner/repo --branch <branch> --json

对应 API：GET /api/v5/repos/{owner}/{repo}/branches/{branch}

用例：获取分支最新 commit id（commit.id），用于报告输出目录命名（取前 8 位）。

缺口 3（可选 enhancement）：gitcode api --paginate

现状：gitcode api 不支持 --paginate；gitcode pr list --paginate 已支持。

期望：

gitcode api repos/{owner}/{repo}/pulls?state=merged&base=release --paginate --json

用例：通用 API 请求支持自动翻页，减少脚本自写分页逻辑。本需求优先级低于缺口 1/2。

使用场景

1. Release 门禁报告：列出 base={release_branch} 的 merged PR，逐 PR 查关联 Issue，生成 Markdown 对照表。
2. 报告目录命名：以目标分支最新 commit 短 hash 作为输出目录标识。
3. Agent/脚本编排：统一 gitcode 认证与 JSON 输出，符合 OpenLibing AGENTS.md 远端交互规范。

已验证可用的 CLI（无需本 issue 覆盖）

• gitcode pr list -R owner/repo --state merged --base {branch} --paginate --json
• gitcode repo view -R owner/repo --json
• gitcode auth status（GC_TOKEN）

不适用的替代方案

• gitcode issue relations：从 Issue 侧查 PR，无 base 分支过滤，默认 limit 100，不含 PR 作者信息；语义与 release 报告（从 merged PR 反查 Issue、以 PR 作者为责任人）不符。
• gitcode issue prs（#22 已实现）：方向相反（Issue → PR），不能替代 PR → Issue。

验收标准

gitcode pr issues

• 子命令存在，帮助信息与 pr view/pr list 风格一致
• 支持 -R owner/repo、--json
• JSON 输出包含 Issue number、title 等 release 报告所需字段
• 404 或无关联时行为明确（空列表或明确错误，与 API 语义一致）

gitcode repo branch view

• 子命令存在（或 repo view --branch 等价能力）
• 支持 -R owner/repo、--json
• JSON 输出包含 commit.id（及 name/protected 等基础字段）
• 分支不存在时返回明确错误

gitcode api --paginate（可选）

• api 子命令支持 --paginate，行为与 pr list --paginate 一致
• 自动合并多页结果为 JSON 数组

环境信息

• gitcode 版本：0.6.0
• OS：Windows
• Shell：bash / PowerShell
• 认证：GC_TOKEN（gitcode auth status 已验证）

关联 issue/PR

• #22：已实现 issue prs（Issue → PR），与本需求方向互补
• #217：label/milestone 列表分页（已关闭），可参考分页实现
• #242：issue comments 分页语义（已关闭），与 api --paginate 相关但范围不同
• #246：早期实战缺口汇总（已关闭），未覆盖本 issue 三个具体命令