共享上游＋個人化入口
團隊要共用的是能力與失敗經驗，不是強迫每個人使用完全一樣的入口。
雷蒙的解釋
這像團隊共用一本菜譜，菜譜裡應該有標準流程、常見失敗、共用食材名稱與已驗證的工具。但每個人家裡的廚房動線、冰箱位置、口味與私人食材不會完全相同。把所有人的入口都強制變成同一份，反而會讓個人流程失靈。
所以，共享上游負責「這件事怎麼做才對」；個人化入口負責「在我的環境裡要從哪裡進去、用哪些私人資源、最後怎麼呈現」。單一真相來源（SSOT）統一的是責任邊界，不等於所有人的電腦只能留一份完全相同的檔案。
怎麼分
| 放共享上游 | 留個人化入口 |
|---|---|
| 通用 SOP 與驗收標準 | 個人絕對路徑與資料夾結構 |
| 團隊可複用的 scripts 與範例 | 本機工具、硬體、帳號與 provider 路由 |
| 共用字典、品牌詞彙與格式規範 | 私人資源、未公開素材與憑證取得方式 |
| 真實失敗案例與回歸測試 | 雷蒙的品味、工作節奏與交付預設 |
| 不寫死個人環境的相對路徑 | 對共享能力的本地 wrapper、router 或 override |
什麼時候用
- 同一個 Skill 要給團隊成員、不同 AI 或多台裝置使用。
- 通用規則需要一起升級，但每個執行環境的路徑、工具與權限不同。
- 團隊已經有兩份以上相似流程，開始重複修同一種錯誤。
同步流程
- 先問「這個變更對團隊每個人都成立嗎？」成立就先改共享上游，否則留在個人入口。
- 共享上游使用相對路徑、環境變數或執行前偵測，不放金鑰、客戶素材或個人絕對路徑。
- 個人版與團隊版先做 diff，只吸收需要的通用改進，不整包覆蓋。
- 個人流程發現的通用 bug 或失敗案例，要回灌上游，讓其他人不用再踩一次。
實例：團隊字幕 Skill
team-ai-skills 是共享上游：放 video-subtitle 與 yt-transcript 的通用 SOP、共用專有名詞字典、可複用腳本，以及「把 raw transcript 當成字幕成品」的真實失敗案例。
雷蒙本機的 video-subtitle skill則是個人化入口：保留 vault 路徑、本機工具、雷蒙 YouTube 後製節奏與私人資源路由。它不用 symlink 被團隊版取代，而是定期比對後手動吸收共用改進。
反例與邊界
- 整包覆蓋個人版：團隊版一更新就複製過去，會把個人路徑、品味與已穩定運作的入口抹掉。
- 只改個人版：通用 bug 永遠留在某台電腦，團隊其他人會反覆踩雷。
- 把私人環境塞進上游：寫死個人路徑、token 或客戶資料，會讓共享版不可攜帶，還可能洩密。
- 只有一個人使用、仍在快速試驗的流程，可以先留本地；等第二個使用者或重複失敗出現，再抽出上游。
出處
這張卡來自 2026-07-08～07-09 團隊字幕 Skill 整併的實戰經驗：團隊共用 repo 作為上游，雷蒙本機保留個人最佳化入口；共用字典與 failures 放上游，私人路徑與品味留本地。對應的 repo 決策也記錄在 REPOS。
在哪裡討論過
實作與規範
team-ai-skills/README.md：定義團隊上游、本地版與手動吸收方式。team-ai-skills/video-subtitle/：共用 SOP、script、字典與 failures 的完整範例。- 雷蒙本機的 video-subtitle skill：個人化入口。
- REPOS：明記團隊上游與本地版的邊界。