Github Actions Trigger

🚀 GitHub 動作指南

本指南詳細介紹瞭如何使用相關工具與 GitHub Actions 進行交互，幫助您更好地自動化開發流程。

🚀 快速開始

🔍 獲取 GitHub Action 信息

使用 get_github_action 工具獲取特定 GitHub Action 的詳細信息。

請求格式

{
  "owner": "actions",
  "repo": "checkout",
  "ref": "v4"
}

響應示例

{
  "name": "Checkout",
  "description": "Check out a Git repository at a particular version",
  "author": "GitHub",
  "inputs": [
    {
      "name": "repository",
      "description": "Repository name with owner. For example, actions/checkout",
      "default": "",
      "required": false
    },
    {
      "name": "ref",
      "description": "The branch, tag or SHA to checkout.",
      "default": "",
      "required": false
    }
  ],
  "runs": {
    "using": "node20",
    "main": "dist/index.js"
  }
}

🚀 觸發 GitHub 工作流

使用 trigger_github_action 工具觸發特定的 GitHub 工作流。

請求格式

{
  "owner": "username-or-org",
  "repo": "repository-name",
  "workflow_id": "ci.yml",
  "inputs": {
    "deploy_environment": "production",
    "debug_enabled": "true"
  }
}

響應示例

{
  "success": true,
  "message": "Workflow dispatch event triggered successfully",
  "run": {
    "id": 12345678,
    "url": "https://github.com/owner/repo/actions/runs/12345678",
    "status": "queued",
    "conclusion": null,
    "created_at": "2025-03-19T06:45:12Z",
    "triggered_by": "API"
  }
}

注意事項

⚠️ 重要提示

1. 工作流必須配置為支持 workflow_dispatch 事件。
2. GitHub 令牌必須具有 workflow 範圍權限。
3. 輸入參數必須與工作流定義的參數匹配。

🔎 獲取倉庫中的 GitHub Actions

使用 get_github_actions 工具列出特定倉庫中的所有可用 GitHub Actions。

請求格式

{
  "owner": "actions",
  "repo": "checkout"
}

響應示例

{
  "count": 1,
  "actions": [
    {
      "name": "Checkout",
      "description": "Check out a Git repository at a particular version",
      "author": "GitHub",
      "inputs": [
        {
          "name": "repository",
          "description": "Repository name with owner. For example, actions/checkout",
          "default": "",
          "required": false
        },
        {
          "name": "ref",
          "description": "The branch, tag or SHA to checkout.",
          "default": "",
          "required": false
        }
      ],
      "runs": {
        "using": "node20",
        "main": "dist/index.js"
      }
    }
  ]
}

📦 獲取最新的兩個發行版

使用 get_github_release 工具獲取倉庫的最新兩個發行版本。

請求格式

{
  "owner": "actions/runner",
  "repo": "runners"
}

響應示例

[
  {
    "tag_name": "2.286.0",
    "name": "GitHub Hosted Runner for Windows release 2.286.0",
    "body": "New release of GitHub Hosted Runner for Windows.",
    "published_at": "2024-03-19T15:00:00Z"
  },
  {
    "tag_name": "2.285.0",
    "name": "GitHub Hosted Runner for Windows release 2.285.0",
    "body": "New release of GitHub Hosted Runner for Windows.",
    "published_at": "2024-03-18T15:00:00Z"
  }
]

注意事項

⚠️ 重要提示

• 默認情況下，該工具會返回最新的兩個發行版本。
• 如果需要更多或更少的發行版本，請調整請求參數。

通過這些工具和示例，您可以更好地理解和使用 GitHub Actions 來自動化您的開發流程。