Gitlink
/
gitlink-cli
0
0
Fork 49
Code Issues Pull Requests 11 Packages Projects Releases 10 Wiki Activity

feat(skills): 新增 gitlink-doctor 环境自诊断与故障排除 Skill #422

Merged
wbtiger merged 1 commits from Taoyouce/gitlink-cli:feat/skill-doctor into master 2026-07-14 20:36:29 +08:00
Conversation 0 Commits 1 Files Changed 2 +82
Taoyouce commented 2026-07-11 01:08:45 +08:00
Contributor
Copy Link

背景

master 已合入 doctor 自诊断命令，但 43 个 Skill 中没有对应的排障 Skill——Agent 遇到「CLI 用不了 / 一直 401 / 命令 404」时缺少标准处置流程，容易在本地环境上空转（尤其是命中平台侧缺口时）。

内容

新增 skills/gitlink-doctor/SKILL.md：

  • 一键体检：doctor --format json 读取 5 类检查（config_file/config_values/auth/repo_context/api_connectivity）结构化结果
  • 逐项修复表：每个检查项的常见状态 → 修复动作 → 复检命令，修复配置属写操作须先告知用户
  • 平台缺口对照表（本 Skill 核心增量）：doctor 全绿但命令仍失败时的 5 条已知平台侧根因与替代方案（wiki 微服务不认 PAT、旧版 CI 下线、dataset 后端未部署、v1 contents 返回 HTML、跨 fork compare 不可用）——全部来自我方生产语义审计的实测结论，命中即止损不再折腾本地环境
  • 遵循 skills 仓库全部惯例（frontmatter、CRITICAL 声明、gitlink-shared 前置引用），已登记 skills/README.md 索引

生产验证（2026-07-10）

真实环境跑通 Skill 主流程：doctor --format json 返回 summary ok=3/warning=2/error=0 及逐项 checks（含 suggestion 字段），修复表与实际输出字段一一对应。

注：与 #413 gitlink-semantic-audit 互补——semantic-audit 面向「审计命令实现是否符合平台语义」，本 Skill 面向「终端用户/Agent 环境排障」。

## 背景 master 已合入 `doctor` 自诊断命令，但 43 个 Skill 中没有对应的排障 Skill——Agent 遇到「CLI 用不了 / 一直 401 / 命令 404」时缺少标准处置流程，容易在本地环境上空转（尤其是命中平台侧缺口时）。 ## 内容 新增 `skills/gitlink-doctor/SKILL.md`： - **一键体检**：`doctor --format json` 读取 5 类检查（config_file/config_values/auth/repo_context/api_connectivity）结构化结果 - **逐项修复表**：每个检查项的常见状态 → 修复动作 → 复检命令，修复配置属写操作须先告知用户 - **平台缺口对照表**（本 Skill 核心增量）：doctor 全绿但命令仍失败时的 5 条已知平台侧根因与替代方案（wiki 微服务不认 PAT、旧版 CI 下线、dataset 后端未部署、v1 contents 返回 HTML、跨 fork compare 不可用）——全部来自我方生产语义审计的实测结论，命中即止损不再折腾本地环境 - 遵循 skills 仓库全部惯例（frontmatter、CRITICAL 声明、gitlink-shared 前置引用），已登记 skills/README.md 索引 ## 生产验证（2026-07-10） 真实环境跑通 Skill 主流程：`doctor --format json` 返回 summary ok=3/warning=2/error=0 及逐项 checks（含 suggestion 字段），修复表与实际输出字段一一对应。 注：与 #413 gitlink-semantic-audit 互补——semantic-audit 面向「审计命令实现是否符合平台语义」，本 Skill 面向「终端用户/Agent 环境排障」。
Taoyouce added 6 commits 2026-07-11 01:08:46 +08:00
e32b1b5a06 feat(skills): 新增 gitlink-doctor 环境自诊断与故障排除 Skill 
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
wbtiger merged commit b0416e697f into master 2026-07-14 20:36:29 +08:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No Label
Milestone
Clear milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: Gitlink/gitlink-cli#422
No description provided.
Delete Branch "Taoyouce/gitlink-cli:feat/skill-doctor"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?