1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | guizang-social-card-skill |
| 作者/维护者 | op7418(归藏,独立开发者) |
| 来源链接 | https://github.com/op7418/guizang-social-card-skill |
| 许可证 | GNU AGPL-3.0(另提供商业许可选项,见仓库内 COMMERCIAL_LICENSING.md) |
| GitHub Stars | 5,124(GitHub API 实测) |
| Forks | 425(GitHub API 实测) |
| 最新版本 | 仓库尚未发布正式 Release 版本号,以 main 分支提交为准 |
| 安装方式 | npx skills add 一键安装,或手动克隆至 ~/.claude/skills/ |
2. 功能介绍与亮点
guizang-social-card-skill 是一个面向社交媒体图文创作的 Agent Skill,核心能力是批量生成三类视觉素材:
- 小红书图文组图(3:4 比例,适配多图轮播)
- 微信公众号封面对(21:9 头图 + 1:1 分享卡)
- Live Photo 动态卡片(3–5 秒短视频卡,含单视频、二/三/四宫格拼图)
亮点包括:
- 双视觉系统:Editorial(杂志风,适合旅行/生活/影评类内容)与 Swiss(瑞士国际主义风格,适合产品评测/数据/方法论类内容),共 28 个版式骨架、10 套主题预设,且不开放自定义 hex 色值以保证美学一致性
- 智能图源工作流:本地图 → 可选 AI 生图 → Unsplash/Pexels/Wallhaven 网络取图的优先级链路,并自动生成图源记录 SOURCES.md
- MapLibre 地图组件:适合旅行博主标注目的地与路线
- 自动校验脚本:9 条规则检测文字溢出、字号、密度等排版问题
- 单文件 HTML + Playwright 渲染:无需前端构建链路
3. 适用场景
固定分类:前端与设计
适合小红书/微信公众号内容创作者、自媒体运营者、以及需要批量产出统一视觉风格图文而自身不具备设计背景的个人或小团队。
4. 跨 Agent 兼容性
- Claude Code:原生支持,官方安装命令面向 Claude Code 技能目录(
~/.claude/skills/) - Codex:原生支持,仓库自述明确标注为 “Claude Code / Codex skill”
- OpenClaw:未验证,已抓取材料未提及
- Hermes Agent:未验证,已抓取材料未提及
5. 推荐理由
用规则化设计系统替代随意 AI 配图,让非设计师也能产出杂志级小红书与公众号视觉内容。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 5,124 stars(GitHub API 实测),星标规模已有一定体量;但第8章显示目前尚无可验证的独立第三方具名评价,社区讨论热度证据薄弱,综合两项证据后落在 8 分 |
| 可用性 | 9 | npx skills add 一键安装或手动克隆两条路径都无需额外配置,单文件 HTML + Playwright 渲染无需前端构建链路,默认工作流不要求任何 API Key |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合 | 8.3 | 三项均值 |
安全检查清单:
- Shell 命令执行:本地运行
render.mjs(渲染)与校验脚本,范围明确、开源可审计 - 联网外发:按需拉取 Unsplash/Pexels/Flickr/Wallhaven 图库素材与 MapLibre 地图瓦片,均为渲染所需素材获取,行为在文档中透明说明,非用户数据外发
- API Key/凭据:默认工作流不需要;仅当用户主动选用 AI 生图功能时才可能涉及
- 可疑指令:抓取到的 README/SKILL.md 中未发现 prompt injection 或混淆代码迹象
- 作者信誉:独立开发者出品,非官方机构背书
- License:AGPL-3.0,条款清晰,含“网络服务条款”(详见第 11 章)
- 维护时间:近期仍有提交记录,属活跃维护状态
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与本技能的差异 |
|---|---|---|
| canvas-design(Anthropic 官方) | 通用画布设计与渲染框架 | 提供通用设计原则,不含小红书/公众号等中文社交平台的专属尺寸规范与版式库 |
| theme-factory(Anthropic 官方) | 生成品牌主题与视觉规范 | 偏向通用 UI 主题生成,不含面向社交媒体发布的成品卡片模板 |
| gzh-design-skill | 将 Markdown 一键转为可粘贴进微信公众号编辑器的 HTML 排版 | 仅覆盖微信公众号一个场景,不含小红书图文、Live Photo 动态卡等能力 |
guizang-social-card-skill 的差异化在于针对中文社交平台的具体尺寸规范做了预置,并把设计约束(固定主题色、版式骨架)内置进工作流,减少“看起来像 AI 做的”配图问题。
8. 用户评价
该技能目前在第三方 AI 工具收录站点(如 AI 工具集、Toolin AI 等)有产品功能介绍报道,但相关页面尚未出现具名第三方用户的使用评价或评论。
9. 其他补充
仓库提供中英双语 README(README.md / README.en.md)。作者 op7418(归藏)另维护姊妹项目 guizang-ppt-skill,将同一设计语言延伸到演示文稿场景。
10. 安装使用方式
一键安装(推荐):
npx skills add https://github.com/op7418/guizang-social-card-skill --skill guizang-social-card-skill
手动安装:克隆仓库至 ~/.claude/skills/ 目录。
环境要求:Node.js + Playwright(用于真实 DOM 测量渲染 PNG)。
触发方式:安装后在对话中直接描述需求(如“帮我做一套小红书图文”)即可自动触发,内部工作流为 Intake → Style Selection → Layout → Asset Prep → Compose & Render → Deliver → Iterate 共 7 步。
11. 注意事项
- AGPL-3.0 含“网络服务条款”:若将本技能封装为面向公众的 SaaS 服务对外提供,需公开完整源代码;个人或团队内部使用不受此约束。如需商用豁免,可参考仓库内 COMMERCIAL_LICENSING.md 说明的商业许可选项
- 渲染依赖 Playwright 浏览器引擎与本地 Node.js 环境,首次使用需完成环境安装
- 网络图源功能依赖 Unsplash/Pexels/Flickr/Wallhaven 等第三方服务的可用性,这些服务不可达时会影响取图效果
- 仓库尚未发布正式版本号(无 Git tag/Release),版本管理以 main 分支提交为准
- OpenClaw、Hermes Agent 的兼容性未经验证,如需在这两个环境使用建议先行小范围测试