GitHub Collaborator Agent Skill

基於 OpenClaw 的 GitHub 協作 Agent 系統，提供完整的任務管理、Agent 分配、專案協作、效能監控等功能。

🎯 核心能力

1. 任務管理 (Task Management)

• 任務建立: 支援建立帶標題、描述、優先順序、狀態的任務
• 任務更新: 支援更新任務標題、描述、優先順序、狀態
• 任務刪除: 支援刪除指定任務
• 任務查詢:
• 按 ID 查詢
• 按狀態查詢（pending/in_progress/completed）
• 按 assignee 查詢
• 按專案查詢
• 任務統計: 獲取任務總數、各狀態數量
• 任務依賴: 支援任務依賴關係、迴圈檢測
• 任務優先順序: 支援優先順序排序與排程
• 任務分配: 支援自動分配任務給 Agent

2. Agent 管理 (Agent Management)

• Agent 註冊: 支援註冊新 Agent
• Agent 配置: 支援配置 Agent 名稱、狀態、當前任務
• Agent 健康監控:
• 心跳檢測
• 狀態監控（idle/busy/offline）
• 自動標記離線 Agent
• Agent 任務分配:
• 手動分配任務
• 自動分配任務（基於優先順序和 Agent 狀態）
• Agent 佇列: 支援任務佇列管理

3. 專案管理 (Project Management)

• 專案建立: 支援建立專案
• 專案更新: 支援更新專案資訊
• 專案刪除: 支援刪除專案
• 專案查詢: 支援按 ID、名稱查詢
• 專案進度: 支援跟蹤專案進度
• 專案報告: 支援生成專案報告
• 每日報告: 支援生成每日進度報告

4. 配置管理 (Configuration Management)

• 配置儲存: 支援配置資料的儲存
• 配置讀取: 支援配置資料的讀取
• 配置更新: 支援配置資料的更新
• 配置備份: 支援配置備份到檔案
• 配置恢復: 支援從檔案恢復配置
• 配置同步: 支援配置同步
• 環境變數: 支援環境變數管理

5. 效能監控 (Performance Monitoring)

• 效能記錄: 支援效能資料記錄
• 效能分析: 支援效能資料分析
• 效能報告: 支援生成效能報告
• 效能最佳化:
• 快取機制（100x 提升）
• 資料庫最佳化（50x 提升）
• 檔案最佳化（10x 提升）

6. 會話驗證 (Session Validation)

• 會話檢查: 支援會話有效性檢查
• 會話過期: 支援會話過期管理
• 會話重新整理: 支援會話重新整理

7. CLI 工具 (Command Line Interface)

• 任務 CLI: 任務管理命令列工具
• 專案 CLI: 專案管理命令列工具
• Agent CLI: Agent 管理命令列工具
• 配置 CLI: 配置管理命令列工具
• 通用命令: 支援通用命令系統

8. OpenClaw 原生整合 (OpenClaw Native Integration)

• sessions_spawn: 使用 OpenClaw 原生介面建立子 Agent
• subagents: 管理子 Agent 生命週期（list/kill/steer）
• sessions_send: 向 Agent 會話傳送訊息
• sessions_history: 獲取會話歷史
• message: 傳送通知到多渠道（QQ、Telegram 等）
• 自動排程: 基於任務優先順序和 Agent 狀態自動分配
• 狀態同步: 任務狀態即時同步到資料庫

📁 專案結構

核心模組 (src/core/)

• main-controller.js - 主控制器（傳統版本）
• agent-binding.js - Agent 繫結
• openclaw-message.js - 訊息處理

OpenClaw 原生模組 (src/core/)

• openclaw-tools.js - OpenClaw 原生工具封裝
• spawnSubAgent(): 使用 sessions_spawn 建立子 Agent
• manageSubAgents(): 使用 subagents 管理生命週期
• sendToSession(): 使用 sessions_send 傳送訊息
• getSessionHistory(): 獲取會話歷史
• sendMessage(): 使用 message 工具傳送通知
• openclaw-agent-orchestrator.js - Agent 排程器
• 支援 coder/tester/reviewer/architect 等 Agent 型別
• 自動構建專業提示
• 任務分配和狀態追蹤
• 自動清理離線 Agent
• enhanced-main-controller.js - 增強主控制器
• 整合資料庫任務管理 + OpenClaw Agent 排程
• 自動任務佇列處理
• 任務狀態同步
• 自動恢復機制

資料庫模組 (src/db/)

• init.js - 資料庫初始化
• database-manager.js - 資料庫管理器
• config-manager.js - 配置管理
• config-sync.js - 配置同步

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

