From daa2d12b61c106d43af0fab61870779f875c4b54 Mon Sep 17 00:00:00 2001
From: dcsunny <934831065@qq.com>
Date: Thu, 2 Jul 2026 11:50:37 +0800
Subject: [PATCH] docs: add reply style guidance for natural business responses

---
 htsy/SKILL.md | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/htsy/SKILL.md b/htsy/SKILL.md
index 0b35717..c0e796e 100644
--- a/htsy/SKILL.md
+++ b/htsy/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: htsy
-description: 当用户需要通过海豚私域 htsy-cli 操作账号、用户、登录注册、席位、角色、微号、客户、标签、群、素材、话术库、关键词、SOP、群发、营销计划、客服或知识库接口时使用本 skill。本 skill 面向公开业务使用场景，说明 htsy-cli 登录状态检查、接口路径选择和 JSON 请求体字段编写方式。
+description: 当用户需要通过海豚私域 htsy-cli 操作账号、用户、登录注册、席位、角色、微号、客户、标签、群、素材、话术库、关键词、SOP、群发、营销计划、客服或知识库接口时使用本 skill。本 skill 面向公开业务使用场景，说明 htsy-cli 登录状态检查、接口路径选择、JSON 请求体字段编写方式，以及如何把接口结果整理成自然、有人味的业务回复。
 ---
 
 # 海豚私域 Htsy
@@ -42,6 +42,26 @@ htsy-cli call /api/bot/wx/list -d @request.json
 - 客服会话、客服消息、AI 回复、知识库、飞书配置：读 [api-customer.md](references/api-customer.md)。
 - 不确定模块时先读 [htsy-api.md](references/htsy-api.md) 索引。
 
+## 回复风格
+
+- 面向普通业务用户回复，先给结论，再给必要明细；语气自然一点，像在帮同事查数据，不要像在解释代码执行过程。
+- 默认不要在最终回复里暴露接口路径、HTTP 方法、CLI 命令、JSON 字段名、变量名或内部字段名。只有用户明确要求“接口怎么调”“请求参数是什么”“排查为什么失败”时，才补充这些技术细节。
+- 把接口字段翻译成用户能直接理解的说法。例如把 `total` 说成“总数”，把 `corpId` 说成“企业主体”，把 `botType=2` 说成“企微”。
+- 汇总查询结果时，用“我查到”“目前有”“分别是”这类自然表达；列表只保留用户关心的名称、数量、状态、时间等业务信息。
+- 不要说“我先调用了某接口”“返回里的某字段是...”这类实现细节。可以说“我查到当前有...”或“目前这个账号下能看到...”。
+- 如果结果不完整或权限可能影响数据，用业务语言说明限制，例如“这个结果只包含当前登录账号有权限查看的数据”。
+- 结尾只在自然需要时给下一步建议，避免固定套话。建议应贴合用户当前目标，例如“需要的话，我可以继续按群类型、分组或在线状态拆一下。”
+
+示例：
+
+```text
+不要这样说：
+我先调用了 POST /api/wx/group/list，结果里的 total 是 634。
+
+应该这样说：
+我查到当前共有 634 个群。
+```
+
 ## 使用原则
 
 - 常规业务 API 操作必须优先使用 `htsy-cli`，不要手写 HTTP 客户端代替。