diff --git a/skills/gitlink-pr/SKILL.md b/skills/gitlink-pr/SKILL.md
index 3c5e054..0412f7e 100644
--- a/skills/gitlink-pr/SKILL.md
+++ b/skills/gitlink-pr/SKILL.md
@@ -36,18 +36,18 @@ gitlink-cli pr +list --owner Gitlink --repo forgeplus --state open
 # 创建 PR（源分支必须有实际代码变更）
 gitlink-cli pr +create --title "feat: 新增搜索功能" --head feature/search --base master --body "实现了全文搜索"
 
-# 查看 PR 详情（使用 pull_request_id）
-gitlink-cli pr +view --id 14200
+# 查看 PR 详情（使用 pull_request_number，即网页 URL 中的序号）
+gitlink-cli pr +view --id 3
 
 # 合并 PR（支持 merge/rebase/squash）
-gitlink-cli pr +merge --id 14200
-gitlink-cli pr +merge --id 14200 --method squash
+gitlink-cli pr +merge --id 3
+gitlink-cli pr +merge --id 3 --method squash
 
 # 关闭 PR（拒绝合并）
-gitlink-cli pr +close --id 14200
+gitlink-cli pr +close --id 3
 
 # 查看变更文件（含 diff 内容）
-gitlink-cli pr +files --id 14200
+gitlink-cli pr +files --id 3
 ```
 
 ## 创建 PR 的完整流程
@@ -124,7 +124,7 @@ gitlink-cli api GET /:owner/:repo/pulls/get_branches
 - GitLink 的默认分支通常是 `master`（非 `main`），创建 PR 时注意 `--base` 参数
 - 合并 PR 前建议先用 `pr +view` 确认状态
 - **PR 创建要求源分支与目标分支有实际代码差异**，否则返回"分支内容相同，无需创建合并请求"
-- PR 查看/合并/关闭需要使用 `pull_request_id`（从 `pr +create` 或 `pr +list` 返回）
+- PR 查看/合并/关闭需要使用 `pull_request_number`（即网页 URL `/pulls/N` 中的序号，从 `pr +list` 返回）
 - `pr +merge` 默认使用 merge 方式，可通过 `--method` 指定 rebase 或 squash
 - `pr +diff` 实际调用 `/pulls/:id/files` 端点，返回变更文件列表和 diff 内容
 - `pr +list` 的 `--state` 参数（open/merged/closed）仅影响统计计数，API 返回的列表可能包含所有状态的 PR
diff --git a/skills/gitlink-pr/references/gitlink-pr-close.md b/skills/gitlink-pr/references/gitlink-pr-close.md
index d49688b..1a4ca24 100644
--- a/skills/gitlink-pr/references/gitlink-pr-close.md
+++ b/skills/gitlink-pr/references/gitlink-pr-close.md
@@ -8,22 +8,22 @@
 
 ```bash
 # 关闭 PR
-gitlink-cli pr +close --id 14200
+gitlink-cli pr +close --id 3
 
 # 简写
-gitlink-cli pr +close -i 14200
+gitlink-cli pr +close -i 3
 ```
 
 ## 参数
 
 | 参数 | 必填 | 说明 |
 |------|------|------|
-| `--id` / `-i` | 是 | PR 编号（`pull_request_id`） |
+| `--id` / `-i` | 是 | PR 序号（`pull_request_number`） |
 
 ## API
 
 ```
-POST /{owner}/{repo}/pulls/{id}/refuse_merge
+POST /{owner}/{repo}/pulls/{number}/refuse_merge
 ```
 
 ## Workflow
diff --git a/skills/gitlink-pr/references/gitlink-pr-create.md b/skills/gitlink-pr/references/gitlink-pr-create.md
index 95500e0..bde418a 100644
--- a/skills/gitlink-pr/references/gitlink-pr-create.md
+++ b/skills/gitlink-pr/references/gitlink-pr-create.md
@@ -92,7 +92,7 @@ gitlink-cli api PUT /:owner/:repo/update_file --body '{
 - **源分支与目标分支必须有实际代码差异**，否则 API 返回 "分支内容相同，无需创建合并请求"
 - GitLink 默认主分支为 `master`（非 `main`），`--base` 默认值为 `master`
 - `create_file` 的 `content` 字段**必须 base64 编码**，不编码会返回 "文件已存在" 错误
-- 创建成功后返回的 `pull_request_id` 用于后续 view/merge/close 操作
+- 创建成功后返回的 `pull_request_number` 用于后续 view/merge/close 操作
 - 关联已有 Issue 时，把 Issue 编号或 URL 写入 PR `--body`，或用 `issue +comment` 在 Issue 下补充 PR 链接；不要为了关联 PR 直接用 Raw API 更新 Issue 描述
 
 ## References
diff --git a/skills/gitlink-pr/references/gitlink-pr-files.md b/skills/gitlink-pr/references/gitlink-pr-files.md
index 4084dda..2daeee8 100644
--- a/skills/gitlink-pr/references/gitlink-pr-files.md
+++ b/skills/gitlink-pr/references/gitlink-pr-files.md
@@ -8,28 +8,28 @@
 
 ```bash
 # 查看变更文件
