motion-graphics: point the Builder at hyperframes-creative's motion-principles.md
维护者通常 1 天内回复
评估
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 88/100
- Issue 类型
- 文档
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
调研方向
先从 skills/motion-graphics/agents/builder.md 和 skills/motion-graphics/SKILL.md 开始，跟踪 Builder 的 dispatch 上下文，然后检查 categories/charts/module.md 和 categories/stat/module.md。确认 motion-principles.md 和 data-in-motion.md 的引用已添加到要求的位置，并确认所有链接都能解析到现有的 hyperframes-creative 文件。
由索引模型根据 Issue 内容生成。
描述
Problem
skills/motion-graphics never references skills/hyperframes-creative (no mention in any file on main). As a result, hyperframes-creative/references/motion-principles.md is not on the motion-graphics read path, even though motion-graphics is the most motion-first workflow in the repo.
I checked whether its guardrails are covered elsewhere on that path (SKILL.md, agents/director.md, agents/builder.md, references/builder-contract.md, references/motion-vocabulary.md, plus the SKILL.md of hyperframes, hyperframes-core and hyperframes-animation). They mostly are not:
| motion-principles.md guardrail | Covered on the motion-graphics path? |
|---|---|
| Vary eases (≤2 tweens per scene with the same ease) | No |
.out for entrances, .in for exits, .inOut for moves |
No (only per-primitive examples in motion-vocabulary.md) |
| Vary duration (slowest scene ~3× the fastest) | No |
Vary entrance direction (not always y:30, opacity:0) |
No |
| Build / breathe / resolve scene structure | Partly (categories/kinetic-type only: Hook → Build → Punch → Resolve) |
| Stagger by importance, total stagger < 500ms | No |
| Exits faster than entrances | No |
| Offset the first tween 0.1–0.3s | No |
The only route to the file today is indirect (hyperframes-animation/adapters/animate-text.md, or the capability table in hyperframes/SKILL.md), so whether the Builder reads it depends on the agent's own initiative.
hyperframes-creative/references/data-in-motion.md has the same gap for the charts and stat categories.
Proposed solution
A small docs-only change:
skills/motion-graphics/agents/builder.md— add a line under "Critical correctness" (or a new "Motion quality" heading): read../hyperframes-creative/references/motion-principles.mdbefore writing the timeline.skills/motion-graphics/SKILL.mdStep 4 — add that file to the Builder's dispatch context list.skills/motion-graphics/categories/charts/module.mdandcategories/stat/module.md— reference../hyperframes-creative/references/data-in-motion.md.
Alternatives considered
Inlining a condensed version into references/motion-vocabulary.md. This avoids a cross-skill read but duplicates content that would drift from the original, so a link seems better.
Alternatives considered
Inlining a condensed version into references/motion-vocabulary.md. This avoids a cross-skill read but duplicates content that would drift from the original, so a link seems better.
Additional context
While building short HTML motion pieces with an AI coding assistant (outside HyperFrames), I hit exactly the failure modes this file warns about: uniform easing, missing exits, flat timing. That is what led me to compare the motion-graphics read path against motion-principles.md. I have not measured the effect inside the motion-graphics workflow itself.
- 主要语言
- TypeScript
- 星标
- 54.1k
- 派生
- 4.9k
- 平均合并
- 10 小时 45 分钟
- 30 天内合并 PR
- 654
环境准备
这个项目没有提供开发容器、Dockerfile 或贡献指南，环境需要你自己搭建：先看它的 README，通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
heygen-com/hyperframes 的其他 Issue
-
Player: speed button's accessible name doesn't include its visible text可能已有人在做 @Dante-dan 于 1 天前认领。 未关闭
难度 2/5 1-3 小时 新手友好度 77/100
heygen-com/hyperframes#6021 · 1 条评论 ·
维护者通常 1 天内回复
-
inspector: build.mjs resolves paths with URL#pathname, fails ENOENT (F:\\F:\\...) and aborts bun run build on Windows可能已有人在做 关联的 PR 仍在进行中或已合并。 未关闭
难度 1/5 1 小时以内 新手友好度 88/100
heygen-com/hyperframes#5863 · 1 条评论 ·
维护者通常 1 天内回复
-
product-launch-video: assemble-index.mjs is not idempotent — a second run drops every approved frame video可能已有人在做 @Dante-dan 于 6 天前认领。 未关闭
难度 2/5 1-3 小时 新手友好度 75/100
heygen-com/hyperframes#5733 ·
维护者通常 1 天内回复
-
gsap_tween_tail counts GSAP's force3D and autoRound flags as properties可能已有人在做 @rudycelekli 于 6 天前认领。 未关闭bug triage/needs-triage
难度 2/5 1-3 小时 新手友好度 78/100
heygen-com/hyperframes#5683 ·
维护者通常 1 天内回复
-
Timeline: show a clip's full name when its label is cut off可能已有人在做 @DanielMcSheehy 于 4 天前认领。 未关闭desktop-candidate difficulty/easy enhancement good first issue help wanted triage/ready
难度 2/5 1-3 小时 新手友好度 85/100
heygen-com/hyperframes#5582 · 2 条评论 ·
维护者通常 1 天内回复
查看 heygen-com/hyperframes 的全部 Issue
相似的 Issue
-
数据界面的横向滚动条缺失未关闭
难度 2/5 1-3 小时 新手友好度 62/100
zilliztech/attu#1037 ·
-
clawsweeper:fix-shape-clear clawsweeper:queueable-fix clawsweeper:source-repro impact:ux-friction issue-rating: 🦞 diamond lobster no-stale P3
难度 2/5 1-3 小时 新手友好度 76/100
openclaw/openclaw#181212 · 1 条评论 · 1 个 reaction ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 78/100
apify/apify-mcp-server#1684 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 82/100
Automattic/data-liberation-agent#953 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 78/100
siteboon/claudecodeui#1642 ·
维护者通常 5 天内回复