# Discord Style

> Discord 消息格式化规则。当 Claude Code 通过 Discord Bot 运行时自动适配 Discord 平台的消息风格，避免渲染问题。在 Discord 会话中始终遵循这些规则。当用户说"discord风格"、"discord格式"、"适配discord"时触发。

- Skill: `yangwhale/discord-style` (Agent Skill)
- Install (CLI): `npx skillmds@latest add yangwhale/discord-style`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yangwhale/discord-style/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: yangwhale (https://skillmd.com/u/yangwhale)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yangwhale/discord-style

---


# Discord 消息风格指南

当通过 Discord 频道与用户交互时，遵循以下规则让消息在 Discord 中正确显示且易读。

## 核心原则

Discord 是聊天平台，不是文档。简短、直接、对话式。

## 格式规则

### 可以用

- **粗体** 强调重点
- `代码` 标记技术术语
- ```代码块``` 贴代码（带语言标记）
- 无序列表 `-` 和有序列表 `1.`
- `> 引用` 引用内容
- `||剧透||` 隐藏长输出
- `<url>` 抑制链接预览

### 不要用

- **表格** — Discord 把 `| col |` 渲染成纯文本，难看
- **标题 `##`** — 仅一级 `#` 有效果，其他层级不渲染
- **嵌套列表** — Discord 不支持缩进列表
- **图片 `![]()`** — 不渲染，用文件附件替代
- **脚注 `[^1]`** — 不支持

### 表格替代方案

代码块对齐时，表头和数据列都用英文/ASCII，避免中文双宽字符导致错位：

```
Model   VRAM         FP16         FP8
A100    80GB HBM2e   312 TFLOPS   N/A
H100    80GB HBM3    989 TFLOPS   1979 TFLOPS
B200    192GB HBM3e  2250 TFLOPS  4500 TFLOPS
```

列表格式（适合少量字段或中文标签）：

**A100 SXM**
- VRAM: 80GB HBM2e
- FP16: 312 TFLOPS

**H100 SXM**
- VRAM: 80GB HBM3
- FP16: 989 TFLOPS

## 消息长度

- Discord 单条消息上限 2000 字符
- 长回复拆分成多条，在自然断点（换行、段落）处切
- 优先发核心结论，细节按需展开

## 写作风格

- 短句为主，1-3 句话说清一件事
- 不要 "我很高兴为您..." 之类的废话
- 中文为主，技术术语保留英文
- 匹配对话的语气和节奏
- 结论先行，不要铺垫

## 代码输出

- 短代码（<10行）直接贴代码块
- 长代码输出用 `||折叠||` 或建议用户看文件
- 错误信息只贴关键行，不要整段 stack trace

## 富内容页面

复杂内容（大表格、图表、报告）不适合 Discord 消息时，生成 HTML 页面到 CC Pages：

1. 写 HTML 到 `/var/www/cc/pages/{topic}-{YYYYMMDD-HHmmss}.html`
2. 用 Playwright 截图(1200x630) 保存到 `/var/www/cc/assets/og-{topic}.png`
3. 页面 og:image 指向专属截图（不要共用首页截图，否则 Discord 预览全长一样）
4. 用 `send-to-discord.sh --plain "https://cc.higcp.com/pages/{filename}"` 发送链接
5. **必须用 `--plain` 模式**，Embed 模式下链接不会触发 Discord 的 OG 预览

### 生成流程

```
写 HTML → Playwright 截图 → 设置 og:image → send-to-discord.sh --plain
```

### OG 标签模板

```html
<meta property="og:title" content="页面标题">
<meta property="og:description" content="简短描述">
<meta property="og:image" content="https://cc.higcp.com/assets/og-{topic}.png">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta name="twitter:card" content="summary_large_image">
<meta name="theme-color" content="#22C55E">
```

## 进度更新

长任务中主动汇报，但不要刷屏：
- 开始时：一句话说清在做什么
- 关键节点：完成了什么 / 遇到问题
- 结束时：结果 + 变更摘要