xikhar/papercraft
开发工具教编程 Agent 制作立体纸艺风格的游戏、互动场景、网页和动画的 Agent Skill。
这是一个 Agent 技能包 · 1 个技能看技能清单和安装方法 →项目介绍
papercraft 是一个 Agent Skill,教编程 Agent 用统一的立体纸艺(pop-up papercraft)风格制作游戏、互动场景、网页、动画和视频。目标是让画面读起来像拍摄下来的纸质模型:印刷卡纸、细切边、从印刷地面折起的铰链、被环境染色的柔和阴影、移轴微距镜头、克制的铰链运动以及纸张声效。适合想获得一致手工纸艺视觉、又不想自己从零搭建渲染层的开发者和设计师。
技能内容来自一款已上线的 three.js 立体纸艺游戏:如何让一帧画面像纸模照片、如何用可扩展的结构类型搭建物件(插接十字、分层平面、折盒与棱柱、穹顶、印刷水面,以及供行走的甲板、桥和楼梯),以及纸如何运动和发声 (2)。提示词和可选参考决定世界的配色、地面、建筑、生物和天气;调用方可以让 Agent 只用代码完成,也可以要求先生成概念图。仓库内的代码负责纸张材质、卡片、分层印刷、铰链、光照、镜头、行走和生命效果这些底层能力,具体主题的纸片造型由 Agent 自行设计。
快速使用
通过 Agent Skills CLI 安装,或把 skills/papercraft/ 复制到 Agent 的 skills 目录。它适用于支持 Agent Skills 的 Agent,例如 Claude Code、Codex、Cursor、Gemini CLI 和 OpenCode (2)。
npx skills add xikhar/papercraft
安装后直接用自然语言描述需求,例如折起式港口小镇的 three.js 场景、渲染成 MP4 的纸艺动画,或清晨灯塔小镇的竖屏 Reel。想先看模板效果,可以把资源目录通过 HTTP 提供出去:
npx serve skills/papercraft/assets
然后打开 /templates/popup-3d/ 或 /templates/popup-2d/,structures.html 展示所有结构类型。两个模板都支持 WASD 或方向键移动主角,加 ?still 切换为固定俯瞰视角 (2)。在自己的项目里,复制 assets/lib/ 和模板的 harness(3D 用 harness.js,2D 用 harness-2d.js),编写自己的 scene.js,并把页面 import map 中的 "papercraft/" 指向存放 lib/ 的目录。
输出尺寸与截图
同一场景可以输出 16:9 影片、9:16 Reel、方形或 4:5 帖子、4K 母版、超宽静态图和手机页面。镜头按画幅短边计算,竖屏会自动拉近并把主体避开平台字幕区域,印刷细节和模糊随分辨率调整 。在模板地址后加 ?size=1080x1920 或 ?aspect=9:16 可以预览其他画幅。capture.py 通过 Playwright 无头渲染标准尺寸的静帧和 MP4 片段,并报告构建耗时、最慢的印刷、主角卡片是否互相穿插以及页面错误 (2)。
使用约束
需要 Agent 支持 Agent Skills 格式;交互演示需要支持 WebGL 的浏览器来运行 three.js 模板,资源应通过 HTTP 提供而非直接打开本地文件。图像生成是可选项,只在调用方要求时使用。仓库采用 MIT 许可证 (2)。仓库内代码是底层设施和示例,最终视觉效果取决于 Agent 是否遵循技能里的参考和评审循环,结果会因 Agent 和提示词而异。
HotRepo 点评
该项目于 2026-11-22 出现在 HotRepo 的 JavaScript 新项目榜上,在约 1.5 小时的观察窗口中新增 4 Star、1 Fork,累计 105 Star。样本很小,只能证明早期上榜这一事实,不足以判断趋势。更有参考价值的是它的覆盖范围:它不是泛化的提示词合集,而是打包了具体的材质模型、结构库、运动与声效模块,以及截图和度量循环,这在 Agent 技能里比较具体。
本文由 AI 根据项目公开资料和 HotRepo 的记录撰写,更新于 ,以项目官方文档为准。
相关推荐
- vercel-labs/agent-skills把 Vercel 的 React、Next.js 与部署约定打包成技能,让 AI 编程助手按需加载。
- android/skillsGoogle 官方出品的 Android 技能文件,专门补上大模型最容易做错的那类 Android 开发任务。
- google-gemini/gemini-skills为编程助手提供关于 Gemini API、SDK 和实时接口的上下文技能,帮助生成更准确的调用代码。
- GoogleChrome/modern-web-guidance-src把精选的现代 Web 平台知识注入编码 Agent 的技能,让 Agent 在写网页时少用旧模式。
- expo/skillsExpo 官方给编程助手用的技能集,教它按 Expo Router、EAS 与 SDK 升级的约定写代码,而不是自己猜。