CLI Python không phụ thuộc để tạo và liệt kê pull request GitHub, kiểm tra trạng thái commit và đẩy một tệp duy nhất thông qua Git Data API.
Cài đặt & Tải xuống
1. ClawHub CLI
Cách nhanh nhất để cài đặt kỹ năng trực tiếp từ thư viện.
npx clawhub@latest install github-workflow-integration
2. Cài đặt Thủ công
Sao chép thư mục kỹ năng vào một trong những vị trí sau
~/.openclaw/skills/ <project>/skills/ Ưu tiên: Không gian làm việc > Cục bộ > Gói sẵn
3. Cài đặt Prompt
Sao chép prompt này vào OpenClaw để tự động cài đặt.
Giúp tôi cài đặt github-workflow-integration bằng Clawhub. Nếu Clawhub chưa
Bạn muốn tải xuống?
Nhận các tệp kỹ năng gốc dưới dạng lưu trữ ZIP.
Tích hợp quy trình làm việc GitHub là gì?
Tích hợp quy trình làm việc GitHub là trình bao dòng lệnh nhẹ cho một số thao tác GitHub REST API, được xây dựng cho Python 3.8+ và chỉ sử dụng thư viện chuẩn. Công cụ có thể tạo và liệt kê pull request, truy vấn trạng thái commit tổng hợp và đẩy một tệp duy nhất theo trình tự Git Data API: blob → tree → commit → ref. Người dùng Openclaw Skills có thể tự động hóa các quy trình này mà không cần cài đặt Git, GitHub CLI hoặc gói Python của bên thứ ba.
Xác thực sử dụng Personal Access Token do người dùng cung cấp, được đọc từ GITHUB_TOKEN khi chạy lệnh. Token không được lưu hoặc in ra. Có thể xem trước thao tác ghi bằng --dry-run; người dùng nên xác nhận kho lưu trữ, nhánh và thông báo đích trước khi thực hiện thay đổi từ xa. Đây là một tích hợp chuyên biệt, không phải ứng dụng khách GitHub đa năng.
Trường hợp sử dụng Tích hợp quy trình làm việc GitHub
- Tạo pull request từ tập lệnh mà không cần cài đặt CLI
gh. - Liệt kê pull request đang mở và trả về số, tiêu đề, nhánh cùng URL của chúng.
- Kiểm tra trạng thái tổng hợp của commit hoặc ref để xem kết quả CI.
- Dùng Git Data API để đẩy một tệp cục bộ lên nhánh từ xa từ tác vụ CI hoặc môi trường bị hạn chế.
- Xem trước yêu cầu ghi bằng
--dry-runtrước khi thay đổi trạng thái kho lưu trữ. - Sử dụng các thao tác GitHub REST API trong môi trường Python không có phụ thuộc bên thứ ba.
Cách thức hoạt động của Tích hợp quy trình làm việc GitHub
- Kiểm tra
GITHUB_TOKENđã được đặt chưa. Nếu thiếu, CLI thoát với mã 2 và cung cấp hướng dẫn thiết lập thay vì thử gửi yêu cầu không xác thực. - Gọi lệnh phù hợp với
owner\/repođích và các tùy chọn bắt buộc:pr create,pr list,statushoặcpush-file. - Với thao tác ghi, trước tiên hãy chạy bằng
--dry-runvà xác nhận kho lưu trữ, nhánh cùng thông báo trước khi gửi yêu cầu thực tế. - CLI Python gửi yêu cầu đến GitHub REST API. Khi đẩy một tệp, công cụ tạo blob, tree và commit, sau đó cập nhật ref đích.
- Xem kết quả: lệnh thành công trả về thông tin dễ đọc như số hoặc URL PR, trạng thái hoặc SHA commit. Lỗi API và lỗi mạng được báo cáo riêng.
- Xử lý mã thoát:
0là thành công,1là lỗi API hoặc mạng và2là lỗi sử dụng hoặc thiếu token. Mã 401 có thể cho biết token đã hết hạn hoặc thiếu phạm vi quyền; mã 404 có thể cho biết kho lưu trữ hoặc nhánh không chính xác.
Cài đặt Tích hợp quy trình làm việc GitHub
Yêu cầu
- Python 3.8 trở lên.
- Không cần cài đặt gói Python của bên thứ ba, Git hoặc GitHub CLI.
- GitHub Personal Access Token (PAT) có phạm vi
repocần thiết cho các thao tác đích. Skill này dùng xác thực PAT, không dùng OAuth.
Cấu hình xác thực
Tạo PAT trong GitHub tại Settings → Developer settings → Personal access tokens, sau đó cung cấp token qua biến môi trường GITHUB_TOKEN. Không commit token hoặc đưa token vào đầu ra lệnh.
export GITHUB_TOKEN="<your-personal-access-token>"
python3 scripts\/gh_workflow.py pr list --repo owner\/repo
Chạy lệnh
Sử dụng điểm vào scripts\/gh_workflow.py của skill. Với thao tác ghi, trước tiên hãy xem trước và xác minh đích được yêu cầu trước khi chạy mà không có --dry-run.
python3 scripts\/gh_workflow.py pr create --repo owner\/repo --title "Fix bug" --head fix --base main --body "details" --dry-run
python3 scripts\/gh_workflow.py status --repo owner\/repo --ref main
python3 scripts\/gh_workflow.py push-file --repo owner\/repo --path .\/local.txt --message "add local.txt" --branch main
Lược đồ dữ liệu & Hệ thống phân loại của Tích hợp quy trình làm việc GitHub
Skill này là CLI không lưu trạng thái: không định nghĩa cơ sở dữ liệu cục bộ, tệp siêu dữ liệu được tạo hoặc nơi lưu token. Đầu vào là đối số dòng lệnh và kết quả được ghi dưới dạng dễ đọc.
| Thành phần | Chi tiết |
|---|---|
| Điểm vào | scripts\/gh_workflow.py |
| Môi trường chạy | Python 3.8+; chỉ thư viện chuẩn |
| Xác thực | Biến môi trường GITHUB_TOKEN, được đọc tại thời điểm gọi |
| Mã định danh kho lưu trữ | owner\/repo |
| Lệnh | pr create, pr list, status, push-file |
| Chạy thử | --dry-run xem trước cấu trúc yêu cầu mà không gửi yêu cầu |
| Đầu ra | Chi tiết PR, trạng thái, SHA commit hoặc thông tin lỗi |
| Mã thoát | 0 thành công; 1 lỗi API/mạng; 2 lỗi sử dụng hoặc thiếu token |
Với push-file, quy trình Git Data API tạo blob, xây dựng tree, tạo commit và cập nhật ref. Token không được ghi vào đĩa, ghi nhật ký hoặc hiển thị lại.
Tính năng Nâng cao của Tích hợp quy trình làm việc GitHub
- Truy cập API không phụ thuộc: sử dụng khả năng kết nối mạng của thư viện chuẩn Python, không cần gói bên thứ ba hoặc tiến trình con.
- Đẩy một tệp qua Git Data API: ghi tệp lên nhánh từ xa theo trình tự blob → tree → commit → ref, hữu ích khi không thể dùng thao tác đẩy Git thông thường.
- Xem trước khi chạy thử: kiểm tra cấu trúc yêu cầu trước khi gửi các thao tác ghi được hỗ trợ.
- Ranh giới xác thực rõ ràng: yêu cầu PAT do người dùng tạo trong
GITHUB_TOKEN; không khởi chạy OAuth hoặc mở trình duyệt. - Xử lý lỗi hữu ích: phân biệt lỗi API/mạng với lỗi sử dụng và lỗi thiếu token, đồng thời cung cấp mã thoát cho tập lệnh.
- Phạm vi tập trung: hỗ trợ tạo và liệt kê PR, trạng thái commit tổng hợp và đẩy một tệp. Không xử lý merge, bình luận đánh giá, bản phát hành, kích hoạt workflow hoặc cài đặt GitHub App.
- Phù hợp với Openclaw Skills: cung cấp khối chức năng quy trình GitHub gọn nhẹ cho tập lệnh và tác vụ CI, nơi cần giảm thiểu phụ thuộc và tránh lưu thông tin xác thực lâu dài.
SKILL.md
Đang tải
Các kỹ năng Openclaw liên quan
llms-generator
Tạo hướng dẫn dự án có cấu trúc LLMs.txt v2, giúp các tác nhân AI khám phá và hiểu dự án của bạn.
Ngân sách token ngữ cảnh
Ước tính mức sử dụng ngữ cảnh AI và áp dụng ngân sách token theo cơ chế thất bại an toàn trước khi prompt vượt quá giới hạn.
Ma trận rủi ro ISO 14971
Trợ lý Python CLI dùng để chấm điểm rủi ro của thiết bị y tế, xem xét các tùy chọn kiểm soát theo ISO 14971:2019 và kiểm tra tính đầy đủ của tệp quản lý rủi ro.
Base Gas
Base Gas provides live and historical network fee data to estimate transaction costs, compare chains, and decide when to transact.
The Yard
Kỹ năng The Yard cho phép bot OpenClaw tham gia bảng tin chỉ dành cho bot của Stackyard để đọc, đăng bài, trả lời và bình chọn bằng HTTPS.
Trình tạo khung Skill
Dùng một lệnh Python để tạo bộ khung khởi đầu AI skill có cấu trúc, phù hợp với LGD, bao gồm SKILL.md, AGENTS.md và các thư mục đích.
Đặc sắc*
