hig-project-context

hig-project-context 技能概覽

hig-project-context 可協助你建立或更新一份共用的 Apple 設計脈絡檔，讓其他 HIG 技能能以更少重複提問，提供更精準的建議。它特別適合 Apple 應用團隊、以 Claude 為基礎的程式開發工作流程，以及希望把專案範圍、平台與設計限制集中成單一事實來源的技能作者。

它要完成的核心工作很單純：先把專案脈絡一次收進 .claude/apple-design-context.md，之後再供下游的 HIG 技能重複使用，例如 hig-foundations、hig-platforms、hig-components-*、hig-inputs、hig-technologies。因此，當你在啟動新的 Apple 平台專案，或是希望讓 agent 只針對缺漏資訊提問時，這個技能就特別有用。

hig-project-context 實際在做什麼

hig-project-context 是一個蒐集脈絡與寫入脈絡的技能，不是 UI 設計產生器。它會掃描 repository 中的訊號，例如 README 內容、package 或 Xcode 的平台設定、Info.plist、程式碼中使用的 frameworks、asset catalogs，以及無障礙相關線索，然後請使用者確認或修正它的判讀結果。

為什麼大家會安裝它

當你希望減少來回溝通，並讓整個專案中的 Apple 設計指引更一致時，就適合安裝 hig-project-context。如果你已經厭倦每次新的 HIG 相關任務開始時，都要重複回答相同的平台、產品與技術問題，它會特別實用。

最適合與不適合的情境

這個技能適合已經有程式碼或可供檢查的 repo metadata 的專案。它對空白想法、非 Apple 產品，或只需要一次性提示、完全不需要可重用共用脈絡的情境，幫助就比較有限。

如何使用 hig-project-context 技能

安裝並啟用 hig-project-context

先依照 repository 的技能安裝流程完成安裝，接著在你想建立或更新 .claude/apple-design-context.md 時呼叫 hig-project-context。實務上，hig-project-context install 這一步的重要性，不如確保這個技能已經能在你的 Claude 工作流程中使用，並且指向正確的 repository 根目錄。

一開始就提供正確的輸入

當你的請求同時包含粗略的專案目標與 repo 位置時，這個技能的表現最好。好的起始提示要足夠具體，能引導它搜尋，但又不能詳細到把缺漏的脈絡完全蓋掉。

例如：

• “Use hig-project-context to build a shared context file for this Apple app. It’s a health tracking app with SwiftUI and iPhone-first support.”
• “Run hig-project-context for this repo and tell me what platform and framework signals you find before writing the context file.”

在信任輸出前，先檢查這些內容

先從 SKILL.md 開始，再檢查這個技能設計上會讀取的 repo 檔案：README.md、Package.swift、.xcodeproj、Info.plist，以及程式碼本身。repo 節錄中沒有任何 helper folders，表示這個技能刻意保持輕量；它的價值在於探索與判讀流程，而不是依賴龐大的輔助規則集合。

讓結果更乾淨的工作流程

一個表現良好的 hig-project-context usage 流程是：

1. 讓技能蒐集 repo 證據。
2. 檢視它找出的產品、平台與 framework 訊號。
3. 確認或修正脈絡。
4. 將結果存成 .claude/apple-design-context.md。
5. 在呼叫其他 HIG 技能時重複使用這個檔案。

這個順序可以避免下游技能在平台範圍上靠猜測行事，而這正是許多 Apple 指引出錯的來源。

hig-project-context 技能 FAQ

hig-project-context 只適合新專案嗎？

不是。對於那些從未有過共用 Apple 設計脈絡檔，或脈絡已經逐漸失真的既有 repo，它同樣有用。如果團隊一直在重複回答相同的設定問題，這個技能就能把那些脈絡標準化。

這和一般 prompt 有什麼不同？

一般 prompt 可能只會一次性詢問平台細節。hig-project-context 則是一套可重複使用的工作流程，用來發現、確認與保存專案脈絡，讓後續的 HIG 技能可以直接依賴它，而不用每次從頭開始。

初學者需要先懂 Apple HIG 嗎？

不需要，但你至少要有一個真實的 repo，或至少一個明確的目標專案。這個技能對初學者友善的地方，在於它會提出正確的探索問題；但它無法取代缺乏的產品知識。

什麼情況下我不該用它？

如果你的任務與 Apple 設計指引無關、沒有 repository 可供檢查，或你只需要一次性的答案而不想建立共用脈絡，就不要使用 hig-project-context。

如何改進 hig-project-context 技能

提供更強的來源訊號

hig-project-context 的品質，取決於它能驗證多少資訊。請提供 repo root、說明預期的 Apple 平台，並指出你已知的 framework 選擇，例如 SwiftUI、UIKit、HealthKit 或 widgets；如果這些資訊不容易從程式碼看出來，更應該直接說明。

要確認脈絡，不要只是照單全收

hig-project-context guide 最有價值的行為是審核與修正，而不是無腦自動化。如果技能推斷錯了目標平台、部署範圍或 app 類別，請立刻更正，讓下游技能繼承到的是準確脈絡。

補上它缺少的決策點

如果第一次跑出來的內容不完整，就補上對設計指引最重要的事實：用一句話描述產品用途、目標裝置、最低 OS 版本、關鍵功能，以及任何無障礙限制。這些細節會直接影響其他 HIG 技能應該如何回應。

重複使用檔案，並在範圍變動時更新它

最大的失敗模式是脈絡過時。當 app 新增平台、切換 UI framework，或核心使用情境改變時，請更新 .claude/apple-design-context.md；否則，hig-project-context for Skill Authoring 只會把舊假設一路帶進後續建議裡。