teams-message-formatting

Teams 消息格式

针对接收文本的 Teams 界面格式化提供的文本。用户的明确指示优先于本技能的指南。

识别文本系统

将内容、目标字段以及现有负载或 SDK 作为输入。根据上下文推断文本系统；如果缺少的选项会影响语法或提及元数据，则询问目标位置。

界面	文本格式	提及元数据
Bot 活动 text	Bot Markdown 或 textFormat: "xml" 子集	活动 entities
Adaptive Card TextBlock / facts	有限 Markdown，不支持 HTML	根级 msteams.entities
Graph chatMessage.body	text 或 Teams 限制的 html	正文 <at id="N"> 加匹配的 mentions 条目
Hero/thumbnail 卡片 text	XML/HTML 子集	界面特定；标题/副标题不支持格式

Slack mrkdwn 不是 Teams 标记。Adaptive Card Markdown 不支持标题、表格、图片、代码围栏或引用块；如果请求了这些结构，请使用受支持的卡片元素。纯文本内容不需要卡片。

保留文本和身份

• 针对接收语法进行转义，然后序列化 JSON。不要将未经转义的用户文本拼接到 HTML/XML 或提及标记中。
• 保持可见的提及文本及其元数据同步。使用提供或已解析的 ID；显示名称不能作为身份凭据。
• 遵循客户端差异，例如移动设备上的 Bot 列表支持情况。不要仅为修正标点而更改传输方式。
• 对于 Graph 负载，应区分普通委派发送和迁移权限。仅限应用的通知需要受支持的投递路径；如果缺少能力，请说明这一点，不要假装负载本身就能提供该能力。

返回所请求的文本、修正后的字符串/对象或集成补丁，并保留含义和已知界面。指出任何缺失的运行时 ID 或未经验证的客户端行为。发布与格式化是分开的，且需要用户请求或现有授权。

参考资料

仅加载相关的格式或元数据详情。

任务	参考资料
Bot Markdown/XML、卡片 Markdown、Hero 卡片、旧版文本	MARKDOWN-HTML.md
Bot/卡片/Graph 提及；用户、标签、团队、频道	MENTIONS.md
Graph HTML、代码/表情符号标签、附件、权限	GRAPH-CHATMESSAGE.md
精简界面和语法速查	CHEATSHEET.md

对于卡片布局/操作，如果已安装 teams-adaptive-cards，请使用它；否则请参阅 Teams 卡片文档。此文本格式工作流不依赖安装其他技能。