用途：在首次调用 Framer Agent 之前加载，覆盖官方 framer 技能忽略的实战经验，包括真实构建中出现的故障、易被误导之处以及无法撤销的操作。每条发现附有日期，便于过期后重新核验。用户指令始终优先于本技能的默认值。
主要能力：按主题组织参考文件，涵盖会话连接与多智能体、exec 脚本与 applyChanges 结果、DSL 与节点属性、文本样式与字体、断点适配、组件与代码、CMS、表单与 Webhook、图片素材、页面与元数据、HTML 参考重建、验证、破坏性操作、线上文件、构建检查清单等。
用法：先对比远程 SKILL.md 的 metadata.version；远程较新则本次会话使用远程版本并拉取对应 references。安装更新可运行 npx skills add fredm00n/framerlabs --skill framer-agent-playbook，或在 CLAUDE.md / AGENTS.md 中加 framer-agent-playbook: auto-update, contribute。连接使用 npx @framer/agent@latest setup，随后项目授权与 session new，再加载官方 framer 技能并读取生成的 index.md 与 project-inventory.md。
关键限制：API 与 CLI 没有撤销、历史或恢复；删除或覆盖即不可逆。删除集合列表页会连带删除其 CMS 详情页；removeNodes 不会移除组件变体、变量及部分表单节点，需 DEL。每次删除后须回读父节点。collection.addItems 会整体替换命名字段。MOVE 或 SET 每次 applyChanges 只发一条并回读。res.errors 是按消息为键的对象，需用 Object.keys(res.errors).length 判断。临时 id 在 exec 会话内保留，复用会写错节点。发布可能被权限检查拦截，且仅当用户要求时发布。
适用场景：在通过 Framer Agent 连接、编辑、构建或发布 Framer 项目时，尤其是线上生产站点、沙盒外的新构建与多智能体协同场景。