# Chat Style

> 聊天平台消息格式化规则。当 Claude Code 通过聊天平台（Discord、飞书等）运行时自动适配消息风格，避免渲染问题。当用户说"聊天风格"、"chat风格"、"消息格式"时触发。

- Skill: `yangwhale/chat-style` (Agent Skill)
- Install (CLI): `npx skillmds@latest add yangwhale/chat-style`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yangwhale/chat-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/chat-style

---


# 聊天平台消息风格指南

通过聊天平台（Discord、飞书等）与用户交互时，遵循以下规则让消息正确显示且易读。

## 核心原则

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

## 格式规则

### 可以用

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

### 不要用

- **嵌套列表** — 大部分聊天平台不支持缩进列表
- **图片 `![]()`** — 不渲染，用文件附件替代
- **脚注 `[^1]`** — 不支持

### 表格

- **飞书**：可以直接用 markdown 表格语法 `| col |`，bot 会自动转换为 `column_set` 原生表格（灰白交替行）
- **Discord**：不支持表格，改用代码块对齐或列表格式

飞书表格注意事项：
- 表格单元格内的反引号 `` ` `` 会被自动去除（`column_set` 内不支持行内代码）
- 第一个 `#` 标题会变成卡片彩色 header（indigo），不要在表格前重复写标题
- `---` 分隔线会变成卡片原生 `hr` 元素

Discord 表格替代方案 — 代码块对齐（用英文/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
```

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

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

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

## 消息长度

- 聊天消息保持简短，长回复拆分成多条
- 在自然断点（换行、段落）处切分
- 优先发核心结论，细节按需展开

## 写作风格

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

## 代码输出

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

## 富内容页面

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

1. 写 HTML 到 `$CC_PAGES_WEB_ROOT/pages/{topic}-{YYYYMMDD-HHmmss}.html`（公开发给客户走 `assets/` 子目录）
2. 用 `~/CloseCrab/scripts/publish-cc-page.sh <html-path> [--to pages|assets|both]` 上传 + 自动验证 URL
3. 发送链接 `$CC_PAGES_URL_PREFIX/pages/{filename}` 或 `$CC_PAGES_URL_PREFIX/assets/{filename}`

## 链接格式（强制）

发链接时**一律裸发** URL，前后不加任何包裹符号——不加单引号 `'`、双引号 `"`、反引号 `` ` ``、markdown 代码标记、尖括号 `<>`、方括号 `[]()`。

- ✅ 正确：`https://cc.higcp.com/wiki-v2/`
- ❌ 错误：`'https://cc.higcp.com/wiki-v2/'`、`` `https://...` ``、`[wiki](https://...)`

**原因**：飞书会把引号/反引号当成 URL 的一部分一起渲染进可点击区域，用户点击得到带引号的 URL → 404 打不开。裸 URL 飞书会自动识别成可点击链接，无需任何修饰。

## 进度更新

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