5.5 KiB
5.5 KiB
gitlink-ci-health 使用样例
样例 1:CI 未激活的仓库
日期:2026-06-03 仓库:jiangtx/gitlink-cli(Fork 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 +authorize、ci +activate、ci +deactivate |
诊断结论
CI 完全未启用,需通过 GitLink Web 界面开启(仓库设置 → DevOps)。用户拥有 Manager 权限,可以操作。
生成的报告
# 🔧 CI 健康巡检报告:jiangtx/gitlink-cli
> 巡检时间:2026-06-03
> 仓库:jiangtx/gitlink-cli(Fork 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/CD(DevOps)服务。
## 三、改进建议
- 🔴 立即激活 CI:前往 GitLink Web 界面 → 仓库设置 → DevOps 开启 CI/CD 服务
- 🟡 配置 CI Pipeline:建议添加 .gitlink-ci.yml 配置编译和测试流水线
## 四、仓库基本信息
| 项目 | 值 |
|------|-----|
| 默认分支 | master |
| 仓库大小 | 13.4 MB |
| 贡献者 | 2 |
| PR 数量 | 9 |
| 权限 | Manager |
异常场景速查
| 场景 | 检测方式 | ci +builds 返回值 |
处理 |
|---|---|---|---|
| CI 未激活 | repo +info 的 open_devops: false |
{"status":-1,"message":"接口数据异常"} |
建议 Web 界面激活,终止巡检 |
| CI 已激活但无构建 | repo +info 的 open_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 字段为 false,CI/CD 服务未开启。其他仓库信息:2 位贡献者、
9 个 PR、0 个 Issue,Fork 自 Gitlink/gitlink-cli。
验证结论
✅ skill v1.1.0 修复验证通过:
- Agent 正确使用了
repo +info的open_devops字段判断 CI 状态 - Agent 在 CI 未激活时正确终止,没有执行后续无效步骤
- Agent 没有尝试调用不存在的
ci +authorize或ci +activate - Agent 正确建议通过 Web 界面激活
- 报告结构完整,包含了仓库基本信息