fix(skills): 根据 review 精简 pr-assessor 验证材料

skills/gitlink-pr-assessor/REFERENCE.md

@@ -30,8 +30,8 @@ gitlink-cli pr +list --owner <owner> --repo <repo> --state open --page 1 --limit
 ### 1.2 单条 PR 元数据
 
 ```bash
-gitlink-cli pr +view --id <pr_id> --format json
-gitlink-cli pr +reviews --id <pr_id> --format json
+gitlink-cli pr +view --id <pull_request_id> --format json
+gitlink-cli pr +reviews --id <pull_request_id> --format json
 gitlink-cli api GET /:owner/:repo/pulls/:id/commits --format json
 ```
 
@@ -45,8 +45,8 @@ gitlink-cli api GET /:owner/:repo/pulls/:id/commits --format json
 ### 1.3 变更内容
 
 ```bash
-gitlink-cli pr +files --id <pr_id> --format json
-gitlink-cli pr +diff --id <pr_id> --format json
+gitlink-cli pr +files --id <pull_request_id> --format json
+gitlink-cli pr +diff --id <pull_request_id> --format json
 ```
 
 重点分析：
@@ -61,11 +61,16 @@ gitlink-cli pr +diff --id <pr_id> --format json
 ```bash
 gitlink-cli repo +info --owner <owner> --repo <repo> --format json
 gitlink-cli ci +builds --owner <owner> --repo <repo> --format json
-gitlink-cli api GET /:owner/:repo/raw/master/README.md
-gitlink-cli api GET /:owner/:repo/raw/master/Makefile
-gitlink-cli api GET /:owner/:repo/raw/master/go.mod
+gitlink-cli api GET /:owner/:repo/sub_entries --query "filepath=README.md&ref=master"
+gitlink-cli api GET /:owner/:repo/sub_entries --query "filepath=Makefile&ref=master"
+gitlink-cli api GET /:owner/:repo/sub_entries --query "filepath=go.mod&ref=master"
 ```
 
+说明：
+
+- 这里统一使用 `pull_request_id` 作为 `--id` 的输入值。
+- `raw/master/...` 在 GitLink 上实测可能返回 `403`，读取仓库约束文件时改用 `sub_entries` 更稳妥。
+
 从仓库中判断：
 
 - 技术栈

skills/gitlink-pr-assessor/SKILL.md

@@ -118,8 +118,8 @@ gitlink-cli pr +list --owner <owner> --repo <repo> --state open --page 1 --limit
 对每条 open PR 补拉 review 信息：
 
 ```bash
-gitlink-cli pr +reviews --owner <owner> --repo <repo> --id <pr_number> --format json
-gitlink-cli pr +view --owner <owner> --repo <repo> --id <pr_number> --format json
+gitlink-cli pr +reviews --owner <owner> --repo <repo> --id <pull_request_id> --format json
+gitlink-cli pr +view --owner <owner> --repo <repo> --id <pull_request_id> --format json
 ```
 
 然后判断：
@@ -133,15 +133,18 @@ gitlink-cli pr +view --owner <owner> --repo <repo> --id <pr_number> --format jso
 ### Step 3：为每条 PR 采集评估上下文
 
 ```bash
-gitlink-cli pr +view --id <pr_id> --format json
-gitlink-cli pr +files --id <pr_id> --format json
-gitlink-cli pr +diff --id <pr_id> --format json
-gitlink-cli pr +reviews --id <pr_id> --format json
+gitlink-cli pr +view --id <pull_request_id> --format json
+gitlink-cli pr +files --id <pull_request_id> --format json
+gitlink-cli pr +diff --id <pull_request_id> --format json
+gitlink-cli pr +reviews --id <pull_request_id> --format json
 gitlink-cli api GET /:owner/:repo/pulls/:id/commits --format json
 gitlink-cli repo +info --owner <owner> --repo <repo> --format json
 gitlink-cli ci +builds --owner <owner> --repo <repo> --format json
 ```
 
+`pr +view`、`pr +files`、`pr +diff`、`pr +reviews` 在这里统一使用 `pull_request_id`。
+`pull_request_number` 只保留给维护者看的报告标题、队列表格和网页链接。
+
 至少提取：
 
 - PR 标题、描述、作者、创建时间、base/head

skills/gitlink-pr-assessor/examples/codex-first40-validation.md

