Worker 的幾種用法

Loadout：Worker 的能力組件

每個 Worker 可以透過 loadout 選配三種能力組件，就像裝備一樣——不需要的不裝，需要的隨時加入。

現有共用組件一覽

怎麼挑？

YAML 宣告方式

loadout:
  skills:
    - common/cluster-kb-lookup
    - common/cluster-kb-record
    - common/cluster-kb-roster
    - common/sync-html-to-ccms    # 選配
  hooks:
    - common/cluster-kb           # 自動 lookup + record（UserPromptSubmit + Stop）
    - common/worker-memory        # 跨 session 記憶（需搭配 memory.enabled: true）
  mcp:
    - common/session-manager      # 僅 orchestrator worker 需要
  agents: []

開始使用

透過網頁 Chat Mode 與 AI Worker 對話，只需登入就能開始。

登入方式

• LINE OTP（推薦）— 輸入手機號碼，LINE 會收到一次性驗證碼
• 帳號密碼 — 管理員設定的帳號

進入 Chat Mode

1. 打開 CCMS 網頁

   前往 https://claude2-agent.jgames888.com，用 LINE OTP 或帳號密碼登入。

2. 選擇 Worker

   在 Lobby 看到所有 Worker Session，點「進入」進入對話，或讓系統自動路由。

3. 描述你的需求

   直接輸入你想做的事，AI 會回覆並開始處理。不需要特殊格式。

4. 等待完成

   AI 處理中會即時顯示進度，完成後告知結果。

實用指令

Worker 是什麼？

Worker 是你的 AI 專案負責人：知道自己負責什麼、會自動拿最新程式碼、記得上次做了什麼、遇到超出範圍的事會轉介給對的人。

一般 AI 助理 vs Worker

Worker 的四個核心元素

實際案例：遊戲開發 Worker

以 sps-worker-102006 為例，這是負責 slot 遊戲 102006 開發的 Worker：

name: sps-worker-102006
cluster: spsconsole              # 加入 spsconsole cluster，與其他遊戲 Worker 共享知識

cluster_scope: |
  【負責】slot 遊戲 102006 的 RD 開發：程式實作、RTP 驗算、場景測試
  【不負責】其他遊戲編號的任務

git:
  repo: https://user:[email protected]/slot-probability-console.git
  branch: feature/worker-102006
  auto_pull: true                # 每次啟動自動 git pull

routing:
  pattern: '102006'              # 訊息含「102006」自動路由到這個 Worker

loadout:
  hooks:
    - common/kb-lookup           # 啟動時自動查 wiki 前例
    - common/kb-recorder         # 停止時自動記錄任務摘要
  skills:
    - sps/jlh5/slot-full-pipeline    # 遊戲開發全流程 skill
    - common/cluster-kb-lookup

同一 Cluster 的 Workers 如何協作

建立你的 Worker

為你的專案建立一個專屬 Worker，只需要一個 worker-profile.yaml 設定檔。以下是完整的設定流程。

設定步驟

1. 決定 Worker 的角色（最重要）

   想清楚這個 Worker 負責什麼（例如：某個遊戲的 RD 開發）、不負責什麼（例如：其他遊戲的任務）。這是 cluster_scope 的內容，直接決定 AI 的行為邊界。

2. 設定 git repo（讓 Worker 接管你的專案）

   填入程式碼庫的 URL（帶認證 token）、要跟蹤的 branch，並設定 auto_pull: true。Worker 啟動時會自動 clone/pull 最新版本。建議為每個 Worker 建立一個專屬 branch（例如 feature/worker-102006）。

3. 加入 Cluster

   多個 Worker 圍繞同一個系統時，讓它們加入相同的 cluster（例如所有 SPS 開發 Worker 都加入 spsconsole）。同 Cluster 的 Workers 共享知識庫。

4. 加入知識庫 Hook

   在 loadout.hooks 加入 kb-lookup（啟動時查知識庫）和 kb-recorder（停止時記錄），讓 Worker 自動累積任務經驗。

5. 設定路由規則

   在 routing.pattern 設定關鍵字，讓含有特定字詞的訊息自動路由到這個 Worker。例如遊戲編號 102006，或系統名稱 myproject。

6. 請 ccms-IT-worker 協助部署

   把設定完的 worker-profile.yaml 交給 ccms-IT-worker，它會協助部署到 CCMS 系統。

完整的 worker-profile.yaml 範例

