技能包

Duology:為 iPhone Duo 摺疊螢幕 App 開發打造的 Claude Code skills

最適合已符合官方環境要求(Apple silicon 的 Mac、Xcode 27.1、Claude Code)、要為 iPhone Duo 摺疊螢幕設計並檢查 App 的開發者:裝好 `duology` 外掛後,即可讓 agent 執行 `duo-lint` 與 15 點檢查清單,取得依嚴重程度排序的待修問題清單;Cursor、Codex、Copilot、Gemini CLI 等用戶端只能以 skills only 方式安裝,斜線指令與 lint hook 屬於 Claude Code 功能。

官方來源 · Kimeur/duology

安裝

/plugin marketplace add Kimeur/duology
/plugin install duology@duology

適合誰

  • 在 Mac(Apple silicon)上用 Claude Code 開發 iPhone Duo 摺疊螢幕 App 的開發者。官方把 Duology 定位為一組「在 iPhone Duo 上設計、建置、測試並交付 App」的 Claude Code skills,以 duology 外掛形式發布,內容涵蓋四塊:layout patterns(摺疊版面配置模式)、app recipes(應用配方)、一個 fold linter 和 pose checks(姿態檢查)。這些內容服務於官方所說的設計、建置、測試與交付流程;如果你的工作是把介面調整到 iPhone Duo 的摺疊形態上,這套 skills 針對的就是這類任務。它是面向 App 開發流程的工具集,不是通用的文字檢查或寫作助理。
  • 環境前提有三樣:Apple silicon 的 Mac、Xcode 27.1(27A9275 或更新版本)和 Claude Code。官方列出的環境要求就是這三項,缺少任何一項時能否使用並未說明,應視為未確認。
  • 以 Cursor、Codex、Copilot、Gemini CLI 或其他用戶端為主力的使用者:官方對這類環境標註為 skills only,亦即只安裝 skills 本身;斜線指令與 lint hook 屬於 Claude Code 功能,安裝路徑也不同。這些 skills 在此類用戶端裡能完成哪些任務,官方未說明;如果你的用戶端無法觸發相應檢查,官方也沒有提供替代方案。
  • 官方未說明它是否適用於 iPhone Duo 以外的裝置,也未說明對自然語言或註解語言的支援範圍,這兩點請勿自行假設。

3 分鐘完成第一次嘗試

主路徑只有一條:在 Claude Code 中透過外掛市場安裝 duology——官方把外掛市場列為主要安裝路徑——然後對 App 做一次摺疊螢幕設計檢查。

前提:一台 Apple silicon 的 Mac,裝好 Xcode 27.1(27A9275 或更新版本)與 Claude Code,並準備一個 iPhone Duo App 專案。

  1. 在 Claude Code 工作階段中依序執行兩條官方指令:/plugin marketplace add Kimeur/duology 新增外掛市場,/plugin install duology@duology 安裝 duology 外掛。duology 是官方建議最先安裝的外掛。
  2. 安裝完成後,在同一個工作階段裡請 agent 檢查你的 App 的摺疊螢幕設計。官方對這項檢查的說明是:它會執行 duo-lint 和 15 點檢查清單(15-point checklist)。
  3. 觀察成功訊號:agent 會回傳待修問題清單,「列出需要修復的內容,最嚴重的排在最前面」。如果只得到安裝確認而沒有問題清單,表示檢查並未真正執行,應重新發起任務。

動手前須知:官方對這項檢查的描述只到執行 duo-lint 與 15 點檢查清單並列出待修問題;它是否還會讀寫檔案、執行指令或存取網路,官方並未寫明。首次執行時請留意 agent 的實際動作,確認輸出符合預期後再繼續。

使用案例

案例一:一輪大改之後為摺疊版面做健檢。情境:你的 App 剛完成一輪針對 iPhone Duo 的調整,想知道目前最嚴重的問題是什麼、先修哪一個。發起:在 Claude Code 中請 agent 檢查目前 App 的摺疊螢幕設計;依官方說明,檢查對象就是你的 App。實際流程:檢查會執行 duo-lint 與 15 點檢查清單。可期待結果:一份依嚴重程度由高到低排列的待修問題清單,可以按順序逐一處理;清單筆數、具體格式與是否附修復程式碼,官方未說明,清單產出之後如何逐一修復也沒有官方流程。 案例二:在非 Claude Code 用戶端中導入這套 skills。情境:你日常主要在 Cursor、Codex、Copilot 或 Gemini CLI 裡工作,希望這套 skills 就近可用。發起:在對應環境執行 npx skills add Kimeur/duology。實際流程:官方標註的 skills only 安裝,亦即只安裝 skills 本身。可期待結果:官方說明 CLI 會把 skills 放到 agent 查找的位置;可確認到安裝這一步,之後能觸發哪些任務、結果與 Claude Code 是否一致,需在你的用戶端裡自行驗證。如果 skills 無法如預期觸發,先回到 Claude Code 主路徑確認功能本身正常。

使用邊界

  • 平台差異要分開看待:外掛市場是 Claude Code 的安裝面,上面兩條指令以斜線指令形式在 Claude Code 內執行;Cursor、Codex、Copilot、Gemini CLI 等走 npx skills add Kimeur/duology,且僅為 skills only。不要把後者當成外掛市場安裝,也不要假設兩條路徑能力一致。
  • 副作用與確認點:官方未寫明檢查是否會修改檔案、執行指令或存取網路,也沒有關於確認點的官方說明;這些屬未確認資訊,動手前以第一次嘗試中的注意事項為準。
  • 相依關係:duology-recipes 與 duology-ship 相依於 duology,後者提供 /duo-doctor;duology-design 與 duology-features 可單獨安裝,但其 skills 指向 duology 的 skills(duo-layout、duo-continuity、duo-scenes),官方建議先安裝 duology。
  • 執行環境:skills 針對 iPhone Duo 摺疊螢幕上的 App 開發;模擬器與實機的差別、對具體 Xcode 專案結構的要求,官方未說明。
  • 版本:官方寫明 Xcode 27.1(27A9275 or later),亦即以 27A9275 為最低要求;後續是否調整以官方頁面為準。
  • 尚未確認的關鍵資訊:/duo-doctor 的具體功能、各 skill 與各擴充外掛的具體用途和觸發方式、iPhone Duo 之外裝置的支援情況、檢查輸出的詳細格式,官方頁面均未寫明;在官方補充之前,任何一項都不要當成已支援。