-gitlink-cli pr +files --id 14200
+gitlink-cli pr +files --id 3
 
 # 简写
-gitlink-cli pr +files -i 14200
+gitlink-cli pr +files -i 3
 
 # JSON 格式
-gitlink-cli pr +files -i 14200 --format json
+gitlink-cli pr +files -i 3 --format json
 
 # pr +diff 是等效别名
-gitlink-cli pr +diff -i 14200
+gitlink-cli pr +diff -i 3
 ```
 
 ## 参数
 
 | 参数 | 必填 | 说明 |
 |------|------|------|
-| `--id` / `-i` | 是 | PR 编号（`pull_request_id`） |
+| `--id` / `-i` | 是 | PR 序号（`pull_request_number`） |
 
 ## API
 
 ```
-GET /{owner}/{repo}/pulls/{id}/files
+GET /{owner}/{repo}/pulls/{number}/files
 ```
 
 ## 注意事项
diff --git a/skills/gitlink-pr/references/gitlink-pr-list.md b/skills/gitlink-pr/references/gitlink-pr-list.md
index b264fe3..f11e9d5 100644
--- a/skills/gitlink-pr/references/gitlink-pr-list.md
+++ b/skills/gitlink-pr/references/gitlink-pr-list.md
@@ -41,7 +41,7 @@ GET /{owner}/{repo}/pulls?state={state}&page={page}&limit={limit}
   - `0` = open
   - `1` = merged
   - `2` = closed
-- 返回的每条 PR 包含 `pull_request_id` 字段，用于 `pr +view`、`pr +merge`、`pr +close` 等操作
+- 返回的每条 PR 包含 `pull_request_number` 字段（即网页 URL `/pulls/N` 中的序号），用于 `pr +view`、`pr +merge`、`pr +close` 等操作
 
 ## References
 
diff --git a/skills/gitlink-pr/references/gitlink-pr-merge.md b/skills/gitlink-pr/references/gitlink-pr-merge.md
index d95f34d..8e3d0f9 100644
--- a/skills/gitlink-pr/references/gitlink-pr-merge.md
+++ b/skills/gitlink-pr/references/gitlink-pr-merge.md
@@ -8,26 +8,26 @@
 
 ```bash
 # 默认 merge 方式合并
-gitlink-cli pr +merge --id 14200
+gitlink-cli pr +merge --id 3
 
 # 使用 squash 方式
-gitlink-cli pr +merge -i 14200 --method squash
+gitlink-cli pr +merge -i 3 --method squash
 
 # 使用 rebase 方式
-gitlink-cli pr +merge -i 14200 -m rebase
+gitlink-cli pr +merge -i 3 -m rebase
 ```
 
 ## 参数
 
 | 参数 | 必填 | 说明 |
 |------|------|------|
-| `--id` / `-i` | 是 | PR 编号（`pull_request_id`） |
+| `--id` / `-i` | 是 | PR 序号（`pull_request_number`） |
 | `--method` / `-m` | 否 | 合并方式：`merge`、`rebase`、`squash`（默认 `merge`） |
 
 ## API
 
 ```
-POST /{owner}/{repo}/pulls/{id}/pr_merge
+POST /{owner}/{repo}/pulls/{number}/pr_merge
 Body: { "do": "merge" }
 ```
 
diff --git a/skills/gitlink-pr/references/gitlink-pr-view.md b/skills/gitlink-pr/references/gitlink-pr-view.md
index 27196ff..aa6ffaf 100644
--- a/skills/gitlink-pr/references/gitlink-pr-view.md
+++ b/skills/gitlink-pr/references/gitlink-pr-view.md
@@ -8,30 +8,30 @@
 
 ```bash
 # 查看 PR 详情
-gitlink-cli pr +view --id 14200
+gitlink-cli pr +view --id 3
 
 # 简写
-gitlink-cli pr +view -i 14200
+gitlink-cli pr +view -i 3
 
 # JSON 格式输出
-gitlink-cli pr +view -i 14200 --format json
+gitlink-cli pr +view -i 3 --format json
 ```
 
 ## 参数
 
 | 参数 | 必填 | 说明 |
 |------|------|------|
-| `--id` / `-i` | 是 | PR 编号（`pull_request_id`，从 `pr +list` 或 `pr +create` 获取） |
+| `--id` / `-i` | 是 | PR 序号（`pull_request_number`，即网页 URL `/pulls/N` 中的数字，从 `pr +list` 获取） |
 
 ## API
 
 ```
-GET /{owner}/{repo}/pulls/{id}
+GET /{owner}/{repo}/pulls/{number}
 ```
 
 ## 注意事项
 
-- `--id` 使用的是 `pull_request_id`，可从 `pr +list` 或 `pr +create` 的返回结果中获取
+- `--id` 使用的是 `pull_request_number`（网页 URL 中的序号），可从 `pr +list` 返回的 `pull_request_number` 字段获取
 - 返回内容包含 PR 标题、描述、状态、源/目标分支、作者等详细信息
 - PR 状态字段 `pull_request_status`：`0` = open, `1` = merged, `2` = closed
 - 建议在执行 `pr +merge` 或 `pr +close` 前先用 `pr +view` 确认 PR 当前状态