gitlink-cli/skills/gitlink-ci-health/EXAMPLES.md

5.5 KiB
Raw Blame History

gitlink-ci-health 使用样例

样例 1CI 未激活的仓库

日期2026-06-03 仓库jiangtx/gitlink-cliFork from Gitlink/gitlink-cli CLI 版本gitlink-cli 0.1.18

执行流程

# Step 1: 检查 CI 状态(方法 1 — repo +info
gitlink-cli repo +info --owner jiangtx --repo gitlink-cli --format json
# → "open_devops": false  ← CI 未激活

# Step 1 补充(方法 2 — ci +builds
gitlink-cli ci +builds --owner jiangtx --repo gitlink-cli --format json
# → {"status":-1,"message":"接口数据异常"}  ← 确认 CI 未激活

# 此时终止后续步骤,生成"CI 未激活"报告

关键发现

项目
open_devops false
ci +builds 返回 {"status": -1, "message": "接口数据异常"}
可用 CI 命令 +builds+logs+restart+stop
不存在的命令 ci +authorizeci +activateci +deactivate

诊断结论

CI 完全未启用,需通过 GitLink Web 界面开启(仓库设置 → DevOps。用户拥有 Manager 权限,可以操作。

生成的报告

# 🔧 CI 健康巡检报告jiangtx/gitlink-cli

> 巡检时间2026-06-03
> 仓库jiangtx/gitlink-cliFork from Gitlink/gitlink-cli
> CI 状态:❌ 未激活

## 一、健康度总览

| 指标 | 数值 | 评分 |
|------|------|------|
| CI 激活状态 | ❌ 未激活open_devops: false | 0/4 |
| 整体成功率 | N/A | —/5 |
| 近期稳定性 | N/A | —/5 |
| 构建频率 | N/A | —/3 |
| 修复速度 | N/A | —/3 |
| **总分** | | **0/20** |

## 二、诊断详情

API 调用 ci +builds 返回:
{"status": -1, "message": "接口数据异常"}

仓库元数据显示 open_devops: false确认该仓库尚未启用 GitLink 平台的 CI/CDDevOps服务。

## 三、改进建议

- 🔴 立即激活 CI前往 GitLink Web 界面 → 仓库设置 → DevOps 开启 CI/CD 服务
- 🟡 配置 CI Pipeline建议添加 .gitlink-ci.yml 配置编译和测试流水线

## 四、仓库基本信息

| 项目 | 值 |
|------|-----|
| 默认分支 | master |
| 仓库大小 | 13.4 MB |
| 贡献者 | 2 |
| PR 数量 | 9 |
| 权限 | Manager |

异常场景速查

场景 检测方式 ci +builds 返回值 处理
CI 未激活 repo +infoopen_devops: false {"status":-1,"message":"接口数据异常"} 建议 Web 界面激活,终止巡检
CI 已激活但无构建 repo +infoopen_devops: true + builds 为空 [] 或空列表 标注"暂无构建记录"
构建样本不足(<5 builds 列表长度 < 5 正常 JSON 数组 标注"数据有限,不具代表性"

版本兼容性说明

本 skill 基于 gitlink-cli 0.1.18 编写。不同版本的 CI 子命令可能有差异:

CLI 版本 可用 CI 命令
0.1.18 +builds+logs+restart+stop
未来版本 可能新增 +activate+deactivate

当 CLI 版本更新后,重新验证可用命令:

gitlink-cli ci --help

样例 2通过 Agent 调用 Skill自动巡检

日期2026-06-03 仓库jiangtx/gitlink-cli 调用方式Agent(subagent_type="general-purpose", prompt="调用 gitlink-ci-health skill检查 jiangtx/gitlink-cli 的 CI 状态。严格按照 skill 的工作流步骤执行。")

Agent 自主执行的命令序列

工具调用 1: gitlink-cli repo +info --owner jiangtx --repo gitlink-cli --format json
           → open_devops: false  ← 发现 CI 未激活

工具调用 2: gitlink-cli ci +builds --owner jiangtx --repo gitlink-cli --format json
           → {"status": -1, "message": "接口数据异常"}  ← 二次确认

Agent 决策过程

Agent 读取到 open_devops: false 后,正确遵循了 skill 的异常场景处理规则

"CI 未激活 → 报告 CI 状态为'未激活',建议通过 Web 界面开启,不再继续后续步骤"

Agent 没有继续尝试 ci +logs 或统计分析,直接生成了完整报告。共消耗 5 次工具调用32,113 tokens,耗时 35.8 秒

Agent 生成的报告

# CI 健康巡检报告gitlink-cli

> 巡检时间2026-06-03
> 仓库jiangtx/gitlink-cli
> CI 状态:未激活

## 一、健康度总览

| 指标 | 数值 | 评分 |
|------|------|------|
| CI 激活状态 | 未激活 | 0/4 |
| 整体成功率 | N/A | -/5 |
| 近期稳定性 | N/A | -/5 |
| 构建频率 | N/A | -/3 |
| 修复速度 | N/A | -/3 |
| **总分** | | **0/20** |

## 二、构建趋势

无构建记录。仓库 CI 未启用。

## 三、故障分析

CI 未激活,无构建数据可供分析。

## 四、改进建议

- **立即激活 CI**:前往 GitLink Web 界面 → 仓库设置 → DevOps开启 CI/CD 服务。
  CLI 暂不支持 ci +activate 命令,需要通过 Web 界面操作。)

---

总结:仓库 jiangtx/gitlink-cli项目 ID: 1547588默认分支: master权限: Manager
当前 open_devops 字段为 falseCI/CD 服务未开启。其他仓库信息2 位贡献者、
9 个 PR、0 个 IssueFork 自 Gitlink/gitlink-cli。

验证结论

skill v1.1.0 修复验证通过:

  • Agent 正确使用了 repo +infoopen_devops 字段判断 CI 状态
  • Agent 在 CI 未激活时正确终止,没有执行后续无效步骤
  • Agent 没有尝试调用不存在的 ci +authorizeci +activate
  • Agent 正确建议通过 Web 界面激活
  • 报告结构完整,包含了仓库基本信息