gitlink-cli/skills/gitlink-ci/SKILL.md

name	version	description	metadata
gitlink-ci	2.0.0	CI/CD 操作：查看构建列表、构建日志、重启/停止构建、启停仓库 CI、查看 CI 授权状态。当用户需要操作 GitLink CI 时触发。	requires cliHelp bins gitlink-cli gitlink-cli ci --help

gitlink-ci（CI/CD 操作）

CRITICAL — 开始前必须先阅读 ../gitlink-shared/SKILL.md，其中包含认证、权限处理和 API 注意事项。 CRITICAL — 所有 Shortcuts 在执行写入/删除操作前，务必先确认用户意图。 CRITICAL — GitLink 操作只能用 gitlink-cli。禁止用 gh（GitHub CLI）操作 GitLink 资源。gh 仅适用于 GitHub 平台。

前置条件： 先阅读 ../gitlink-shared/SKILL.md 了解认证和全局参数。

Shortcuts

Shortcut	说明	需要认证
ci +builds	构建列表	是
ci +logs	构建日志	是
ci +restart	重启构建	是
ci +stop	停止构建	是
ci +activate	激活仓库 CI，先 dry-run	是
ci +deactivate	停用仓库 CI，先 dry-run	是
ci +authorize	查看 CI 授权状态	是

使用示例

# 查看构建列表
gitlink-cli ci +builds --owner myuser --repo myrepo

# 查看构建日志
gitlink-cli ci +logs --build 42 --stage 1 --step 1

# 重启构建
gitlink-cli ci +restart --build 42

# 停止构建
gitlink-cli ci +stop --build 42

# 查看 CI 授权状态
gitlink-cli ci +authorize --owner myuser --repo myrepo

# 激活仓库 CI，先预览再执行
gitlink-cli ci +activate --owner myuser --repo myrepo --dry-run
gitlink-cli ci +activate --owner myuser --repo myrepo --yes

# 停用仓库 CI，先预览再执行
gitlink-cli ci +deactivate --owner myuser --repo myrepo --dry-run
gitlink-cli ci +deactivate --owner myuser --repo myrepo --yes

注意事项

• ci +activate 和 ci +deactivate 会修改仓库 CI 状态，Agent 必须先执行 --dry-run 并获得用户确认，再加 --yes。
• ci +authorize 是只读查询，可直接执行。
• 在 Agent 场景建议统一加 --format json，便于解析构建状态和授权结果。