Skip to content

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/workspace-scene-catalog.md

View on GitHub
# 工作面场景目录(Workspace Scene Catalog)

> zach-md-html 能力 2 · 工作面档(Tier B)的场景模板池。
> 12 个场景对应 Thariq 在 [HTML effectiveness](https://thariqs.github.io/html-effectiveness/) 中演示的 20 类工作面(合并相近场景后)。
> 当前 MVP 已实现 6 个;Phase 2 待补 6 个。

---

## MVP 6 个场景(当前可用)

### 1. `comparison` · 方案对比

**适合内容**:方案对比、技术选型、ADR(架构决策记录)、产品选型、"A vs B vs C"。

**典型 md 输入信号词**:
- 「方案 A / 方案 B / 方案 C」
- 「对比 / 比较 / 选哪个 / 选型」
- 「优点 / 缺点 / trade-off / 取舍」
- 「推荐 / 我们选择」

**视觉特征**:
- 三列 side-by-side(移动端竖向堆叠)
- 每列顶部:方案名 + 一句话定调 + 难度 / 成本 / 风险标签
- 中部:分行级 trade-off 对齐(每行一个维度,3 列同时呈现)
- 底部:「推荐方案 + 一句话理由」高亮区
- 内联取舍标签(绿勾 / 红叉 / 中性灰)

**JS**:无(pure CSS Grid)

---

### 2. `plan-board` · 计划面板

**适合内容**:实施计划、roadmap、里程碑、项目甘特、产品规划。

**典型 md 输入信号词**:
- 「实施计划 / 计划 / roadmap / 路线图」
- 「里程碑 / milestone / 阶段」
- 「时间线 / 时间表 / 排期」
- 「风险 / 风险点 / 依赖」

**视觉特征**:
- 顶部:项目名 + 总时长 + 关键节点
- 横向 timeline(含里程碑节点 + 标签)
- 中部:数据流 / 依赖图(pure SVG)
- 右侧或底部:风险表(行:风险描述 / 概率 / 影响 / 缓解)
- 关键里程碑用强调色

**JS**:无

---

### 3. `annotated-pr` · 代码评审

**适合内容**:代码评审、diff 讲解、PR writeup、commit 解读。

**典型 md 输入信号词**:
- 「PR / pull request / 评审 / code review」
- 「diff / 改了 / 修改 / 变更」
- 「before / after / 前后」
- 「严重程度 / severity / blocker / nit」

**视觉特征**:
- 主区:diff 块(- / + 行级颜色编码)
- 右栏:margin notes,行级关联到 diff 行
- 顶部:PR 标题 + 摘要 + 文件清单(jump link)
- severity 标签:blocker / nit / question / approve(颜色编码)
- 可折叠每个文件的 diff

**JS**:folder / 折叠

---

### 4. `incident-timeline` · 事故复盘

**适合内容**:事故复盘 / postmortem、故障分析、变更窗口、紧急处置记录。

**典型 md 输入信号词**:
- 「事故 / 故障 / incident / postmortem」
- 「复盘 / RCA / root cause」
- 含时间戳「14:02 / 14:05 / ...」
- 「日志 / log / error」
- 「跟进 / action items / TODO」

**视觉特征**:
- 顶部:事件标题 + 影响范围 + 持续时长 + severity
- 主区:竖向 timeline(分钟级 / 秒级),每个节点:时间戳 + 事件描述 + 日志摘要(可折叠)
- 右侧或底部:跟进 checklist
- 关键节点(first impact / detected / mitigated / resolved)用色块强调

**JS**:folder(日志摘要展开)

---

### 5. `feature-explainer` · 新特性解释器

**适合内容**:新功能文档、API 介绍、特性公告、技术解释。

**典型 md 输入信号词**:
- 「新特性 / 功能 / feature」
- 「API / 接口 / endpoint」
- 「示例 / example / 代码」
- 「常见问题 / FAQ / 注意事项」

**视觉特征**:
- 顶部:TL;DR 框(3 行说清是什么 / 给谁 / 怎么用)
- 中部:折叠 / tab 分步说明
- 代码示例区:tab 切多语言 / 多场景
- 底部:FAQ 折叠 + 边界 / 已知问题

**JS**:tab + folder

---

### 6. `status-weekly` · 周报 / 月报

**适合内容**:周报、月报、OKR 进度、季度总结。

**典型 md 输入信号词**:
- 「周报 / 月报 / status / update」
- 「Shipped / Slipped / 上线 / 推迟」
- 「KPI / 指标 / 目标 / 进度」
- 「下周计划 / next week」

**视觉特征**:
- 顶部:周期 + 整体状态色块(绿 / 黄 / 红)
- KPI 区:3-5 个大字号数字 + 同比 / 环比小箭头
- 中部:Shipped(绿)/ In Progress(黄)/ Slipped(红)三列
- 底部:下周计划 + Blocking risks
- 可选小图表(pure SVG 折线 / 柱状,无外部 JS 库)

**JS**:folder(详情展开)

---

## Phase 2 待实现(6 个)

### 7. `module-map` · 模块地图(架构理解)

box-and-arrow 架构图 + 模块说明 + 入口点列表 + hot path 高亮。JS:hover/click 节点高亮关联模块。

### 8. `design-tokens` · 设计令牌 / 设计系统

色板 + 字号尺 + spacing 量规 + 阴影 / 圆角 / border 样本。每个 token 一键复制。JS:copy-to-clipboard。

### 9. `prototype-flow` · 可点击原型

4-6 屏横向 frame 队列 + 状态指示 + 跳转。JS:tab / 状态切换。

### 10. `figure-sheet` · 图表合集

SVG figure 网格 + 标注 + 图说表。一键复制单个 SVG。JS:copy-to-clipboard。

### 11. `concept-interactive` · 概念交互讲解

适合教学:live 图示(如一致性哈希环)+ 旁注 + 术语 hover。JS:slider / hover。

### 12. `triage-board` · 工单分类看板

Now / Next / Later / Cut 四列 kanban + 标签筛选 + 导出。JS:本地筛选 + copy-to-markdown 导出。

---

## 场景自动识别策略(--scene auto)

当用户传 `--scene auto` 时,AI agent 应该按以下顺序判断:

1. **强信号词命中**(如「事故复盘」「方案对比」「周报」)→ 直接选对应场景,置信度 90%+
2. **结构特征命中**(如含时间戳竖列 → incident-timeline / plan-board;含三段并列结构 → comparison)→ 置信度 70-90%
3. **弱信号或多场景模糊**(如同时提到"对比"和"时间线")→ 反问用户「你想要哪种工作面?」
4. **完全不像工作面**(纯散文 / 论文 / 教程)→ 降级到 default 阅读型档

**置信度 < 70% 不要硬选**——降级到 default 比选错模板好。

---

## 何时升级到 free-design

当用户描述的产物**超出 12 个场景模板的能力边界**时,走 free-design:

- 「做一个 dashboard」(多模块布局、卡片网格、状态总览)
- 「做一个自定义编辑器」(form + 实时预览)
- 「做一个 playground」(输入 + 实时输出)
- 「做一个 landing page 风格的产品介绍」(hero + features + CTA)
- 用户明确要求"自由发挥" / "完全自定义"

free-design 不走 pandoc,AI 直接 Write 一个完整自包含 HTML 文件,但**必须通过 `anti-ai-slop.md` 末尾的 6 条自检**。

---

## 不要做的事

- ❌ 在工作面档里强行用阅读型主题(article/report/...)的 CSS — 工作面是空间化布局,阅读型是单栏阅读
- ❌ 凭直觉选场景模板而不读用户的实际 md — 场景应该由内容形态决定,不是关键词命中即用
- ❌ 在工作面里塞所有 12 个场景能装的东西 — 一个 HTML 一个场景,专心做好它
- ❌ 用外部 JS 库 / CDN / React / Vue 来"做出更花的工作面" — 见 `js-interaction-allowlist.md`
- ❌ 抹掉「复制为 markdown」按钮 — 这是工作面的身份标识
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall