歸藏社交卡片技能
为 Claude Code / Codex 等 Agent 生成小红书图文与公众号封面对,内置编辑杂志风与瑞士国际主义双视觉系统。
证据显示：技能要求用户确认（如'ask whether to credit sources'），但未明确要求所有外部操作的用户确认；数据流透明性部分：有SOURCES.md记录图片来源，但未说明数据如何被处理或传输；敏感数据处理：未涉及用户敏感数据，但未明确说明；依赖安全：仅依赖playwright，但未提供版本锁定或安全审计；外部影响：会下载图片和调用外部API，但未明确限制或告知；回滚：提供git pull更新，但未提供版本回滚机制；来源归属：有SOURCES.md和版权说明，但未明确所有外部内容的归属。
自洽性：文档内部一致，但未提供测试结果；依赖可用性：依赖playwright，但未说明版本兼容性；失败消息：未提供明确的错误处理或用户提示。
受众和场景：明确列出适用和不适用场景，覆盖多种平台；能力边界：明确声明了不适用场景（如长视频编辑）；触发精度：提供了触发短语，但未明确触发条件；环境适配：支持多种agent环境，但未说明具体版本要求。
信息架构：目录结构清晰，文档齐全；安装说明：提供了多种安装方式；命名稳定性：版本号存在，但未说明命名规则；示例和FAQ：提供了丰富的示例和FAQ；已知限制：明确列出了不适用场景；许可证：AGPL-3.0，但package.json中为ISC，不一致；版本和变更日志：有HANDOFF.md和PRODUCT.md，但未明确CHANGELOG；维护责任：有贡献指南，但未明确维护者。
输出可用性：输出为PNG和Live Photo，格式明确；边际价值：提供了多种布局和主题，价值高；成本效益：需要Playwright和外部API，但未评估成本。
声明可追溯：文档中引用了references文件，但未提供具体证据；跨来源佐证：未提供外部验证；事实与推断分离：文档区分了事实和设计决策，但未明确标注。
- package.json 中的许可证为 ISC，与 README 中的 AGPL-3.0 不一致，需确认。
- 依赖仅声明 playwright，但未锁定版本，存在供应链风险。
- 外部图片下载和 API 调用未明确限制，可能带来隐私和安全问题。
- 未提供明确的回滚机制，更新后出现问题难以恢复。
这个 Agent 能做什么，适合哪些场景？
这是一个适配 Claude Code / Codex 等 Agent 环境的图文卡片技能,用于从文章、文案、截图、产品笔记、字幕、照片或用户视频生成小红书 / Rednote 图文组图、Live Photo 动态卡与公众号 21:9 + 1:1 封面对。它内置电子杂志风与瑞士国际主义两套视觉系统,提供 28 个版式骨架与 10 套主题预设,全部通过单文件 HTML + Playwright 渲染出 PNG,无需前端构建链。技能包含完整的工作流文档、校验脚本、Live Photo 生产指南,以及丰富的参考材料,适合需要稳定产出高质量社交卡片的个人或团队。
该技能读取用户提供的文章、文案、截图或视频,按 7 步工作流(Intake → Style & Theme → Layout Selection → Asset Prep → Compose & Render → Deliver & Review → Iterate)生成社交卡片。它支持三种画板尺寸(小红书 3:4、公众号 21:9、公众号 1:1),每个画板对应特定的 CSS 类。它可选择图片源(Unsplash、Pexels、Flickr CC、Wallhaven 或直接搜索),下载图片到本地并记录到 SOURCES.md。它使用种子模板(assets/template-editorial-card.html 和 assets/template-swiss-card.html)填充内容,并通过 node render.mjs 调用 Playwright 渲染出 PNG 文件。对于 Live Photo 请求,它会先判断信息量,然后输出 JPG + MOV + .pvt 包,并提示平台限制。它还提供 validate-social-deck.mjs 校验脚本,检测溢出、字号、密度等 9 条规则。
- 内容创作者需要将长文章快速转为小红书图文组图,且希望保持一致的视觉风格。
- 产品团队要发布产品测评或工具回顾,需要瑞士风数据卡片突显 KPI 和对比。
- 旅行博主将旅行照片和文案做成杂志风图文,强调氛围与叙事节奏。
- 公众号运营者需要同时生成 21:9 头图与 1:1 分享卡,且保持视觉一致。
- 视频创作者想把短片段做成小红书 Live Photo 卡片,需要指导如何剪辑和发布。
- 教程作者需要将截图美化并打包成讲解卡片,使用截图美化资产和工具类。
这个 Agent 有哪些优点和局限？
- 双视觉系统覆盖叙事与数据两类场景,且共用同一工作流,减少重复配置。
- 28 个版式骨架与 10 套主题预设确保输出稳定且风格统一,禁止自定义 hex 保护美学。
- 单文件 HTML + Playwright 渲染,Agent 可直接读写修改,无需前端构建链,交付简单。
- 内置校验脚本基于真实渲染测量,可自动化检查版式问题,提高输出质量。
- Live Photo 生成流程详细,涵盖单视频、拼图、三连等,并明确平台时长限制与发布路径。
- 仅明确支持 Claude Code 和 Codex,对普通 Chatbot 不推荐,限制了使用环境。
- 需要本地文件系统、shell 执行权限和网络(下载图片),不适合无这些能力的运行环境。
- 主题色限定为预设色板,不允许自定义,可能不满足特定品牌色需求。
- Live Photo 发布通常需要 iPhone 端路径,桌面端无法直接发布,增加流程步骤。
- AGPL-3.0 协议要求衍生品开源,可能不适合商业闭源项目。
如何安装或部署这个 Agent？
推荐使用一行命令安装:npx skills add https://github.com/op7418/guizang-social-card-skill --skill guizang-social-card-skill。或者直接克隆仓库到 ~/.claude/skills/guizang-social-card-skill:git clone https://github.com/op7418/guizang-social-card-skill.git ~/.claude/skills/guizang-social-card-skill。安装后检查 SKILL.md、assets/、references/ 是否存在。
如何使用这个 Agent？
安装后,直接对 Agent 说“帮我基于这篇文章做一套瑞士风小红书图文,5 张,IKB 蓝”即可触发。Agent 会依次执行 7 步工作流:确认平台、风格、内容素材和用户图片;从 10 套主题预设中选择;从 28 个版式骨架中选择;准备图片并下载到本地;渲染 HTML 到 PNG;展示结果给用户确认;根据反馈迭代。对于 Live Photo 请求,Agent 会先判断信息量,选择版式,输出 JPG + MOV + .pvt 文件,并提醒平台限制。
这个 Agent 与同类方案有什么区别？
姊妹项目 guizang-ppt-skill 专注于横向翻页演讲 PPT,本技能专注于静态信息流图文,两者共享美学语言但独立维护。