hyperframes-registry

hyperframes-registry 技能概覽

hyperframes-registry 的用途

hyperframes-registry 技能能幫你更有把握地安裝並串接可重用的 HyperFrames registry 項目，比起泛用提示更少猜測。它是為了把 hyperframes add <name> 的輸出，真正落成可運作的組合而設計的；不論你是在新增 block、合併 component，還是想先確認 registry 裡已有什麼，它都很適合。

最適合的使用情境

當你需要一份實用的 hyperframes-registry guide 時，可以用 hyperframes-registry 來處理：

• 將 registry 項目安裝到既有專案中
• 判斷某個項目是 block 還是 component
• 把已安裝的檔案串到 index.html
• 讀懂 hyperframes.json 的路徑對應
• 在決定採用哪個項目之前先做 registry 探索

它的差異在哪裡

這個技能最強的地方，在於安裝路徑、檔案類型與整合步驟都很關鍵的時候。Block 會像獨立的子組合一樣運作，擁有自己的尺寸與時間軸；component 則是會合併進主組合的片段。這個區分正是 hyperframes-registry 技能在你動手改檔前，先幫你釐清的核心決策點。

如何使用 hyperframes-registry 技能

安裝並檢視正確的檔案

進行 hyperframes-registry install 時，請把這個技能和 repository 結構一起看，而不是拿它取代 repository。先從你要安裝的項目開始，再閱讀：

• SKILL.md：工作流程
• references/discovery.md：registry 查找與 manifest 欄位
• references/install-locations.md：預設路徑與 hyperframes.json 重新映射
• references/wiring-blocks.md 或 references/wiring-components.md：依項目類型而定
• examples/add-block.md 與 examples/add-component.md：端到端範例流程

把模糊需求改寫成好提示

好的 hyperframes-registry usage 是從明確目標開始，而不只是丟一個名稱。有效的輸入應包含：

• 項目名稱
• 你要的是 block 還是 component
• 它應該放在專案的哪裡
• 你是要接到既有組合，還是從頭開始
• hyperframes.json 裡是否有路徑重新映射

提示詞範例：
Install data-chart into my HyperFrames project, wire it into index.html, and tell me which files and attributes need updating.

避開常見錯誤的工作流程

可靠的 hyperframes-registry guide 流程如下：

1. 在專案中執行 hyperframes add <name>。
2. 檢查寫入的檔案，以及 CLI 列出的片段。
3. 確認該項目是 block 還是 component。
4. 用 data-composition-src、data-start、data-duration 和 data-track-index 來串接 block。
5. 依照片段指示，把 component 合併進 HTML、CSS 與 JS。
6. 如果你的專案覆寫了 hyperframes.json#paths，就更新對應路徑。

提升品質的實用建議

想要更好的輸出，就要告訴技能你的組合目前已經包含什麼。比方說，請提到現有的 canvas 尺寸、時間軸長度，以及你是否已經有 host data-composition-id。這對 hyperframes-registry for Design Implementation 很重要，因為 block 必須符合主機版面，而 component 必須能融入目前的時間軸與樣式。

hyperframes-registry 技能常見問答

這只適合安裝任務嗎？

大致上是。hyperframes-registry 技能的重點在安裝、探索與串接決策。如果你只是想理解 HyperFrames 的概念，用一般提示就夠了；如果你需要可執行的檔案路徑與整合步驟，這個技能就更合適。

block 和 component 有什麼差別？

block 是完整的組合，擁有自己的尺寸與持續時間，設計上是用 data-composition-src 嵌入。component 則是貼進既有組合的片段。如果你需要獨立的時間控制或獨立畫布，就選 block；如果你需要的是會融入目前場景的效果，就選 component。

初學者需要先熟悉 repository 嗎？

不需要。只要你能辨識目標是「安裝這個項目並把它串好」，這個技能對初學者也很友善。初學者最大的風險，是在 hyperframes add 之後跳過 wiring 步驟。repository 參考文件會把這個風險降下來，因為它直接告訴你下一步該看哪裡。

什麼情況下不該用這個技能？

如果你不是在處理 HyperFrames registry、如果你根本沒有要安裝任何東西，或者如果你已經知道要改哪些檔案，只需要把提示詞微調得更精簡，那就不必用 hyperframes-registry。它最有價值的時機，是安裝決策與整合細節還沒定案的時候。

如何改進 hyperframes-registry 技能

補上技能缺少的限制條件

提升品質最直接的方法，就是告訴 hyperframes-registry 目標組合的需求。請包含 canvas 尺寸、時間軸長度、安裝目錄偏好，以及主專案是使用預設 compositions/ 路徑還是有重新映射的路徑。這樣可以避免路徑不一致與 wiring 假設錯誤。

直接提供整合介面

想讓 hyperframes-registry usage 更準確，請貼出主組合中相關的片段，或把它描述清楚：

• index.html 的容器
• 既有的 data-composition-id
• 目前 GSAP timeline 的起始時間
• 已在使用的 wrapper 元素或圖層

這對 block wiring 特別重要，因為放置位置與圖層順序會影響新增項目是否能正常運作。

從第一版輸出開始迭代

如果第一次結果已經接近，但還不能直接用，就可以進一步要求其中一項：

• 依 hyperframes.json 修正後的安裝路徑
• 只保留最小 wiring 片段
• 針對同一個視覺目標，提供 block 與 component 的建議
• 將 HTML、CSS、JS 步驟分開的合併計畫

這種回饋迴圈，是在不把初始提示詞塞得太滿的前提下，提升 hyperframes-registry 結果的最快方式。