# 如何安裝並使用 Oysterun Skill

在 Claude 或 Codex Session 中找出、安裝或更新、驗證並安全使用符合條件的 Oysterun Skill。

當你希望 Claude 或 Codex Session 透過已安裝的 Skill 執行 Oysterun 產品任務時，請使用本指南。你會找出目前的 Skill 狀態、安裝或更新符合條件的 Oysterun Skill 組、從可見 UI 驗證，並使用一個 Skill 完成唯讀任務。

簡短原則：

選取安裝或更新項目後會立即執行；產品 Skill 輔助項目只會在草稿中插入參照。決定下一步前，務必讀清楚項目與草稿。

## 開始前

- 你已登入 Oysterun，並開啟一個即時 Session。
- 該 Session 使用 **Claude** 或 **Codex**；這兩者具有受支援的 provider Skill 資料夾。
- 一般新建且符合條件的 Session，目前會先自動配置由 Oysterun 管理的 Skill 組。是否需要安裝，應依可見選單狀態判斷，而不是依 Session 是否剛建立。
- 該 Session 使用的資料夾，就是你希望 Oysterun Skill 組可用的位置。
- 截圖或共用證據不會包含私人憑證、本機路徑或無關 Session 內容。

**起始畫面：**你希望 Skill 協助的確切即時 Session Chat 畫面，而且訊息輸入框可見。

範圍：

安裝只適用於這個 provider 與 Session 資料夾。它不會替 provider 登入、不會授予新的 Oysterun 權限、不會變更其他 Session 資料夾，也不代表 provider 之後的回覆一定用了正確 Skill。

## 1. 找出目前的 Skill 狀態

![完整桌面輸入框選單顯示目前的 Oysterun 更新動作與產品 Skill 輔助項目。](../assets/publication/skill-state-menu.jpg)

畫面 checkpoint：目前 Session 選單同時顯示已安裝狀態的

/update_oysterun_skill

動作與 Oysterun 產品 Skill 輔助項目。

1. 按一下訊息輸入框。
1. 輸入 **/**，等待 **Commands and Prompts** 出現。
1. 閱讀 **Oysterun** 下的項目。在確定要執行前，不要選取安裝或更新項目。

**一般預期狀態：**新建且符合條件的 Claude 或 Codex Session，通常會顯示 **/update_oysterun_skill** 與產品 Skill 輔助項目，因為受管理的 Skill 組已自動配置。不要假設新 Session 一定缺少 Skill 組；請依畫面實際顯示的狀態繼續。

可見項目或狀態

意義

下一步

/install_oysterun_skill

符合條件的 Oysterun Skill 組實際上尚未安裝。

只有看見此項目時，才使用條件式步驟 2。

/update_oysterun_skill

與產品 Skill 輔助項目

由 Oysterun 管理的 Skill 組已安裝；這是新建且符合條件之 Session 的一般狀態。

略過步驟 2。驗證或使用；只有需要時才更新。

Oysterun skill folder is not managed

現有資料夾並非由 Oysterun 管理。

停止；Oysterun 不會覆寫。

Oysterun skills unavailable

這個 provider 沒有受支援的 Skill 資料夾。

使用 Claude 或 Codex Session。

Oysterun commands unavailable

狀態檢查失敗。

使用步驟 8 的有界復原。

檢查點：

選單對這個 Session 顯示一個明確的未安裝、已安裝、非管理、未支援或無法取得狀態。

## 2. 只有選單顯示缺少 Skill 組時才安裝

這是依狀態使用的復原途徑，不是每個新 Session 都保證使用的設定途徑。只有在實際選單提供 **/install_oysterun_skill** 時才執行；若更新與輔助項目已存在，請略過本步驟。

1. 選取 **/install_oysterun_skill**。
1. 選取後會立即執行本機 Oysterun 動作。它不會成為草稿，也不會當作一般 prompt 傳給 Claude 或 Codex。
1. 等待時間軸中的結果。缺少 Skill 組安裝成功時會顯示 Oysterun skills installed for this agent folder. Provider delivery suppressed.
1. 再次輸入 **/**。選單現在應提供 **/update_oysterun_skill** 與產品 Skill 輔助項目。

不要點兩次。

如果沒有出現結果，不要因為選單關閉就重複安裝。先等待時間軸結果，再使用復原段落。

## 3. 只有確定要替換時才更新受管理 Skill 組

![同一 Session 時間軸顯示有意更新受管理 Skill 組後的終端結果。](../assets/publication/skill-update-result.jpg)

畫面 checkpoint：這是 Skill 更新動作的終端時間軸結果，不是選單標籤，也不是第二次更新指示。

若選單顯示 **/update_oysterun_skill** 與輔助項目，表示受管理 Skill 組已安裝，請略過步驟 2。目前受支援的更新途徑是輸入框項目；選取後會立即替換這個 provider 與 Session 資料夾中的受管理 Skill 組：