@@ -1,6 +1,6 @@
 # Codex 验证记录：扫描前 40 条 open PR
 
-这个示例记录了 `gitlink-pr-assessor` 在 Codex 中的一次实际验证，用来证明该 skill 可以在真实仓库上完成 open PR 队列扫描、逐条评估和报告生成。
+这个示例记录了 `gitlink-pr-assessor` 在 Codex 中的一次实际验证，用来证明这个 skill 可以在真实仓库上完成 open PR 队列扫描、逐条评估和维护者报告整理。
 
 ## 验证环境
 
@@ -17,12 +17,9 @@ $gitlink-pr-assessor 扫描 Gitlink/gitlink-cli 仓库当前前 40 条 open PR
 
 ## 产出结果
 
-- 队列总览与逐条评估报告：[`codex-first40-validation-report.md`](./codex-first40-validation-report.md)
-- 效果截图：
-  - [`执行结果图.png`](../assets/validation-screenshots/执行结果图.png)
-  - [`输出报告部分截图.png`](../assets/validation-screenshots/输出报告部分截图.png)
-  - [`输出报告部分截图2.png`](../assets/validation-screenshots/输出报告部分截图2.png)
-  - [`输出报告部分截图3.png`](../assets/validation-screenshots/输出报告部分截图3.png)
+- 这次验证已经成功生成队列总览和逐条评估结果，证明 skill 可以在真实 open PR 队列上完成批量筛查。
+- 为避免把一次性运行日志和截图长期提交进仓库，详细报告与界面截图不再作为仓库内容保留；如需展示，可在 PR 描述、评审回复或单独的演示材料中引用。
+- 仓库内保留这份验证说明，作为“已在真实项目执行过”的复核依据。
 
 ## 验证结论
 
@@ -36,4 +33,4 @@ $gitlink-pr-assessor 扫描 Gitlink/gitlink-cli 仓库当前前 40 条 open PR
 - 纳入评估：39 条
 - 跳过：1 条
 - `origin/master` 基线上的 `go build ./...` 与 `go test ./...` 均通过
-- 扫描结果能区分可继续推进、需补测试、需拆分、建议拒绝等不同结论
+- 扫描结果能够区分可继续推进、需补测试、需拆分、建议拒绝等不同结论

skills/gitlink-pr-assessor/examples/gitlink-cli-pr-assessment.md

@@ -12,6 +12,11 @@
 
 ## 推荐流程
 
+这里统一约定：
+
+- `pull_request_id` 用来执行 `pr +view`、`pr +files`、`pr +diff`、`pr +reviews`
+- `pull_request_number` 只用于人类阅读的报告标题、列表展示和网页链接
+
 ### 1. 拉 open PR 列表
 
 ```bash
@@ -26,8 +31,8 @@ gitlink-cli pr +list --owner Gitlink --repo gitlink-cli --state open --page 1 --
 ### 2. 对每条 PR 判断是否进入待评估队列
 
 ```bash
-gitlink-cli pr +view --owner Gitlink --repo gitlink-cli --id <pr_number> --format json
-gitlink-cli pr +reviews --owner Gitlink --repo gitlink-cli --id <pr_number> --format json
+gitlink-cli pr +view --owner Gitlink --repo gitlink-cli --id <pull_request_id> --format json
+gitlink-cli pr +reviews --owner Gitlink --repo gitlink-cli --id <pull_request_id> --format json
 ```
 
 建议跳过：
@@ -39,9 +44,9 @@ gitlink-cli pr +reviews --owner Gitlink --repo gitlink-cli --id <pr_number> --fo
 ### 3. 对纳入队列的 PR 拉上下文
 
 ```bash
-gitlink-cli pr +files --id <pr_number> --format json
-gitlink-cli pr +diff --id <pr_number> --format json
-gitlink-cli api GET /Gitlink/gitlink-cli/pulls/<pr_number>/commits --format json
+gitlink-cli pr +files --id <pull_request_id> --format json
+gitlink-cli pr +diff --id <pull_request_id> --format json
+gitlink-cli api GET /Gitlink/gitlink-cli/pulls/<pull_request_id>/commits --format json
 gitlink-cli repo +info --owner Gitlink --repo gitlink-cli --format json
 gitlink-cli ci +builds --owner Gitlink --repo gitlink-cli --format json
 ```