name: my-worker                  # Worker 唯一名稱（英文、連字號）
cluster: my-cluster              # 所屬 Cluster（同 cluster 共享知識庫）
type: work

cluster_scope: |
  【負責】[你的專案名] 的功能開發、Bug fix、程式碼修改。
  【不負責】[不在你負責範圍的事項]。

description: 一句話說明這個 Worker 的角色

scope: user                      # user = 每個人有自己的 session
                                 # shared = 所有人共用一個 session

routing:
  pattern: 'keyword1|keyword2'   # 包含這些關鍵字的訊息自動路由過來
  confidence: 0.85

git:
  repo: https://user:[email protected]/your/repo.git
  branch: feature/my-worker     # 建議建 Worker 專屬 branch
  path: repo                    # clone 到 Worker 目錄下的 repo/ 子目錄
  auto_pull: true               # 每次啟動自動 git pull

loadout:
  hooks:
    - common/kb-lookup          # 啟動時查知識庫
    - common/kb-recorder        # 停止時記錄知識庫
  skills:
    - common/cluster-kb-lookup
    - common/cluster-kb-record
    - common/cluster-kb-roster

接管專案與 Cluster

Worker 最強大的地方：每次啟動自動拉最新程式碼，然後帶著 Cluster 知識庫的歷史記錄開始工作。

Worker 如何接管你的程式碼

在 worker-profile.yaml 設定 git 區塊後，Worker 第一次啟動時自動 clone repo，之後每次啟動時自動 git pull 更新，不需要手動管理：

git:
  repo: https://user:[email protected]/your-team/your-project.git
  branch: feature/my-worker     # 建議建 Worker 專屬 branch
  path: repo                   # clone 到 Worker 工作目錄下的 repo/ 子目錄
  auto_pull: true

Cluster 的設計邏輯

Cluster 是一組圍繞同一個系統或業務的 Workers。同一 Cluster 的 Workers：

• 共享同一個知識庫（raw/ + wiki/）
• 透過 cluster-kb-roster skill 互相查詢、決定轉介
• 通常有一個 Librarian Worker 負責定期整理知識

不同類型的 Worker 建議設定

Worker 啟動的完整流程

知識庫怎麼用

知識庫讓 AI Worker 不需要每次都從零開始。任務完成後自動記錄，下次遇到類似問題時自動調用歷史經驗。

整體運作流程

啟用知識庫：加這兩個 Hook

loadout:
  hooks:
    - common/kb-lookup     # 啟動時查知識庫
    - common/kb-recorder   # 結束時記錄知識庫
  skills:
    - common/cluster-kb-lookup
    - common/cluster-kb-record
    - common/cluster-kb-roster

AI 也可以主動操作知識庫

除了 Hook 自動觸發，AI 遇到需要時會主動呼叫以下 Skill：

raw 和 wiki 的差別

Skills 與 Hooks

透過 Skills 和 Hooks，可以讓 Worker 擁有特定能力或自動行為，不需要每次都手動操作。

Skills — 給 Worker 領域知識

Skill 是一組指令集，告訴 AI 在特定情境下該怎麼做。和一般 prompt 的差別是：Skill 是結構化的，可以組合、版本控制、在多個 Worker 間共享。

Hooks — 讓特定事情自動發生

Hook 在特定時機自動觸發，不需要 AI 主動決定。

在 worker-profile.yaml 設定

loadout:
  skills:
    - common/cluster-kb-lookup      # 讓這個 Worker 能查知識庫
    - common/cluster-kb-record      # 讓這個 Worker 能記錄知識
    - common/cluster-kb-roster      # 讓這個 Worker 能查名冊轉介
    - my-domain/my-special-skill    # 專案專屬技能
  hooks:
    - common/kb-lookup              # 啟動時自動查知識庫
    - common/kb-recorder            # 結束時自動記錄

CCMS 內建 Workers

CCMS 本身也用 Worker 設計來管理和維護系統。以下是目前部署的 CCMS 維護 Workers，它們的設計同樣遵循「角色定義 + 知識庫 + Loadout」的模式。

不知道找哪個 Worker？

Worker 轉介流程

當 Worker 判斷任務超出自身範圍，會這樣做：

常見任務指南

幾個常見情境的處理方式，讓你快速上手。

我想讓 AI 負責我的專案開發

我想修改 CCMS 系統功能

系統出問題了，我不知道根因

我想讓 AI 記住某些知識，以後自動用

Worker 好像卡住了

被路由到錯的 Worker

我想回報 Bug 或功能需求