CI/CD编排工具 - GitHub Actions自动化管理、预览URL提取与快速失败检测

CI Orchestration by constellos/claude-code-plugins

6 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/constellos/claude-code-plugins --skill 'CI Orchestration'

自动化开发运维测试

🇨🇳中文介绍

CI 编排

通过快速失败错误检测和预览 URL 提取，实现全面的 CI/CD 工作流管理。

目的

CI 编排提供对 GitHub Actions 和其他 CI 系统的显式控制。监控检查状态、提取预览 URL、调试故障，并使用智能快速失败模式管理工作流重试。

使用场景

实时等待 CI 检查状态
提取预览部署 URL（Vercel、Netlify）
调试 CI 故障
重试失败的工作流
在复杂工作流中管理 CI

核心功能

检查 CI 状态

# Check PR status
gh pr checks 42

# Watch and wait
gh pr checks 42 --watch

# Get JSON output
gh pr view 42 --json statusCheckRollup

提取预览 URL

现有的 ci-status.ts 工具提供了全面的预览 URL 提取功能：

import { extractPreviewUrls } from '../shared/hooks/utils/ci-status.js';

// Extract from CI output
const urls = extractPreviewUrls(ciOutput);
// Returns: { web: 'https://...', marketing: 'https://...' }

快速失败模式

# Wait with fail-fast
awaitCIWithFailFast "$PWD" 42 10  # 10 minute timeout

# Detects:
# - Merge conflicts
# - Branch divergence
# - Failed checks
# - Workflow errors

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

重试失败的检查

# Get latest workflow run
RUN_ID=$(gh run list --branch $(git branch --show-current) --limit 1 --json databaseId -q '.[0].databaseId')

# Re-run failed jobs
gh run rerun $RUN_ID --failed

钩子	行为
await-pr-status	在 `gh pr create` 后等待 CI
commit-task-await-ci-status	在 SubagentStop 时自动提交并检查 CI
commit-session-await-ci-status	在 Stop 时进行阻塞式 CI 检查

来自 ci-status.ts：

awaitCIWithFailFast(cwd, prNumber, timeout) - 使用快速失败模式等待
extractPreviewUrls(output) - 解析 Vercel/Netlify URL
getLatestCIRun(cwd, branch) - 获取工作流运行 ID
formatCiChecksTable(checks) - 格式化为 Markdown 表格

等待 CI 并获取预览 URL

# Create PR
PR=$(gh pr create --title "Add feature" --body "..." --json number -q .number)

# Wait for CI
awaitCIWithFailFast "$PWD" $PR 10

# Extract preview URLs
CHECKS=$(gh pr view $PR --json statusCheckRollup -q '.statusCheckRollup')
PREVIEW=$(extractPreviewUrls "$CHECKS")

echo "Preview: $PREVIEW"

# Get failed checks
gh pr checks 42 --json name,conclusion,detailsUrl \
  --jq '.[] | select(.conclusion=="FAILURE") | {name, url: .detailsUrl}'

# View logs
gh run view $(gh run list --limit 1 --json databaseId -q '.[0].databaseId') --log-failed

使用退避策略重试

MAX_RETRIES=3
RETRY=0

while [ $RETRY -lt $MAX_RETRIES ]; do
  if gh pr checks $PR --watch; then
    echo "✓ CI passed"
    break
  fi

  RETRY=$((RETRY + 1))
  if [ $RETRY -lt $MAX_RETRIES ]; then
    echo "Retry $RETRY/$MAX_RETRIES..."
    gh run rerun $(gh run list --limit 1 --json databaseId -q '.[0].databaseId') --failed
  fi
done

使用快速失败模式（10分钟超时）
提取并分享预览 URL
自动重试暂时性故障（最多3次）
解析日志以获取可操作的错误信息
使用 CI 状态更新 PR 评论

🇺🇸English

CI Orchestration

Comprehensive CI/CD workflow management with fail-fast error detection and preview URL extraction.

Purpose

CI Orchestration provides explicit control over GitHub Actions and other CI systems. Monitor check status, extract preview URLs, debug failures, and manage workflow retries with intelligent fail-fast patterns.

When to Use

Waiting for CI checks with real-time status
Extracting preview deployment URLs (Vercel, Netlify)
Debugging CI failures
Retrying failed workflows
Managing CI in complex workflows

Core Capabilities

Check CI Status

# Check PR status
gh pr checks 42

# Watch and wait
gh pr checks 42 --watch

# Get JSON output
gh pr view 42 --json statusCheckRollup

Extract Preview URLs

The existing ci-status.ts utility provides comprehensive preview URL extraction:

import { extractPreviewUrls } from '../shared/hooks/utils/ci-status.js';

// Extract from CI output
const urls = extractPreviewUrls(ciOutput);
// Returns: { web: 'https://...', marketing: 'https://...' }

Fail-Fast Patterns

# Wait with fail-fast
awaitCIWithFailFast "$PWD" 42 10  # 10 minute timeout

# Detects:
# - Merge conflicts
# - Branch divergence
# - Failed checks
# - Workflow errors

Retry Failed Checks

# Get latest workflow run
RUN_ID=$(gh run list --branch $(git branch --show-current) --limit 1 --json databaseId -q '.[0].databaseId')

# Re-run failed jobs
gh run rerun $RUN_ID --failed

Integration with Hooks

Hook	Behavior
await-pr-status	Waits for CI after `gh pr create`
commit-task-await-ci-status	Auto-commits and checks CI on SubagentStop
commit-session-await-ci-status	Blocking CI check on Stop

Utilities

From ci-status.ts:

awaitCIWithFailFast(cwd, prNumber, timeout) - Wait with fail-fast
extractPreviewUrls(output) - Parse Vercel/Netlify URLs
getLatestCIRun(cwd, branch) - Get workflow run ID
formatCiChecksTable(checks) - Format as markdown table

Examples

Wait for CI with Preview URLs

# Create PR
PR=$(gh pr create --title "Add feature" --body "..." --json number -q .number)

# Wait for CI
awaitCIWithFailFast "$PWD" $PR 10

# Extract preview URLs
CHECKS=$(gh pr view $PR --json statusCheckRollup -q '.statusCheckRollup')
PREVIEW=$(extractPreviewUrls "$CHECKS")

echo "Preview: $PREVIEW"

Debug Failed CI

# Get failed checks
gh pr checks 42 --json name,conclusion,detailsUrl \
  --jq '.[] | select(.conclusion=="FAILURE") | {name, url: .detailsUrl}'

# View logs
gh run view $(gh run list --limit 1 --json databaseId -q '.[0].databaseId') --log-failed

Retry with Backoff

MAX_RETRIES=3
RETRY=0

while [ $RETRY -lt $MAX_RETRIES ]; do
  if gh pr checks $PR --watch; then
    echo "✓ CI passed"
    break
  fi

  RETRY=$((RETRY + 1))
  if [ $RETRY -lt $MAX_RETRIES ]; then
    echo "Retry $RETRY/$MAX_RETRIES..."
    gh run rerun $(gh run list --limit 1 --json databaseId -q '.[0].databaseId') --failed
  fi
done

Best Practices

Use fail-fast patterns (10min timeout)
Extract and share preview URLs
Auto-retry transient failures (max 3 times)
Parse logs for actionable errors
Update PR comments with CI status

Weekly Installs

Repository

constellos/clau…-plugins

GitHub Stars

First Seen

Jan 1, 1970

Security Audits

Gen Agent Trust HubFail SocketPass SnykWarn