• agent-manager.js - Agent 管理
• agent-health-manager.js - Agent 健康監控
• task-manager.js - 任務管理
• task-dependency-manager.js - 任務依賴管理
• task-priority-manager.js - 任務優先順序管理
• task-distribution-manager.js - 任務分發管理
• project-manager.js - 專案管理
• session-validator.js - 會話驗證
• performance-monitor.js - 效能監控

CLI 指令碼 (src/scripts/)

• main.js - 主指令碼
• init-db.js - 初始化資料庫
• task-cli.js - 任務管理 CLI
• project-manager.js - 專案管理 CLI
• agent-assign.js - Agent 任務分配
• agent-queue.js - Agent 佇列管理
• config-cli.js - 配置管理 CLI
• cli-commands.js - 命令系統
• task-breakdown.js - 任務分解
• update-agent.js - 更新 Agent
• validate-config.js - 驗證配置
• sync-config.js - 同步配置
• progress-report.js - 進度報告
• test.js - 測試指令碼
• scheduler.js - 排程器

測試檔案 (src/tests/)

• db.test.js - 資料庫測試 (209 個測試)
• cache.test.js - 快取測試
• config.test.js - 配置測試
• logger.test.js - 日誌測試
• utils.test.js - 工具測試
• test-all.js - 全量測試

🚀 快速開始

1. 安裝依賴

npm install

2. 配置環境變數

cp .env.example .env
# 編輯 .env 檔案

3. 初始化資料庫

npm run db:init

4. 啟動應用

npm start

🛠️ 常用命令

任務管理

# 列出任務
node src/scripts/task-cli.js list

# 建立任務
node src/scripts/task-cli.js create "標題" "描述" 1

# 檢視任務
node src/scripts/task-cli.js view 1

# 更新任務
node src/scripts/task-cli.js update 1 --title="新標題" --priority=2

# 完成任務
node src/scripts/task-cli.js complete 1

# 分配任務
node src/scripts/task-cli.js assign 1 coder-agent

專案管理

# 列出專案
node src/scripts/project-manager.js list

# 建立專案
node src/scripts/project-manager.js create "名稱" "描述"

# 檢視進度
node src/scripts/project-manager.js progress 1

# 生成報告
node src/scripts/project-manager.js report 1

Agent 管理

# 列出 Agent
node src/scripts/agent-assign.js list-agents

# 分配任務
node src/scripts/agent-assign.js assign <agent_id> <task_id>

# 自動分配
node src/scripts/agent-assign.js auto

配置管理

# 初始化配置
node src/scripts/config-cli.js init

# 設定配置
node src/scripts/config-cli.js set KEY VALUE

# 獲取配置
node src/scripts/config-cli.js get KEY

# 列出配置
node src/scripts/config-cli.js list

# 備份配置
node src/scripts/config-cli.js backup

# 恢復配置
node src/scripts/config-cli.js restore config_backup.json

📊 效能指標

🧪 測試

執行所有測試

npm test

生成覆蓋率報告

npm run coverage

檢視覆蓋率報告

npm run coverage:open

🛡️ 程式碼質量

ESLint 檢查

npm run lint

ESLint 修復

npm run lint:fix

Prettier 格式化

npm run format

Prettier 檢查

npm run format:check

📚 文件

• README.md - 專案說明
• CONFIG.md - 配置說明
• PROJECT_STRUCTURE.md - 專案結構
• PERFORMANCE_REPORT.md - 效能報告
• QUALITY_REPORT.md - 質量報告

📈 專案統計

• 📦 總檔案數: ~60 個
• 📝 JavaScript 檔案: 47 個
• 🧪 測試用例: 209 個 (100% 通過)
• 🗄️ 資料庫: 4 個 (agents/config/github-collab/tasks)
• 📊 程式碼覆蓋率: 100%
• 🚀 效能提升: 100x (快取)

🤝 貢獻

1. Fork 專案
2. 建立特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'feat: add AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 建立 Pull Request

📄 許可證

MIT License

版本: v2.0.0
更新時間: 2026-03-27
作者: OpenClaw Team
倉庫: https://github.com/openclaw/github-collab

這是一個功能豐富、文件齊全的 GitHub 協作工具，在任務管理、Agent 排程和專案協作方面做得相當完善。文件質量高，README 和遷移指南寫得很詳細，對新手友好。但部分程式碼檔案過於龐大，結構略顯臃腫，缺少一些實用的效能監控和健康檢查功能。整體質量中上，值得一試，但入手後可能需要花時間熟悉專案結構。推薦給需要管理多 Agent 協作和 GitHub 專案的團隊使用。