1. 在同一個 Session 輸入框輸入 **/**，等待 **Commands and Prompts** 出現。
1. 確認 **/update_oysterun_skill** 是預定 Session 與資料夾所顯示的已安裝狀態動作。
1. 只有確定要替換時，才選取一次 **/update_oysterun_skill**。選取後會立即執行本機 Oysterun 動作；它不會插入草稿，也不會再顯示第二個確認對話框。
1. 等待時間軸結果。透過輸入框完成更新時會顯示 Oysterun skills updated for this agent folder. Provider delivery suppressed.
1. 不要因為選單關閉就再次選取。只有在時間軸結果出現後，才重新開啟 **/**。

執行前檢視：

如果需要更多狀態資訊，可開啟

More Options

>

Session Profile

>

Oysterun Skills

，並閱讀

Provider Skill Set

。閱讀狀態不會更新 Skill 組。回到輸入框，只有確定要覆寫時才使用

/update_oysterun_skill

。

## 4. 要求 provider 使用 Skill 前先驗證

1. 回到同一個即時 Session，輸入 **/**。
1. 等待狀態檢查完成。
1. 確認 **/update_oysterun_skill** 與產品 Skill 輔助項目存在。
1. 若在步驟 3 選取了更新，必須同時看到更新完成的時間軸結果與這個重新整理後的已安裝狀態選單，才算驗證更新。

檢查點：

只有成功訊息還不是最後證明。重新整理後的選單必須對這個確切 Session 顯示已安裝狀態的輔助項目。

## 5. 選擇符合任務的輔助項目

![完整桌面輸入框草稿含 Codex sessions Skill 參照，以及傳送前的唯讀狀態與 URL 要求。](../assets/publication/skill-helper-draft.jpg)

畫面 checkpoint：選取

/oysterun_sessions_skill

後插入適用於 Codex 的正確參照，而完整唯讀要求在傳送前仍是草稿。

輔助項目

用途

/oysterun_sessions_skill

Session 清單、狀態、URL、profile、啟動、續接、重新命名、重新啟動、中斷或停止

/oysterun_session_chat_skill

Session 訊息、搜尋、傳送或 Session 內 Loop

/oysterun_find_context_skill

一個已知事件附近的有界訊息前後文

/oysterun_scheduler_skill

Host schedules 及其執行或記錄，不是 Session 內 Loop

/oysterun_mail_skill

Oysterun Mail

/oysterun_notifications_skill

通知狀態，或已明確授權的傳送

/oysterun_website_skill

Website 狀態、設定、驗證、URL 或存取

/oysterun_telegram_skill

Telegram 狀態或每個 Session 的 Telegram 設定

依使用者目標選擇。

Host schedule 與 Session 內 Loop 是不同的儲存區。真實的空白 schedule 清單不能證明 Loop 不存在。

## 6. 使用一個 Skill 完成唯讀任務

![同一 Session 的終端 Codex 回覆顯示目前 Session 狀態與 URL，並說明沒有進行變更。](../assets/publication/skill-read-only-result.jpg)

畫面 checkpoint：確切唯讀要求只傳送一次後，同一 Session 的終端 provider 回覆會回報目前狀態與 URL，並確認

No changes made.

1. 在同一個輸入框輸入 **/oysterun_sessions_skill**。
1. 選取相符的輔助項目。Oysterun 會把適用於 Claude 或 Codex 的正確 Skill 參照插入草稿；此時不會傳送或執行任何內容。
1. 在插入的參照後加入：Show this current Session's status and URL. Do not change anything.
1. 檢查完整草稿，再選取一次 **Send message**。
1. 等待 provider 的終端回覆。確認內容回報目前 Session 的狀態與 URL，而不是一般說明或另一個 Session。

完成：

輔助項目選取了符合條件的 Skill、provider 回傳要求的唯讀產品結果，而且結果符合一開始的 Session。

## 7. 維持 Claude 與 Codex 行為一致

- 兩個受支援的 provider 都提供相同的八個 Oysterun 輔助項目名稱。
- 這段流程沒有另外的 capability 選擇步驟。符合條件且已安裝的 Oysterun Skill 組預設會顯示輔助項目，但每個選取的 Skill 仍保留自己的安全與授權規則。
- 讓選單插入符合 provider 的 Skill 參照。不要把 Claude Session 的參照複製到 Codex，反之亦然。
- 變更 Session provider 或 Session 資料夾，就會改變 Skill 狀態的目標。重新開啟 **/** 檢查新狀態，不要假設先前安裝仍適用。
- 安裝只代表 Skill 檔案可用；provider 仍必須遵循選取的 Skill，並回傳要求的結果。

## 8. 復原時不要強制覆寫或重複操作

- **Loading Oysterun commands...**：等待狀態完成。若一直沒有完成，重新載入同一個 Session 一次，再開啟 **/**。
- **Oysterun commands unavailable**：保留可見錯誤、確認 Session 仍為即時狀態，然後重試狀態檢查一次。
- **Oysterun skill folder is not managed**：停止。不要使用更新，也不要從此流程刪除現有資料夾。
- **Oysterun skills unavailable**：停止此途徑，改用具有預定資料夾的 Claude 或 Codex Session。
- **安裝或更新失敗**：不要盲目重複。保留可見結果，並重新開啟 **Session Profile**，閱讀目前的 **Provider Skill Set** 狀態。
- **已安裝但沒有輔助項目**：狀態重新整理後，再開啟輸入框選單一次。若仍然沒有，請保留可見狀態並停止，不要宣稱驗證成功。
- **provider 回傳錯誤任務或途徑**：不要把已安裝當成已使用 Skill 的證明。重複相同輔助項目與唯讀要求一次；若結果仍錯誤，請保留並停止。

安全停止點：

非管理資料夾、不支援的 provider、不明確的 Session 目標、缺少已安裝狀態輔助項目、失敗的本機結果或錯誤的 provider 回覆，都仍是未解決狀態。不要以手動路徑、重複點擊或更廣泛的變更來繞過。