hyperframes-registry

hyperframes-registry skill 概览

hyperframes-registry 的作用

hyperframes-registry skill 能帮你安装并接入可复用的 HyperFrames registry 项目，减少像通用提示词那样靠猜的成分。它面向的是真实工作场景：把 hyperframes add <name> 的输出变成可用的组合，无论你是在添加 block、合并 component，还是检查 registry 里已有些什么。

最适合的使用场景

当你需要一份实用的 hyperframes-registry guide 时，用 hyperframes-registry skill 来处理这些任务：

• 将 registry 项安装到现有项目中
• 判断某个项目是 block 还是 component
• 把已安装文件接入 index.html
• 读取 hyperframes.json 的路径映射
• 在真正决定采用之前先发现可用的 registry 项

它和其他方法有什么不同

这个 skill 的优势在于：当安装路径、文件类型和集成步骤很关键时，它能帮你把问题说清楚。Blocks 的行为像独立的子组合，有自己的尺寸和时间轴；components 则是会并入宿主组合的片段。hyperframes-registry skill 在你动手改文件之前，先帮你厘清这个核心判断。

如何使用 hyperframes-registry skill

安装并检查正确的文件

做 hyperframes-registry install 时，不要把这个 skill 当成仓库结构的替代品，而是要结合仓库布局一起用。先从你要安装的项目入手，然后阅读：

• 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 接线 blocks。
5. 按片段说明把 components 合并进 HTML、CSS 和 JS。
6. 如果项目覆盖了 hyperframes.json#paths，就更新路径。

提升结果质量的实用建议

想要更好的输出，就告诉 skill 你的组合里已经有什么。比如说明现有 canvas 尺寸、时间轴长度，以及是否已经有宿主 data-composition-id。这对 hyperframes-registry for Design Implementation 很重要，因为 blocks 必须匹配宿主布局，而 components 必须适配当前时间轴和样式。

hyperframes-registry skill 常见问题

这个 skill 只适合安装任务吗？

基本是。hyperframes-registry skill 面向的是安装、发现和接线决策。如果你只是想了解 HyperFrames 的概念，普通提示词就够了；如果你需要可工作的文件路径和集成步骤，这个 skill 更合适。

block 和 component 有什么区别？

block 是一个完整的组合，拥有自己的尺寸和持续时间，适合通过 data-composition-src 嵌入。component 则是你粘贴到现有组合中的片段。如果你需要独立时间控制或单独画布，选 block；如果你需要一个并入当前场景的效果，选 component。

新手一定要先了解仓库吗？

不需要。只要你能判断目标是“安装这个项目并把它接进来”，这个 skill 对新手也友好。新手最容易犯的错，是在 hyperframes add 之后跳过接线步骤。仓库参考文件会把下一步该看哪里讲得很清楚，能降低这种风险。

什么时候不该用这个 skill？

如果你不是在处理 HyperFrames registry，不是在安装任何东西，或者你已经知道该改哪些文件、只是想把提示词改得更短，那就不要用 hyperframes-registry。它最适合的场景，是安装决策和集成细节还没完全定下来时。

如何改进 hyperframes-registry skill

补上缺失的约束

提升效果最大的办法，是告诉 hyperframes-registry 目标组合到底需要什么。把 canvas 尺寸、时间轴时长、安装目录偏好，以及宿主项目是使用默认 compositions/ 路径还是做了重映射，一并提供出来。这样可以避免路径不匹配和接线假设错误。

展示准确的集成面

想获得更好的 hyperframes-registry usage，可以直接贴出宿主组合的相关部分，或者把它描述清楚：

• index.html 容器
• 现有的 data-composition-id
• 当前 GSAP timeline 的起始时间
• 已在使用的 wrapper 元素或图层

这一点对 block 接线尤其重要，因为摆放位置和层级顺序会直接影响新增项目能否正常工作。

从第一版输出继续迭代

如果第一次结果已经接近目标，但还不够用，就继续细化，要求它输出其中一种内容：

• 基于 hyperframes.json 修正后的安装路径
• 只保留最小接线片段
• 针对同一视觉目标，给出 block 与 component 的选择建议
• 将 HTML、CSS 和 JS 步骤拆开的合并方案

这种反馈循环，是在不把初始提示词写得过重的前提下，最快提升 hyperframes-registry 结果质量的方法。