菜单
PawAI 專案快速上手 — 讓任何 AI 在新 session 中立即理解專案全貌、 當前進度、功能架構與開發慣例。每次開新對話、接手不熟悉的模組、 或需要理解專案上下文時都應觸發。觸發詞包括但不限於： "onboard"、"上手"、"了解專案"、"project context"、"/onboard"、 "這個專案是做什麼的"、"幫我看一下專案"、"我是新來的"、 "給我專案背景"。即使使用者只是問了一個看起來簡單的功能問題， 如果你對專案缺乏上下文，也應該先觸發這個 skill 建立基礎認知。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
PawAI Brain × Studio 開發 lane 的標準操作。管 conversation_graph_node、 interaction_executive、tts、asr、studio gateway、frontend、Mac 操作端。 觸發詞："brain lane"、"啟 brain"、"開 brain"、"brain dev"、"/brain-lane"、 "起 studio"、"開 studio"、"brain studio"、"PawAI Brain"。 在使用者要做 LLM persona 調整、Studio chat 測試、自然度 eval、TTS 驗證、 Brain freeze 後測試時主動建議。也用於 Brain × Nav 切換時的 lane handoff。 不要在 Nav / SLAM / LiDAR / 避障場景觸發（那是 nav-avoidance-lane）。
Demo 前置檢查工具。在部署到 Jetson 後、Demo 展示前、或需要確認系統就緒時觸發。 觸發詞："demo check"、"demo 準備"、"preflight"、"demo ready"、 "準備好了嗎"、"展示前檢查"、"/preflight"。 在 jetson-deploy 或 jetson-verify 完成後、使用者提到 demo 或展示時應主動建議。 不要在純開發、文件編輯、或不涉及部署/展示的場景觸發。
PawAI 導航避障 lane 的標準操作。管 RPLIDAR、D435、go2_driver、Nav2、AMCL、 cartographer、reactive_stop、nav_capability、twist_mux 等所有 nav stack。 觸發詞："nav lane"、"啟 nav"、"開 nav"、"導航"、"避障"、"建圖"、 "/nav-lane"、"AMCL"、"reactive_stop"、"nav_capability"、"場測"。 在使用者要做 LiDAR 校正、建圖、AMCL 定位、Nav2 場測、reactive_stop 驗證、 B5 / B6 / B7 burndown 階段時主動建議。也用於 Brain × Nav 切換時的 lane handoff。 不要在 Brain / LLM / Studio / TTS / persona 場景觸發（那是 brain-studio-lane）。
每日開發後同步文件。當使用者說「更新文件」、「同步文件」、「整理今天進度到文件」、「根據今天開發更新 docs」、「幫我把今天改動寫進文件」時觸發。這個 skill 會檢查當天 git 變更，判斷哪些文件需要同步，按治理規則更新對應的真相來源文件。只要使用者提到更新文件、同步 docs、或把開發進度寫進文件，就應該使用這個 skill。
一鍵跑全部 ROS2 套件的 Python 測試。減少每天手動 4 次 pytest 的摩擦。 觸發詞："跑測試"、"run tests"、"全套測試"、"test suite"、"測試"、"/test"。 在修改 Python 程式碼後、commit 前、或需要確認測試狀態時應主動建議。 不要在純文件編輯、shell script 修改、或不涉及 Python 程式碼的場景觸發。
Jetson 部署驗證工具。部署後跑 smoke test、整合前做 pre-flight check、 Demo 前產出 go/no-go 報告。觸發詞："verify"、"驗證"、"健檢"、 "smoke test"、"check jetson"、"jetson 狀態"、"/verify"。 在 colcon build 成功後、WSL→Jetson sync 完成後、或使用者說 「驗證」「smoke」「健檢」「ready」時應主動建議執行。 不要在純聊天、文件摘要、或不需實際執行檢查時觸發。
| name | project-onboard |
| description | PawAI 專案快速上手 — 讓任何 AI 在新 session 中立即理解專案全貌、 當前進度、功能架構與開發慣例。每次開新對話、接手不熟悉的模組、 或需要理解專案上下文時都應觸發。觸發詞包括但不限於： "onboard"、"上手"、"了解專案"、"project context"、"/onboard"、 "這個專案是做什麼的"、"幫我看一下專案"、"我是新來的"、 "給我專案背景"。即使使用者只是問了一個看起來簡單的功能問題， 如果你對專案缺乏上下文，也應該先觸發這個 skill 建立基礎認知。 |
以 Unitree Go2 Pro 機器狗為載體的 embodied AI 互動陪伴平台。 核心是「人臉辨識 + 中文語音互動 + AI 大腦決策」，不是導航或尋物。 硬底線：2026/4/13 展示。
Layer 3（中控）：Interaction Executive + AI Brain
事件聚合、高階決策、技能分派、安全仲裁
部署：Jetson (Executive) + RTX 8000 (Brain)
Layer 2（感知）：人臉 / 語音 / 手勢 / 姿勢模組
各自發布 event（觸發式）+ state（持續式）到 ROS2 topics
部署：Jetson
Layer 1（驅動）：Go2 Driver + D435 + Jetson + ROS2
硬體抽象、WebRTC DataChannel、模型推理 runtime
部署：Jetson + Go2 Pro
所有動作唯一出口在 Layer 3。大腦提建議、Executive 做決策、Runtime 安全執行。
讀 references/project-status.md 取得最新進度。
那份檔案會頻繁更新，不要依賴快取。
根據你的任務，讀對應的 reference 檔案。每個 reference 包含： 模組定位、權威文件指標、核心程式、已知陷阱、開發入口、驗收方式。
reference 是導覽與摘要，不是第二份真相。詳細內容在它指向的權威文件裡。 如果 reference 和權威文件衝突，以權威文件為準。
| 你的任務涉及... | 讀這個 reference |
|---|---|
| 人臉、face、YuNet、SFace、D435、追蹤、identity | references/face.md |
| 手勢、gesture、MediaPipe Hands、Recognizer、ok、wave、stop | references/gesture.md |
| 姿勢、pose、跌倒、fallen、MediaPipe Pose、trunk_angle | references/pose.md |
| 物體、object、YOLO、COCO、HSV、顏色、cup、chair | references/object.md |
| 語音、ASR、TTS、Whisper、SenseVoice、Piper、Gemini、Megaphone | references/speech.md |
| 導航、nav、SLAM、AMCL、reactive_stop、Nav2、cartographer | references/nav.md |
| Brain、LLM、LangGraph、persona、conv graph、OpenRouter | references/brain.md |
| Studio、前端、Next.js、WebSocket、Chat、Gateway、Mock | references/studio.md |
| Jetson、部署、build、CLI、pawai cli、環境、colcon | references/environment.md |
| 測試、驗收、E2E、ros2-test-suite、contract check、CI | references/validation.md |
如果任務跨多個模組，依序讀相關的 references。
如果不確定從哪開始，先讀 references/project-status.md 看當前焦點。
這些是各領域的 single source of truth：
| 領域 | 真相來源 |
|---|---|
| 專案方向、Demo 目標 | docs/mission/README.md |
| ROS2 介面契約 | docs/contracts/interaction_contract.md |
| 0511 架構 freeze-snapshot（七大模組 + Studio） | docs/archive/pawai-brain-legacy/architecture-0511/ |
| 人臉辨識（0511） | docs/archive/pawai-brain-legacy/architecture-0511/face/face.md |
| 手勢辨識（0511） | docs/archive/pawai-brain-legacy/architecture-0511/gesture/gesture.md |
| 姿勢辨識（0511） | docs/archive/pawai-brain-legacy/architecture-0511/pose/pose.md |
| 物體辨識（0511） | docs/archive/pawai-brain-legacy/architecture-0511/object/object.md |
| 語音模組（0511） | docs/archive/pawai-brain-legacy/architecture-0511/speech/speech.md |
| 導航避障（0511） | docs/archive/pawai-brain-legacy/architecture-0511/nav/ |
| AI 大腦（0511） | docs/archive/pawai-brain-legacy/architecture-0511/brain/brain.md |
| PawAI Studio（0511） | docs/archive/pawai-brain-legacy/architecture-0511/studio/studio.md |
| Studio 設計文件 | docs/architecture/studio/README.md |
| 環境建置 | docs/runbook/README.md |
每個模組資料夾根目錄有 3 個入口檔案：
| 檔案 | 用途 | 誰看 |
|---|---|---|
README.md | 模組當前真相（狀態卡 + 核心流程 + 已知問題） | 所有人 |
CLAUDE.md | Claude Code 工作規則（禁止事項 + 陷阱 + 驗證指令） | Claude Code |
AGENT.md | 介面契約 + 接手摘要（topic schema + 事件流 + 確認清單） | 任何 agent / 接手者 |
子資料夾：research/（選型研究）、archive/（歷史記錄）、specs/（設計規格）。
這些是跨模組通用的規則，不管做哪個功能都要知道：
pip install → 一律用 uv pip installcolcon build --packages-select <pkg> + source install/setup.zsh.zsh 不是 .bash，兩者不可混用channels:=2 + 手動 downmix，不要用 channels:=14001(enter) → 4003(upload chunks, 4096 base64) → 4002(exit)，msg type 必須 "req"ROS_DOMAIN_ID 必須所有 node 一致，否則互相看不到如果你不是在 Claude Code 的 skill 系統中被觸發，
請改讀 repo 根目錄的 PROJECT_MAP.md，裡面有依序閱讀指引。
那份檔案不假設任何 skill 機制存在，純粹用檔案路徑引導你。
不需要觸發這個 skill 的情況：