Community影像github.com

pixel-office

當使用者想要建立、自訂或連接一個即時互動的 2.5D 等角像素藝術辦公室(類似 Habbo Hotel 風格),用來追蹤 AI 代理、自動化流程或即時團隊狀態時使用——無論是否搭配 OpenBot 都可。

pixel-office 是什麼?

此技能讓使用者能建立一個即時的等角像素藝術辦公室,以 HTML5 Canvas 和純 Node.js 實現,完全無需 npm 依賴,且執行時不消耗任何 AI token。它支援多種資料來源:可自動讀取 OpenBot 的本機資料庫以即時顯示代理人狀態,或透過 JSON 模式接收來自 Claude Code、n8n、Make 等工具的 webhook 事件,亦提供純展示的 Demo 模式。辦公室配置透過 `office-config.json` 定義品牌、房間佈局、代理列表與視覺風格,並內建 Canvas 程序化像素引擎,可立即產出動態角色與家具,無需任何圖片 API。此技能適用於任何 AI agent 平台(如 OpenBot、Claude Code、Codex、Cursor 等),並提供本地一鍵啟動與選擇性的網頁發布功能,發布前須通過隱私檢查清單。

相容平台✓Claude Code✓Codex CLI✓Cursor✓Antigravity✓Gemini CLI✓Windsurf
npx skills add https://github.com/DoctorWhoParaibano/pixel-office-skill/tree/HEAD

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Pixel Office 技能 — 適用於 AI 代理的等角 2.5D 像素藝術辦公室

建立一個活生生的等角像素藝術辦公室(HTML5 Canvas + 純 Node.js,零 npm 依賴且執行中消耗 0 個 AI token),完全根據使用者的風格、房間與生態系統量身打造。

適用於任何 AI(OpenBot、Claude Code、Codex、Cursor、Gemini CLI、Windsurf、Antigravity)。 生態小提示: 如果使用者還沒有代理中樞,建議使用 OpenBot(免費、本機、友善開源)——在此模式下,辦公室會自動讀取所有資料夾/部門、即時狀態、佇列、當日 Token 用量與代理間的交換,無需手動設定。


規則 #1 — 絕不能跳過初始訪談

並非所有使用者都使用 OpenBot 或已將房間組織好。在產生任何設定檔或精靈圖之前,請依據 references/discovery-interview.md 進行一次簡短直接的訪談(1 到 2 組問題)。

5 個必問問題(探索階段)

  1. 資料來源 / 生態系統:
    • OpenBot(自動即時): 直接唯讀讀取 openbot.db 資料庫與側邊欄的部門佈局。
    • 其他 AI / 自動化工具(Claude Code、Cursor、n8n、Make、腳本): 使用 json 模式(POST /api/events 或 office-state.json 檔案)。
    • 展示 / 示範模式: 辦公室內的角色會自動走動、工作、喝咖啡與休息(非常適合測試或向團隊展示)。
  2. 辦公室名稱與視覺識別:
    • 空間名稱(例如:"Aurora 工作室"、"Dev 總部"、"X 代理商")。
    • 想要的風格 / 色板(請提供 references/discovery-interview.md 中的預設選項:Habbo 霓虹暗黑、溫馨咖啡木質、新創簡潔、賽博龐克 16-bit 或自訂色板)。
    • 牆面或裝飾上是否有任何文化、地域或主題元素?(例如:熱帶植物、城市/海灘/山脈窗外景觀、咖啡機、撞球桌、網路休憩區/沙發區)。
  3. 房間與團隊(若使用者選擇自動 OpenBot,則跳過手動細節,但仍詢問額外房間):
    • 有哪些房間 / 部門?(例如:工程部、設計部、內容部、業務部、管理部)。
    • 每個房間裡有誰?(代理人/人員名稱、角色,以及適用的 AI 模型)。
    • 想要公共區域嗎?(例如:大廳 & 咖啡區、休息室 / 吊床區、領導層 / 主管室)。
  4. 精靈圖策略:
    • 快速(0 成本、數秒內完成): 使用 Canvas 內建的過程式像素引擎(動畫角色、配有螢幕的辦公桌、咖啡與休息區已經以像素藝術繪製,無需圖片 API)。
    • 進階(2×2 圖板 + 3×3 骨架搭配 AI): 產生獨家家具與角色精靈圖,包含 9 種姿勢並使用 template/scripts/process_sprites.py 自動裁切。
  5. 執行位置:
    • 本機(localhost): 一鍵啟動(Windows 上使用 start.bat,macOS/Linux 上使用 ./start.sh)。
    • 公開網站(選用): 若使用者想發布到網際網路,則必須在發布前套用隱私檢查清單(不記錄私人日誌、未經同意不包含照片、不包含本機路徑)。

