formatting-nanobot-output

name	formatting-nanobot-output
description	美化 nanobot 的回复输出格式，使用结构化排版、符号标记和清晰层级，适配 QQ、Telegram 等聊天平台。当需要让 nanobot 回复更美观、更易读时使用。

Pretty Output - nanobot 输出美化

让 nanobot 的回复更加结构化、美观、易读，适配各类聊天平台。

---

效果示例 (Before → After)

用户提问：「Python 列表去重有哪些方法？」

Before（原始回复）：

Python列表去重方法：
1. 使用set()
2. 使用dict.fromkeys()
3. 使用列表推导式
注意：set()不保留顺序，dict.fromkeys()保留顺序。

After（美化后回复）：

【问题解答】

▎核心回答
Python 列表去重有 3 种常用方法，按推荐程度排列。

▎方法详解
① set() 转换法
   → list(set(data))
   → 最简洁，但不保留原始顺序

② dict.fromkeys() 法
   → list(dict.fromkeys(data))
   → 保留首次出现的顺序 ✅

③ 列表推导式
   → [x for i, x in enumerate(data) if x not in data[:i]]
   → 最灵活，可自定义去重逻辑

💡 推荐：需要保留顺序时用 dict.fromkeys()，不需要时用 set()

───────────

---

输出格式规范

通用排版规则

1. 标题层级：用符号区分层级，避免纯 Markdown # 标记（部分平台不渲染）

   • 一级标题：【标题】 或 ━━ 标题 ━━
   • 二级标题：▎标题 或 ◆ 标题
   • 三级标题：▸ 标题

2. 列表项：使用可视符号替代 -

   • 有序：① ② ③ ④ ⑤ ⑥ ⑦ ⑧ ⑨ ⑩
   • 无序：◦ 或 • 或 ▪
   • 勾选：✅ 完成 / ⬜ 未完成

3. 分隔线：使用 ─────────── 或 · · · 分隔段落

4. 强调：

   • 重要：⚠️ 内容
   • 提示：💡 内容
   • 成功：✅ 内容
   • 错误：❌ 内容
   • 信息：ℹ️ 内容

5. 引用/备注：用 「...」 包裹

---

回复模板

问答类回复

【问题解答】

▎核心回答
简洁明了的回答内容。

▎详细说明
① 第一个要点说明
② 第二个要点说明
③ 第三个要点说明

💡 补充提示：额外的有用信息

───────────

步骤/教程类回复

━━ 操作指南：XXX ━━

① 第一步：操作描述
   → 具体命令或动作

② 第二步：操作描述
   → 具体命令或动作

③ 第三步：操作描述
   → 具体命令或动作

· · ·

⚠️ 注意事项：需要留意的地方
✅ 完成后预期效果

对比/选择类回复

【方案对比】

◆ 方案 A：名称
  ▪ 优点：xxx
  ▪ 缺点：xxx
  ▪ 适用：xxx

◆ 方案 B：名称
  ▪ 优点：xxx
  ▪ 缺点：xxx
  ▪ 适用：xxx

───────────
💡 推荐：基于你的情况，建议选择 X

代码类回复

【代码示例】

▎功能说明
简要描述这段代码的功能。

▎代码
（代码内容）

▎使用方法
① 说明步骤一
② 说明步骤二

⚠️ 注意：需要关注的坑点

摘要/总结类回复

━━ 摘要 ━━

▎概述
一两句话的核心内容。

▎要点
• 要点一
• 要点二
• 要点三

▎结论
「总结性的一句话」

---

平台适配指南

QQ / QQ频道

• 不支持 Markdown 渲染，使用纯文本符号排版
• 避免使用 **加粗**、# 标题 等 Markdown 语法
• 用全角符号和 emoji 营造视觉层级
• 每段之间保留空行，提升可读性
• 代码段用「代码内容」包裹，不用反引号

Telegram

• 支持部分 Markdown（加粗、斜体、代码块）
• 可混合使用符号排版 + Markdown
• 代码块可用反引号包裹

Discord

• 完整支持 Markdown
• 可使用 Markdown + 符号排版结合
• 支持代码块语法高亮

---

使用方式

将此 skill 文件复制到 nanobot 的 skills 目录：

# 复制到 nanobot 用户 skills 目录
mkdir -p ~/.nanobot/skills
cp SKILL.md ~/.nanobot/skills/pretty-output.md

# 重启 nanobot 生效
pkill -f nanobot
nanobot gateway

验证 skill 是否生效

① 检查 skill 文件是否已加载：

ls ~/.nanobot/skills/pretty-output.md

② 发送测试消息验证输出格式：

nanobot agent -m "Python 列表去重有哪些方法？"

③ 确认回复中包含格式符号（如 【】、▎、①②③、───），即表示 skill 已生效。如果输出仍为普通格式，检查 skill 文件路径和 nanobot 是否已重启。