메뉴
每日開發後同步文件。當使用者說「更新文件」、「同步文件」、「整理今天進度到文件」、「根據今天開發更新 docs」、「幫我把今天改動寫進文件」時觸發。這個 skill 會檢查當天 git 變更，判斷哪些文件需要同步，按治理規則更新對應的真相來源文件。只要使用者提到更新文件、同步 docs、或把開發進度寫進文件，就應該使用這個 skill。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
PawAI 專案快速上手 — 讓任何 AI 在新 session 中立即理解專案全貌、 當前進度、功能架構與開發慣例。每次開新對話、接手不熟悉的模組、 或需要理解專案上下文時都應觸發。觸發詞包括但不限於： "onboard"、"上手"、"了解專案"、"project context"、"/onboard"、 "這個專案是做什麼的"、"幫我看一下專案"、"我是新來的"、 "給我專案背景"。即使使用者只是問了一個看起來簡單的功能問題， 如果你對專案缺乏上下文，也應該先觸發這個 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）。
一鍵跑全部 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 | update-docs |
| description | 每日開發後同步文件。當使用者說「更新文件」、「同步文件」、「整理今天進度到文件」、「根據今天開發更新 docs」、「幫我把今天改動寫進文件」時觸發。這個 skill 會檢查當天 git 變更，判斷哪些文件需要同步，按治理規則更新對應的真相來源文件。只要使用者提到更新文件、同步 docs、或把開發進度寫進文件，就應該使用這個 skill。 |
每日開發完成後，根據程式碼變更同步對應的文件。
核心原則：不是「全部更新一輪」，而是「只更新真正被今天開發影響的真相來源」。
執行以下命令掌握變更範圍：
# 今天的 commit
git log --since="00:00" --oneline
# 如果沒有今天的 commit，看 staged + unstaged 變更
git diff --name-only
git diff --name-only --cached
# 完整差異（理解改動內容）
git diff
git diff --cached
如果使用者指定了時間範圍（例如「更新這週的」），用 --since 調整。
把變更分成 4 個層級，從窄到寬：
模組層（最常見）
契約層
docs/contracts/interaction_contract.mddocs/archive/2026-05-docs-reorg/architecture-misc/data_flow.mdStudio 層
docs/architecture/studio/ 下的相關文件Sprint 層（Sprint 期間每日必做）
- [ ] → - [x]）references/project-status.md 的模組狀態表和當日進度段落專案層（最少動）
docs/mission/README.md 或 docs/mission/handoff_316.md列出建議同步的文件清單，格式如下：
今天建議同步 N 份文件：
1. `docs/architecture/speech/README.md`
- 補充新的啟動腳本
- 更新 fallback 行為
2. `docs/contracts/interaction_contract.md`
- 更新 /event/... schema 欄位
直接更新（小改模式）：
mission/README.mdinteraction_contract.md（凍結中）先提案再改（大改模式）：
mission/README.mdinteraction_contract.mdarchitecture/studio/specs/event-schema.md大改模式時，先輸出提案等使用者確認，確認後才動手。
更新時遵守以下規則：
固定格式回報：
已更新：
- docs/architecture/speech/README.md — 補充 energy VAD 參數說明
- docs/archive/2026-05-docs-reorg/architecture-misc/data_flow.md — 更新 banner 偏差描述
未更新：
- docs/mission/README.md（本次變更不影響專案方向）
需要你確認：
- interaction_contract.md 的 /state/interaction/speech schema 是否要加 vad_state 欄位
已 commit：<hash> <subject>
如果是 opt-out 情況，把最後一行換成 未 commit（原因：...）。
預設：自動 commit
執行完 Step 5 的文件編輯後，如果有任何變更（git status 非空），自動執行 commit：
git add 只加入本次實際修改/新增的文件（包含 docs 相關目錄、對應的 README、新加入版控的 script/config）
git add -A 或 git add .，避免誤入敏感檔案.gitignore、scripts/README.md 這類相關支援檔，也一併加入（它們是 docs 更新的一部分）docs: [一句話摘要本次同步的主題]
- 檔案 1：改了什麼
- 檔案 2：改了什麼
...
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
git commit -m（避免引號/換行問題）git status + git log --oneline -3 驗證Opt-out 條件（遇到以下情況不要 commit，只改檔）：
mission/ 或 interaction_contract.md 的修改（大改模式下使用者必須先審過再 commit）git status 顯示的變更檔案中有 .env、credentials*、*.key、*.pem 等疑似機密檔（這時候要警告使用者、不 commit）pre-commit hook 安裝時失敗 → 報告錯誤，不要用 --no-verify輸出格式：commit 完成後，在 Step 6 的輸出摘要最後加一段：
已 commit：<hash> <subject>
或（opt-out 時）：
未 commit（原因：...）
這是預設的映射關係，skill 應據此判斷該更新哪些文件：
| 程式碼變更 | 對應文件 |
|---|---|
speech_processor/、語音相關腳本 | docs/architecture/speech/README.md |
face_perception/、scripts/face_* | docs/architecture/perception/face/README.md |
手勢/姿勢相關程式、gesture_*、pose_*、DWPose、RTMPose | docs/architecture/perception/gesture/README.md、docs/architecture/perception/pose/README.md |
go2_robot_sdk/ | docs/contracts/interaction_contract.md（如涉及 topic/command） |
go2_interfaces/msg/、go2_interfaces/srv/ | docs/contracts/interaction_contract.md |
interaction_executive/ | docs/contracts/interaction_contract.md、docs/architecture/studio/specs/brain-adapter.md |
face_dashboard_fastapi/、face_dashboard_nextjs/ | docs/architecture/studio/ 相關文件 |
scripts/start_*.sh | 對應模組的 README + CLAUDE.md 常用指令區 |
go2_robot_sdk/config/ | CLAUDE.md 配置檔區塊 |
go2_robot_sdk/launch/ | CLAUDE.md 啟動指令區塊 |
| 專案級策略、分工、demo 變更 | docs/mission/README.md、docs/mission/handoff_316.md |
| 任何功能性程式碼變更 | references/project-status.md（模組狀態表 + 當日進度段落） |
| Sprint 期間的交付物完成 | docs/mission/sprint-b-prime.md（對應 Day 的 checklist 打勾 + 驗收結果） |
如果變更涉及新的 ROS2 node，除了模組 README，也要檢查 CLAUDE.md 的「常見開發情境 → 新增 ROS2 節點」是否需要更新範例。
更新文件時必須遵守的責任邊界：
mission定方向，contracts定 ROS2 介面契約，pawai-brain定 Brain/感知/語音/Studio，navigation定移動，runbook定操作，程式碼庫定現況，CLAUDE.md不定規格。
| 問題類型 | 以誰為準 |
|---|---|
| 專案方向、P0/P1/P2、分工、Demo | mission/ |
| ROS2 介面、schema、QoS、跨模組契約 | contracts/ |
| Studio / Gateway / Brain / Frontend | architecture/studio/、pawai-brain/ |
| 模組內部設計 | 各模組 README |
| 安裝、部署、操作步驟 | runbook/ |
CLAUDE.md vs runbook/ 衝突 | 以 runbook/ 為準 |
CLAUDE.md vs contracts/ 衝突 | 以 contracts/ 為準 |
CLAUDE.md 是操作速查卡，不是規格文件：
CLAUDE.md，完整規格寫在對應的主幹文件mission/README.md（除非專案方向真的變了）CHANGELOG.md（只有結構級變更才記）archive/ 當現行依據CLAUDE.md 再長出完整規格表mission/