project-onboard

Stars13

Forks7

UpdatedJune 23, 2026 at 08:36

PawAI 專案快速上手 — 讓任何 AI 在新 session 中立即理解專案全貌、當前進度、功能架構與開發慣例。每次開新對話、接手不熟悉的模組、或需要理解專案上下文時都應觸發。觸發詞包括但不限於： "onboard"、"上手"、"了解專案"、"project context"、"/onboard"、 "這個專案是做什麼的"、"幫我看一下專案"、"我是新來的"、 "給我專案背景"。即使使用者只是問了一個看起來簡單的功能問題，如果你對專案缺乏上下文，也應該先觸發這個 skill 建立基礎認知。

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

roy4222

roy4222/PawAI

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

12 files

SKILL.md

readonly

name

project-onboard

description

PawAI 專案快速上手

這個專案是什麼

以 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 安全執行。

硬體拓撲

Jetson Orin Nano 8GB（邊緣端）：ROS2 runtime、本地推理、感知模組
Go2 Pro（機器人）：運動控制、音訊播放（WebRTC DataChannel api_id 4001-4004）
5x RTX 8000 48GB（雲端）：LLM 推理（vLLM）、FastAPI Gateway
Intel RealSense D435：RGB-D 攝影機（人臉偵測 + 深度估計）
HyperX SoloCast：USB 麥克風（stereo-only，node 內手動 downmix to mono）

當前進度

讀 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 install
改 Python 後必須 colcon build --packages-select <pkg> + source install/setup.zsh
Jetson 用 zsh，source 時用 .zsh 不是 .bash，兩者不可混用
HyperX 麥克風是 stereo-only，必須 channels:=2 + 手動 downmix，不要用 channels:=1
TTS WAV：16kHz/16bit/mono（Megaphone 路徑），+16dB gain boost
同時間只允許一套 speech session（禁止多 tmux 混跑）
Go2 Megaphone 播放：4001(enter) → 4003(upload chunks, 4096 base64) → 4002(exit)，msg type 必須 "req"
ROS_DOMAIN_ID 必須所有 node 一致，否則互相看不到
Launch 檔案改動不需 rebuild，重啟即可

給非 Claude Code 平台的 AI

如果你不是在 Claude Code 的 skill 系統中被觸發，請改讀 repo 根目錄的 PROJECT_MAP.md，裡面有依序閱讀指引。那份檔案不假設任何 skill 機制存在，純粹用檔案路徑引導你。

觸發邊界

不需要觸發這個 skill 的情況：

任務已明確限定在單一檔案且不需要專案上下文
純 build / lint / format 等工具類操作（CLAUDE.md 已覆蓋）

More from this repository

same repository

brain-studio-lane

roy4222/PawAI

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）。

2026-06-2313

demo-preflight

roy4222/PawAI

Demo 前置檢查工具。在部署到 Jetson 後、Demo 展示前、或需要確認系統就緒時觸發。觸發詞："demo check"、"demo 準備"、"preflight"、"demo ready"、 "準備好了嗎"、"展示前檢查"、"/preflight"。在 jetson-deploy 或 jetson-verify 完成後、使用者提到 demo 或展示時應主動建議。不要在純開發、文件編輯、或不涉及部署/展示的場景觸發。

2026-06-2313

nav-avoidance-lane

roy4222/PawAI

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）。

2026-06-2313

update-docs

roy4222/PawAI

每日開發後同步文件。當使用者說「更新文件」、「同步文件」、「整理今天進度到文件」、「根據今天開發更新 docs」、「幫我把今天改動寫進文件」時觸發。這個 skill 會檢查當天 git 變更，判斷哪些文件需要同步，按治理規則更新對應的真相來源文件。只要使用者提到更新文件、同步 docs、或把開發進度寫進文件，就應該使用這個 skill。

2026-06-2313

ros2-test-suite

roy4222/PawAI

一鍵跑全部 ROS2 套件的 Python 測試。減少每天手動 4 次 pytest 的摩擦。觸發詞："跑測試"、"run tests"、"全套測試"、"test suite"、"測試"、"/test"。在修改 Python 程式碼後、commit 前、或需要確認測試狀態時應主動建議。不要在純文件編輯、shell script 修改、或不涉及 Python 程式碼的場景觸發。

2026-06-1113

jetson-verify

roy4222/PawAI

Jetson 部署驗證工具。部署後跑 smoke test、整合前做 pre-flight check、 Demo 前產出 go/no-go 報告。觸發詞："verify"、"驗證"、"健檢"、 "smoke test"、"check jetson"、"jetson 狀態"、"/verify"。在 colcon build 成功後、WSL→Jetson sync 完成後、或使用者說「驗證」「smoke」「健檢」「ready」時應主動建議執行。不要在純聊天、文件摘要、或不需實際執行檢查時觸發。

2026-06-0313

name

project-onboard

description

PawAI 專案快速上手

這個專案是什麼

以 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 安全執行。

硬體拓撲

Jetson Orin Nano 8GB（邊緣端）：ROS2 runtime、本地推理、感知模組
Go2 Pro（機器人）：運動控制、音訊播放（WebRTC DataChannel api_id 4001-4004）
5x RTX 8000 48GB（雲端）：LLM 推理（vLLM）、FastAPI Gateway
Intel RealSense D435：RGB-D 攝影機（人臉偵測 + 深度估計）
HyperX SoloCast：USB 麥克風（stereo-only，node 內手動 downmix to mono）

當前進度

讀 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 install
改 Python 後必須 colcon build --packages-select <pkg> + source install/setup.zsh
Jetson 用 zsh，source 時用 .zsh 不是 .bash，兩者不可混用
HyperX 麥克風是 stereo-only，必須 channels:=2 + 手動 downmix，不要用 channels:=1
TTS WAV：16kHz/16bit/mono（Megaphone 路徑），+16dB gain boost
同時間只允許一套 speech session（禁止多 tmux 混跑）
Go2 Megaphone 播放：4001(enter) → 4003(upload chunks, 4096 base64) → 4002(exit)，msg type 必須 "req"
ROS_DOMAIN_ID 必須所有 node 一致，否則互相看不到
Launch 檔案改動不需 rebuild，重啟即可

給非 Claude Code 平台的 AI

觸發邊界

不需要觸發這個 skill 的情況：

任務已明確限定在單一檔案且不需要專案上下文
純 build / lint / format 等工具類操作（CLAUDE.md 已覆蓋）