القائمة
PawAI 專案快速上手 — 讓任何 AI 在新 session 中立即理解專案全貌、 當前進度、功能架構與開發慣例。每次開新對話、接手不熟悉的模組、 或需要理解專案上下文時都應觸發。觸發詞包括但不限於： "onboard"、"上手"、"了解專案"、"project context"、"/onboard"、 "這個專案是做什麼的"、"幫我看一下專案"、"我是新來的"、 "給我專案背景"。即使使用者只是問了一個看起來簡單的功能問題， 如果你對專案缺乏上下文，也應該先觸發這個 skill 建立基礎認知。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
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 的情況：