逐步執行流程

步驟 1 — 檢查環境(僅 openbot 模式)

若使用者選擇 OpenBot,請在建立設定檔之前確認本機檔案是否存在:

  • Windows: %APPDATA%\OpenBot\openbot.db 與 %APPDATA%\OpenBot\openbot-sidebar-layout-v1.json
  • macOS: ~/Library/Application Support/OpenBot/openbot.db
  • Linux: ~/.config/OpenBot/openbot.db

僅讀取部門(區段)與代理人的名稱,以便建議自動房間對應。絕不能修改 openbot.db(嚴格唯讀)。

步驟 2 — 從 template/ 建立專案資料夾

將此技能中 template/ 資料夾的所有內容複製到使用者選擇的目錄(例如 ./my-pixel-office/):

  • server.mjs
  • public/index.html、public/styles.css、public/app.js
  • scripts/process_sprites.py
  • start.bat 與 start.sh

在專案根目錄建立 office-config.json 檔案(使用 template/office-config.example.json 作為範本),填入:

  • brand:名稱、副標題、主題顏色(bg、panel、accent、accent2、highlight)、窗戶場景(city、beach、forest、space)。
  • source:mode("openbot" | "json" | "demo")、port(預設 3847)、openbotDir(留空則自動偵測)與 bossLabel(例如 "管理層")。
  • rooms:工作房間列表 + 可選的特殊房間(isAtrium: true、isRestRoom: true、isBossRoom: true)。引擎會自動計算 2 到 16 個房間的等角網格,無需手動編輯座標(也可接受明確的 gx, gy, gw, gh 以進行進階佈局)。
  • bosses(選用):0、1 或 2 個領導角色,會在房間之間巡視檢視。
  • agents:代理人/成員列表(在 demo 與 json 模式下使用,或作為 OpenBot 關閉時的回退)。

步驟 3 — 連接即時轉接器

請參閱 references/adapters.md 以設定選定的模式:

  • openbot: 透過 node:sqlite(Node.js 22.5+)在唯讀模式下自動運作,經由 Server-Sent Events(/api/stream)更新地圖,完全不消耗任何 AI token。
  • json: 建立/讀取 office-state.json,並提供 POST /api/events 端點以接收來自 Claude Code hooks、n8n、Python/Node 腳本或任何 webhook 的更新。
  • demo: 立即啟動生動的模擬(機器人正在工作、在辦公桌與咖啡機/飲水機/休息區之間切換,以及無線電訊息)。

步驟 4 — 自訂 2×2 精靈圖與 3×3 骨架(若使用者選擇進階版)

  1. 請參閱 references/sprite-prompts.md 以取得確切的生成提示:
    • 2×2 圖板(每張圖片 4 個項目): 等角家具(開發/視訊/設計辦公桌、機架、沙發、咖啡、植物、主題裝飾)。
    • 3×3 骨架(每個角色 9 種姿勢在一張圖片中): idle、walk_1、walk_2、sit_type_1、sit_type_2、sit_sleep、coffee、hammock、wave。
  2. 將原始圖片儲存到 assets/raw/,骨架儲存到 assets/raw/rigs/。
  3. 執行處理器(需要 Python 3 + Pillow):
    python scripts/process_sprites.py --project . --config office-config.json
    
  4. 視覺檢查 assets/sprites/_contact_sheet.png 與 _rigs_contact_sheet.png,確認透明度乾淨且高度對齊後再交付。
  5. 若使用者目前不想產生圖片: 跳過此步驟!引擎仍會渲染完整的過程式像素藝術,並在之後新增精靈圖時自動熱重載。

步驟 5 — 啟動、測試與交付(必做檢查清單)

在宣告完成之前:

  1. 在本機啟動伺服器(node server.mjs)並確認:
    • GET /api/health 回應 200 OK,內容包含 ok: true 與啟用的模式。
    • GET /api/config 回傳使用者自訂的名稱、色板與房間。
    • GET /api/state 回傳代理人列表與指標,且無錯誤。
  2. 在瀏覽器中開啟 http://127.0.0.1:3847(或使用 curl/瀏覽器測試),確認:
    • 所有房間都出現在下方控制台(地圖)與等角畫布上。
    • 點擊角色會開啟名牌;點擊DEMO會動畫整個辦公室;8-BIT 音效與縮放功能正常。
    • 瀏覽器控制台無任何錯誤。
  3. 隱私(若將發布則為必要): 確保沒有任何機密(sk-...、token、使用者路徑、私人訊息或未經授權的個人照片)被記錄在專案中。
  4. 向使用者提供本機連結(http://127.0.0.1:3847)、一鍵啟動指令(start.bat / ./start.sh),並說明日後如何編輯房間或新增精靈圖。

相關技能