القائمة
每日開發後同步文件。當使用者說「更新文件」、「同步文件」、「整理今天進度到文件」、「根據今天開發更新 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/