project-onboard

Estrelas13

Forks7

Atualizado23 de junho de 2026 às 08:36

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

Instalação

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Fonte

roy4222

roy4222/PawAI

Abrir repositório GitHub Ver repositórios do creator

Download

Ocupações relacionadasSOC

Baseado na classificação ocupacional SOC

Desenvolvedores de softwareInformática e Matemática·SOC 15-1252

Explorador de arquivos

12 arquivos

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 已覆蓋）

Mais deste repositório

mesmo repositório

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 已覆蓋）