qqbot-message-format

# QQBot 消息排版 把最终发给用户的 QQ 消息整理成更适合 QQ 聊天界面快速扫读的样子，无论在手机还是电脑端都清楚顺眼，让它更像清晰的项目进展更新，而不是一份沉重的正式文档。 ## 核心流程 1. 先判断消息类型：简短回答、完成更新、还是排障说明。 2. 把结论放在最前面。 3. 按 QQ 的实际渲染规则组织结构，不按理想化 Markdown 想象排版。 4. 把原本的嵌套结构改写成 QQ 友好格式。 5. 只在确实有助于理解时使用加粗和 emoji。 6. 发送前删掉空区块和低价值内容。 需要复用结构时，读取 `references/templates.md`。 需要对照好坏示例时，读取 `references/examples.md`。 ## 硬规则 - 全程使用简洁中文。 - 开头必须先给结论、当前结果或直接答案。 - 保持轻量项目汇报感：状态明确、表达务实、带一点聊天感。 - 优先用短 bullet 和短段落，避免大段文字。 - 一条 bullet 通常只表达一个意思。 - 如果消息很短，用一个标题加 2-3 个 bullet 即可，不要过度分层。 - 如果是在汇报后台任务完成，第一句先明确说已经完成，再展开说明。 ## QQ 标题规则 - 把 QQ 视为只有两档真正有感知差异的标题层级。 - `#` 和 `##` 视为同一档大标题。 - `###` 到 `######` 视为同一档小标题。 - 像 `当前结论`、`任务完成`、`问题定位` 这种主区块，使用大标题。 - 像 `已确认`、`风险 / 注意`、`下一步` 这种从属区块，使用小标题。 - 如果某条规则本身就是重要的排版规则，不要把它埋进普通 bullet 里，要单独做成可见区块。 ## QQ 列表规则 - 不要依赖 QQ 对原生嵌套 Markdown 列表的展示效果。 - 主层级尽量保持扁平普通 bullet。 - 如果一个 bullet 下面还有子想法，父 bullet 仍保持扁平，再把子内容改写成缩进引导句，比如 `👉`。 - 如果改写后层级还是太深，就继续压平，或拆成新的小标题区块。 ## 强调与 emoji - 加粗只留给一句话或一条 bullet 里最重要的短语。 - 默认优先使用加粗，不要做类似下划线式强调。 - 不要整段加粗，也不要给一串并列 bullet 全部加粗。 - emoji 只做功能性提示，不做装饰性堆砌。 - 常用含义：`✅` 完成，`⚠️` 注意，`❌` 阻塞，`📌` 重点，`🔍` 发现，`👉` 跟进。 ## 默认消息形态 ### 简短回答 用于直接 yes/no、快速澄清或简单建议。 - 大标题：`结论` - 1-3 条短 bullet - 如有必要，再补一个小标题 `说明` ### 完成更新 用于任务完成、检查完成、部署完成或后台工作结束。 - 大标题：`任务完成` 或 `当前结论` - 先写结果 bullet - 再写小标题 `已确认` - 必要时加 `风险 / 注意` - 只有确实有价值时才加 `下一步` ### 排障说明 用于问题诊断、根因解释和操作建议。 - 大标题：`问题定位` 或 `当前结论` - 小标题 `初步判断` - 小标题 `可能原因` - 小标题 `建议操作` ## 发送前检查 发送前确认以下几点： - 第一屏就能看到答案。 - 即使 QQ 把标题压成两档，结构依然清楚。 - 没有残留原生嵌套 Markdown 列表。 - 加粗数量很少，只突出真正核心的信息。 - emoji 是帮助扫读，不是在制造噪音。 - 整条消息读起来像清爽的 QQ 更新，而不是复制出来的文档。 ## 避免 - 很长且不断行的大段文字 - 按六级 Markdown 标题来思考结构 - 直接保留原生嵌套 Markdown 列表 - 原始工具输出原封不动贴给用户 - 很短的消息却堆很多标题 - 大面积加粗 - 装饰性 emoji 堆叠