- `或分段 `
- 项
- 条
-
第一级（decimal）
-
第二级（lower-alpha，缩进 24px）
- 第三级（lower-roman，再缩进 24px）
- 第二级（同层）
-
第二级（lower-alpha，缩进 24px）
- 第一级（接续编号）
-
第一级（disc）
-
第二级（circle，缩进 24px）
- 第三级（square，再缩进 24px）
- 第二级（同层）
-
第二级（circle，缩进 24px）
- 第一级（同层）
` - **列表书写规则**：**不要**用 `
一、...
二、...
` 这种「中文编号 + 段落」的列表样式，"①②③"、"1) 2) 3)的机械写法也请摒弃；请擅长使用列表格式 `- ` / `
- `。
- **正文长度自适应**：不限制正文长度，但要求**首屏要见到关键信息**。
## 格式书写规范
电子邮件的 HTML 受客户端兼容性与安全沙箱约束，跟 Web 浏览器 HTML 不是同一规范体系。下面是飞书邮箱已验证的最纯净、最美观写法，请直接复制使用。
### 段落
```html
文字
``` ### 标题 ```html一级标题（26px，自动加粗）
二级标题（22px）
三级标题（20px）
四级标题（18px）
``` ### 加粗 ```html 加粗文字 ``` ### 斜体 ```html 斜体文字 ``` ### 下划线 ```html 下划线文字 ``` ### 删除线 ```html第二行 ``` ### 分隔 ```html
``` ### 列表 ```html
| A | B | C | |
|---|---|---|---|
| B1 | B2 | ||
| a1 | b1-1 | b2-1 | c1 |
| a2 | b1-2 | b2-2 | c2 |
引用文字``` ### 文字高亮（荧光笔风格） ```html 关键里程碑 待跟进 已完成 ``` ### 文字强调 ```html 红色加粗 斜体 下划线
居中
左对齐（默认）
右对齐
```
### 盒模型
```html
外边距 8px / 内边距 12px / 宽度 300px
```
### 边框
```html
圆角描边
```
### 透明
```html
半透明文字
```
### 颜色（推荐调色盘）
```html
主文本
副文本
浅灰文本
蓝色文字
深蓝标题
警示红
紧急橙
```
### URL scheme
```html
外链
邮件链接
```
## 官方 HTML 模板
仓库 [`../assets/templates/`](../assets/templates/) 内预制了若干场景模板，按 LarkSuite mail-editor 原生格式写好。**注意：模板是静态 HTML，没有变量替换能力，AI 需要手工把模板里的样例文本替换成本次邮件的真实内容。**
| 文件 | 说明 |
|---------------------------------|----------|
| `newsletter--weekly-brief.html` | 资讯周报 |
| `weekly--personal-report.html` | 工作周报（个人） |
| `weekly--team-report.html` | 工作周报（团队） |
| `research--market-report.html` | 调研报告 |
| `job-application--resume.html` | 简历邮件 |
跟飞书 OAPI 个人邮件模板（`mail.user_mailbox.templates`）不同——OAPI 模板是用户邮箱里的"我的模板"，跨客户端可见；这里是仓库里的静态 HTML 文件，AI 单次套用即可。
### AI 套用流程
1. **判断是否能用模板** — 看用户当前要写的邮件类型（周报 / 调研 / 简历 / 资讯 / ...）能否对上 [`../assets/templates/`](../assets/templates/) 里的某个文件；不匹配就跳过模板，直接按写法规范从零写。
2. **Read 整个 HTML** — 用 Read 工具完整读取选定的模板文件，理解骨架（章节标题 / 列表层级 / 占位文本 / mention chip / 段落顺序）。
3. **替换文本内容** — 把模板里的样例文字换成用户当前邮件的真实内容；保留所有 inline style / class / data-* 等结构性属性不动；列表条目 / 表格行可按需增删；不需要的整段（如「风险」「下周计划」）整段删除即可，不要留空骨架。
4. **调写信 shortcut 生成草稿** — 把替换后的 HTML 通过 `--body` 参数交给写信链路（推荐 `+draft-create` 先存草稿、用户复核后再 `+send`）：
```bash
lark-cli mail +draft-create --as user \
--to alice@example.com --subject 'Q3 团队周报' \
--body "$(cat skills/lark-mail/assets/templates/weekly--team-report.html)"
```
实际使用时 `$(cat ...)` 可换成 AI 替换文本后写入的本地副本，或直接把替换后的 HTML 字符串作为 `--body` 的值。
5. **拿到草稿链接给用户复核** — 写信 shortcut 返回 `reference` 字段（草稿打开链接），把它给用户在飞书邮箱 UI 里打开核对，再决定下一步发送 / 编辑。
## 写信 shortcut 的 lint 返回值
写信链路（`+send` / `+draft-create` / `+reply` / `+reply-all` / `+forward` / `+draft-edit` body op）调用 `emlbuilder` 之前会强制 lint 净化 HTML，但 **默认 envelope 不携带任何 lint 字段**（既无 `*_count` 也无 finding 数组），envelope 保持小巧供 AI 消费。每个写信 shortcut 默认 envelope 的字段集合：
| 字段 | 出现条件 | 说明 |
|------|---------|------|
| `compose_hint` | 6 个 shortcut 默认都附 | 固定英文文案，提示 AI / 用户在组合 HTML 前阅读本文 |
| `draft_edit_hint` | **仅** `+draft-create` 默认附（其他 5 个 shortcut 不附） | 固定英文文案，提示拿到 `draft_id` 后改稿走 `+draft-edit --draft-id 正文
' ``` 加了 `--show-lint-details` 后 envelope 同时返回 `lint_applied[]` / `original_blocked[]` 两个完整 Finding 数组（每条含 `rule_id` / `severity` / `tag_or_attr` / `excerpt` / `hint`），**不再返回任何 `*_count` 字段** —— 调用方需要 count 时直接 `len(lint_applied)` / `len(original_blocked)`。**默认场景不要加这个 flag**，徒增 token 消耗。 如果只是想预览 lint 会怎么改 HTML，建议直接用 [`+lint-html`](./lark-mail-lint-html.md) 命令——它本来就返回完整 `warnings[]` / `errors[]` + `cleaned_html`，比写信链路 `--show-lint-details` 更清晰。 ## 相关文档 - [`+lint-html` 用法](./lark-mail-lint-html.md) - 写信 shortcut: [`+send`](./lark-mail-send.md) / [`+draft-create`](./lark-mail-draft-create.md) / [`+reply`](./lark-mail-reply.md) / [`+reply-all`](./lark-mail-reply-all.md) / [`+forward`](./lark-mail-forward.md) / [`+draft-edit`](./lark-mail-draft-edit.md)