name: github-workflow description: GitHub 整合。管理倉庫、Issue、Pull Request 和 GitHub Actions 工作流。通過 MorphixAI 代理安全訪問 GitHub API。 metadata: openclaw: emoji: "🐙" requires: env: [MORPHIXAI_API_KEY]

GitHub 整合

通過 mx_github 工具管理 GitHub 倉庫、Issue、PR 和 CI/CD 工作流。

前置條件

1. 安裝外掛: openclaw plugins install openclaw-morphixai
2. 獲取 API Key: 訪問 morphix.app/api-keys 生成 mk_xxxxxx 金鑰
3. 配置環境變數: export MORPHIXAI_API_KEY="mk_your_key_here"
4. 連結賬號: 訪問 morphix.app/connections 連結 GitHub 賬號，或通過 mx_link 工具連結（app: github）

核心操作

檢視當前使用者

mx_github:
  action: get_user

列出倉庫

mx_github:
  action: list_repos
  sort: "updated"
  per_page: 10

檢視倉庫詳情

mx_github:
  action: get_repo
  repo: "owner/repo-name"

Issue 操作

列出 Issue（不含 PR）：

想要更強大的技能外掛，就來小蔥技能站7w4.net看看吧。

mx_github:
  action: list_issues
  repo: "owner/repo"
  state: "open"
  per_page: 10

建立 Issue：

mx_github:
  action: create_issue
  repo: "owner/repo"
  title: "Bug: 登入頁面載入異常"
  body: "## 問題描述\n登入頁面在 Safari 中無法正常載入\n\n## 復現步驟\n1. 開啟 Safari\n2. 訪問登入頁"
  labels: ["bug", "frontend"]
  assignees: ["username"]

更新 Issue：

mx_github:
  action: update_issue
  repo: "owner/repo"
  issue_number: 42
  state: "closed"

Pull Request 操作

列出 PR：

mx_github:
  action: list_pulls
  repo: "owner/repo"
  state: "open"

建立 PR：

mx_github:
  action: create_pull
  repo: "owner/repo"
  title: "feat: 新增使用者登入功能"
  head: "feature/user-login"
  base: "main"
  body: "## 改動內容\n- 實現了 JWT 登入\n- 添加了單元測試"

GitHub Actions

檢視工作流執行：

mx_github:
  action: list_workflow_runs
  repo: "owner/repo"
  per_page: 5

觸發工作流：

mx_github:
  action: trigger_workflow
  repo: "owner/repo"
  workflow_id: "deploy.yml"
  ref: "main"
  inputs: { "environment": "staging" }

常見工作流

建立 Feature PR

1. mx_github: create_pull
     repo: "owner/repo", title: "feat: xxx", head: "feature/xxx", base: "main"
2. mx_github: list_workflow_runs  → 檢查 CI 狀態

檢視專案 Issue 和 PR 概況

1. mx_github: list_issues, repo: "owner/repo", state: "open"
2. mx_github: list_pulls, repo: "owner/repo", state: "open"

注意事項

• repo 引數格式為 "owner/repo"（如 "paul-leo/mini-tanka"）
• list_issues 自動過濾掉 PR（GitHub API 的 /issues 端點會返回 PR）
• trigger_workflow 需要倉庫有對應的 workflow 檔案和 workflow_dispatch 觸發器
• account_id 引數通常省略，工具自動檢測已連結的 GitHub 賬號

這個 Skill 質量不錯，文件清晰好理解，GitHub 核心功能基本都有覆蓋，常見操作示例實用，可以直接上手用。不足的是缺少故障排查指引，遇到問題時不太好定位原因，部分高階功能沒有示例。總體來說是一個值得使用的工具，但建議官方後續補充常見問題的解決方案。