zach22-1999/generic-skills / skills/zach-md-html
zach-md-html
Verified已降级的 Markdown→HTML 兼容转换器。仅当用户明确要求“使用 zach-md-html”、或明确说“不要重组内容,只把现成 Markdown 机械转换成 HTML/套用旧主题”时使用。不要因为用户只说“输出成 HTML”“生成 HTML 报告”“把日常报告做成 HTML”“数据报告/交付报告”而触发;这些任务应由模型从原始资料直接组织并生成自包含 HTML。此 Skill 不负责数据可视化、工作面、自由设计、万物转 md、html 转 md 或 md 转 docx。
references/anti-ai-slop.md
View on GitHub# 反 AI slop — zach-md-html 的审美底线
> 这是从 `huashu-design` 继承并适配到「文档场景」的反slop清单。每一条违反都是品牌识别度的稀释。
> zach-md-html 三档模式共享同一份底线——default / workspace / free-design 都受约束。
> **free-design 档额外需要过末尾的「6 条快速自检」**——AI 直出 HTML 后必须自查,任一违规重产。
## 什么是 AI slop?
**AI slop = AI 训练语料里最常见的"视觉最大公约数"。**
紫渐变、emoji 图标、圆角卡片+左 border accent、SVG 画人物、深蓝底——这些东西不是因为它们丑,而是因为**它们是 AI 默认模式下的产物**,不携带任何品牌信息。
文档场景的 AI slop 就是:每个 AI 工具的默认 markdown 渲染器都长得一样——白底、Helvetica、淡蓝链接、emoji 当 list 标记、紫色系统消息。**用户读到这种页面,认不出谁的作品。**
## 文档场景的 7 条硬禁令
### 1. 紫色渐变 background 永远不要
| 不要 | 原因 |
|------|------|
| `linear-gradient(135deg, #667eea, #764ba2)` | 训练语料里"科技感"的万能公式 |
| 任何 hsl 紫色到蓝色的过渡 | SaaS/AI/web3 落地页烂大街 |
| 渐变 button、渐变 nav bar、渐变 callout | 视觉廉价感的源头 |
**例外**:用户明确要求紫渐变(罕见),或品牌本身就用(Linear 某些场景)。
### 2. Emoji 作为系统图标永远不要
❌ 这种排版:
```markdown
✨ **核心要点**
🔥 **关键发现**
💡 **思考**
⚡️ **行动项**
```
✅ 这样:
```markdown
**核心要点**
**关键发现**
**思考**
**行动项**
```
或用细微的字体样式(小型大写、斜体)做语义区分。
emoji 作为内容(文章里偶尔出现一个 ☕️ 表达情绪)OK;emoji 作为结构性图标永远不要。
### 3. 圆角卡片 + 左 border accent 烂大街组合
❌ 这种 callout:
```css
.callout {
border-radius: 12px;
border-left: 4px solid #blue;
background: #f0f4ff;
padding: 16px;
box-shadow: 0 2px 4px rgba(0,0,0,0.05);
}
```
是 2020-2024 Material/Tailwind 时期产物,已经成了视觉噪音。
✅ 用这种代替:
- 简单的 `<blockquote>` 配上极简风(左侧 3px 实线,无阴影)
- 不同 callout 类型用字体级差区分(小标题用 small-caps)
- 或者干脆用细的水平分隔线代替框
我们 4 套模板里的 blockquote 都遵守这条。
### 4. 深蓝底 #0D1117 永远不要
GitHub dark mode 美学的烂大街复制。**所有 AI 生成的 dark theme 默认都是这个色**——撞衫到名字都一样。
✅ 用这些:
- `#15181f`(report dark)— 中性偏冷
- `#1c1a16`(article dark)— 暖中性
- `#15130f`(reading dark)— 更暖
- `#1a1916`(interactive dark)— 中性偏暖
每个都和 #0D1117 不同,但都是"低饱和、暗调中性"。
### 5. 赛博霓虹(neon-green/cyan/magenta on black)
属于游戏UI风,不是阅读体验。
| 不要 | 用什么代替 |
|------|----------|
| `#00ff00` 霓虹绿 on 黑 | 静谧的森林绿 `#2c5e3f`(interactive) |
| `#00ffff` 霓虹蓝 on 黑 | 墨水蓝 `#1f4ea8`(report) |
| `#ff00ff` 霓虹紫 on 黑 | 永远不用 |
### 6. Inter / Roboto / Arial 大字号 display
不是说不能用 Inter(report 模板就用了 Inter 做 body),是说:
❌ **正文用 Inter,标题也用 Inter** → 看不出"有设计"还是"demo页"
✅ 正文 Inter / 标题用 serif 或不同字重的 sans → 字体级差是设计
我们的 4 套模板都遵守这条:要么标题/正文不同字族,要么不同字重 + 不同字号倍数 + 不同字距。
### 7. SVG 画人物/物体 imagery
AI 画的 SVG 人物永远五官错位、比例诡异。文档场景里基本不需要画人物——但万一遇到要"配图":
✅ 顺序:
1. 用真图(Wikimedia/Met/Unsplash/AI生成图片如 `nano-banana-pro`)
2. 用 placeholder 灰块 + 文字标签("产品图待补")
3. 删掉这个图位
❌ 永远不要:
- 用 SVG 手画一个简笔画人
- 用 emoji 大字号代替 illustration
- 用纯色块 + Bezier 曲线"暗示"图
## 5 条软原则(情境判断)
### 8. 一处 120%,其他 80%
文档里一定要有一个**值得截图**的细节签名:
- article 的 hr 用 30% 宽细线
- report 的 KPI grid 数字大字号 + 极细 grid 线
- reading 的 hr 用 "· · ·" 三点居中
- interactive 的 sidebar TOC 上面有"目录"小型大写标签
每套模板都有自己的"那一处"。**不要每个地方都精致——会变成均匀平淡。**
### 9. 配色用 spec 里已有的
不要凭空发明色。每套模板的 `theme.css` 顶部有 CSS 变量定义所有色——所有自定义元素也只能从这些变量取色。
❌ 突然加一个 `color: #333` — 不在 spec 里
✅ `color: var(--color-ink)` — 用 spec
### 10. 链接颜色不要太抢戏
文档场景里链接很多。如果每个链接都鲜艳一下,整页就花了。
✅ reading 模板的处理:链接颜色用 ink(=正文色),下划线用 accent — 既能识别又不抢戏
✅ article/report/interactive:链接用 accent 但稍微调暗 + 极细下划线
❌ 不要:bright blue + bold
### 11. 阴影克制
文档不需要阴影。表格不需要阴影。引用块不需要阴影。代码块不需要阴影。
唯一可能的阴影场景:图片的极细投影(`box-shadow: 0 1px 2px rgba(0,0,0,0.04)`)让图片"贴在纸上"。
不要堆叠阴影、模糊半径>10px的阴影、彩色阴影。
### 12. 装饰性 icon 永远不需要
文档里看到这种:
```markdown
🚀 **能力**:超快速度
✨ **特性**:非常优秀
🎯 **目标**:很重要
```
每个标题都配 emoji,是"不够专业就用 emoji 凑"的病。
我们 4 套模板的 SKILL.md 里都没有装饰性 emoji(除了 SKILL.md frontmatter 的触发词列表)。
## 反例隔离(演示反 slop 时)
如果你的文档**就是要演示什么是 slop**(比如本文档),不要让整页变 slop。用诚实的 bad-sample 容器隔离:
```html
<div class="bad-sample">
<span class="bad-tag">反例 · 不要这样做</span>
<!-- 反例内容 -->
</div>
```
```css
.bad-sample {
border: 1px dashed var(--color-rule-strong);
padding: 1em;
margin: 1em 0;
position: relative;
opacity: 0.7;
}
.bad-tag {
position: absolute;
top: -0.6em;
left: 1em;
font-size: 0.75em;
background: var(--color-paper);
padding: 0 0.4em;
color: var(--color-ink-mute);
}
```
这种容器明确告诉读者"这是反例",反例服务于叙事而不是污染主调。
## 检查表(每次输出 html 前过一遍)
- [ ] 没有紫渐变
- [ ] 没有 emoji 作系统图标
- [ ] 没有圆角卡片+左 border 烂组合
- [ ] dark mode 底色不是 #0D1117
- [ ] 没有霓虹色
- [ ] 标题/正文不是同一个 sans 字体
- [ ] 没有 SVG 手画人物
- [ ] 链接不抢戏
- [ ] 阴影克制(≤1层,blur ≤ 4px)
- [ ] 没有装饰性 emoji
- [ ] 配色全部用 CSS 变量(不凭空发明色)
- [ ] 至少有一处 "120% 细节"
## 与 huashu-design 的关系
`huashu-design` 是设计哲学的源头(含 20 种风格、设计方向顾问、品牌资产协议、动画/演示/原型守则)。
`zach-md-html` 是它在"文档 + 工作面场景"的窄域应用(继承自 `huashu-md-html`):
- 不做品牌资产协议(文档场景用户极少传 logo/产品图)
- 不做设计方向顾问(用 5 套阅读型主题 + 12 个工作面场景模板 + free-design 自由档替代)
- 反 AI slop 哲学**完整继承**
- 排版底线**完整继承**
如果你做的是动画/原型/演示/品牌设计——回到 `huashu-design`。
如果你做的是文档/报告/文章/书籍/工作面——用本 skill。
---
## Free-design 档 · 6 条快速自检(强制)
当走 free-design 档(AI 直出 HTML,不走 pandoc),HTML 写完后必须**逐条过一遍**,任一违反必须重产,不要妥协。
| # | 自检项 | 通过判定 |
|---|--------|---------|
| 1 | **最大宽度** | 单栏内容 ≤ 820px。dashboard / 多卡片网格类布局每个卡片内的文字段 ≤ 820px |
| 2 | **正文行高** | 中文正文 line-height ≥ 1.7(推荐 1.75-1.85),英文 ≥ 1.6 |
| 3 | **字体** | 中文用衬线(Source Han Serif / 思源宋 / PingFang SC)或系统 sans(PingFang SC);英文用 Inter / IBM Plex Sans / Georgia;代码用 JetBrains Mono。**禁止 Comic Sans / Roboto / Arial 大字号 display** |
| 4 | **配色** | 无紫渐变(任何 hsl 紫到蓝过渡)/ 无赛博霓虹(neon green / cyan / magenta)/ 无 #0D1117 深蓝底。dark mode 底色用本文档列出的暖中性替代色 |
| 5 | **容器形态** | 无圆角卡片 + 左 border accent + 浅色底 + 阴影的烂大街组合。用诚实分隔(细线 / 留白 / 字体级差)代替 |
| 6 | **emoji** | emoji 仅用于装饰性内容(如某段引用情绪),**不作系统图标 / 不作 list bullet / 不作 callout 标记** |
**6 条全部过 = 通过**。任一未过 = 重写 HTML,不要"小修小改地强行通过"。
### 自检的具体做法
free-design 档完成 Write 之后,AI agent 应该:
1. 读自己刚写的 HTML
2. 对照上面 6 条逐条判断
3. 如果发现违规,**回到 anti-ai-slop 主清单**(前面的 7 条硬禁令 + 5 条软原则)查阅理由
4. 重新生成 HTML,再过 6 条
如果连续两次自检不过,**降级到 default 档**(用 pandoc + 阅读型主题)并显式告知用户:"free-design 自检多次不过,已降级为 default。"
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |