1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | gzh-design-skill |
| 作者/维护者 | 甲木（Jiamu）× 摸鱼小李（联名开发） |
| 来源链接 | https://github.com/isjiamu/gzh-design-skill |
| 许可证 | AGPL-3.0（仓库 LICENSE 文件原文实测；要求衍生作品同样开源） |
| GitHub Stars | 2,372（GitHub API 实测，2026-07-21） |
| Forks | 269（同上） |
| 最新版本 | v1.0.0（GitHub Release，发布于 2026-07-06） |
| 安装方式 | 一键命令 npx skills add、AI 自动安装、手动 git clone 三种途径 |
2. 功能介绍与亮点
gzh-design-skill 是一个专注于“把 Markdown 排成微信公众号文章”的技能：输入一篇 Markdown（也支持 Word / PDF / 纯文本，会先自动归一化），按选定主题输出样式全部内联、粘贴进公众号编辑器不掉格式的 HTML。
- 6 套精选主题 + 主题生成器：摸鱼绿、红白色系、石墨极简风、留白禅意风、摸鱼票据风、橄榄手记，每套都是独立的组件库（设计变量 + 数十个组件 + 按文章类型的组件配方表）；现成主题不够用时，可用一句话描述或一张参考图生成全新主题并保存本地复用。
- 智能排版：按
##顺序自动编章节号、每段主动提炼 1–3 个关键词加下划线、从正文提炼引言卡与目录要点、多处作者签名自动去重合并为一处。 - 双关卡质量校验：
component_lint.py校验主题组件库本身是否合规，validate_gzh_html.py校验最终产物是否触发公众号平台的样式限制（如<style>/class/position:fixed等禁用项），两道关卡都要求 ERROR 清零才算完成。 - 一键复制：额外生成一份带“复制到公众号”按钮的预览页，点击即把渲染后的富文本复制到剪贴板，跳过手动全选复制的步骤。
3. 适用场景
所属分类：前端与设计。适合需要把长文 Markdown 反复排版发布到微信公众号的内容创作者与团队内容运营，覆盖教程/操作指南、产品测评/工具盘点、深度观点、访谈特稿、数据复盘、生活随笔、案例实战等题材；核心受益点是省去“每篇文章都要重新对齐样式”的重复劳动，同时保证不同题材的排版气质统一、粘贴后不丢失格式。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——README 徽章与快速开始章节明确列出，手动安装路径为
~/.claude/skills/ - Codex：✅ 原生支持——README 同一徽章列出，支持通过
npx skills add或 AI 自动识别 SKILL.md 安装 - OpenClaw：❓ 未验证——未见相关适配说明
- Hermes Agent：❓ 未验证——未见相关适配说明
判断依据：README 徽章区（“Claude Code · Codex · Cursor”）与“快速开始”安装章节；技能本体遵循通用 SKILL.md 约定，理论上可被任意兼容该约定的 Agent 读取，但未见 OpenClaw / Hermes Agent 的明确适配证据。
5. 推荐理由
把公众号排版的样式对齐工作封装成可复用的主题组件库，配合双重校验机制，把“粘贴到公众号后样式错乱”这个高频返工点用确定性脚本兜底，而非单纯依赖模型细心。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | GitHub 2,372 Star、269 Fork（GitHub API 实测，2026-07-21），项目上线约 3 周即达到这一数字；GitHub 趋势榜单 trendshift.io 收录，另有独立中文技术博客“格律诗的软件世界”等撰文介绍 |
| 可用性 | 9 | 一键安装命令 / AI 自动安装 / 手动 clone 三种途径，无需 API key 或付费依赖；SKILL.md 与 README 文档完整含示例和效果预览图；内置双重校验脚本保证输出合规；最近一次提交在 13 天前 |
| 安全性 | 9 | 见下方安全检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令及权限范围 | 极小——已读取全部源码，仅含 4 个本地 Python 脚本（组件库校验、HTML 产物校验、docx 文本提取、预览页包装），无子进程调用、无系统级命令 |
| ② 运行时是否联网外发数据 | 无——全流程处理本地 Markdown/Word/PDF 输入与本地 HTML 输出，未见任何网络请求代码 |
| ③ API key/凭据存储方式 | 不需要任何 API key 或账号 |
| ④ 可疑指令/Prompt Injection 迹象 | 已通读 SKILL.md 全文与全部脚本源码，未发现可疑指令 |
| ⑤ 作者/组织信誉 | 甲木（Jiamu）与摸鱼小李联名开源；issue 区有十余位不同用户提交真实 bug 反馈与功能请求，维护者已合并部分贡献 |
| ⑥ License | AGPL-3.0，条款明确（衍生作品需同样开源） |
| ⑦ 最近维护时间 | 最近一次提交在 13 天前，v1.0.0 正式版发布于 2026-07-06 |
综合评分（三项均值）：8.3
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与 gzh-design-skill 的差异 |
|---|---|---|
| md2wechat-skill（geekjourneyx） | CLI 工具，提供 40+ 排版样式、AI 自动配图、批量发布与多账号管理 | 功能覆盖面更广，以数量和自动化流程见长；样式是可选模板列表，而非按文章题材匹配的主题组件配方库，也未将“粘贴后是否掉格式”做成独立的自动化校验关卡 |
| guizang-social-card-skill | 生成小红书图文卡片与公众号封面图（HTML → PNG 单图） | 面向的是封面/卡片这一张图的视觉设计，不处理长文正文的分段排版；两者定位互补，可配合使用（封面用卡片类工具、正文用本技能） |
8. 用户评价
技术博客“格律诗的软件世界”作者 JameCling 撰文点评：写完 Markdown 粘贴到公众号后样式经常错乱是常见痛点，该技能能一键输出粘贴后不失效的排版，主题组件体系经过长期实战打磨、每处视觉细节都做过平台适配校验，整体精细度较高。除此之外，项目也被多家中文科技资讯站转载介绍。
9. 其他补充
README 提供中英双语版本；项目通过 CONTRIBUTING.md 公开欢迎新主题、bug 修复与文档改进的社区贡献，新增主题需登记进 references/theme-index.md 并跑组件库 lint 脚本确认无反模式。
10. 安装使用方式
# 方式一：一键安装
npx skills add https://github.com/isjiamu/gzh-design-skill
# 方式二：手动 clone
git clone https://github.com/isjiamu/gzh-design-skill.git ~/.claude/skills/gzh-design也可以直接对 Agent 说“请帮我查找并自动安装 https://github.com/isjiamu/gzh-design-skill 这个 skill”，由其自行 clone 到对应技能目录并接入。安装后无需重启，直接说“用摸鱼绿把这篇文章排成公众号 HTML：article.md”即可触发；生成产物会自动跑校验脚本，交付时会附上校验结论。
11. 注意事项
- 仅适用于微信公众号平台的文章排版，不适用于普通网页/落地页、PPT、纯图片社交卡片等场景（作者在 README 中已明确列出不适用范围）
- AGPL-3.0 许可要求衍生作品同样以兼容协议开源，计划二次分发或商业化改造前需留意合规要求
- 主题体系与中文全角标点规范深度绑定，处理纯英文内容时部分排版细节可能需要额外确认
- OpenClaw、Hermes Agent 的兼容性暂未验证，两平台用户建议先小范围试用