用途:为接收文本的 Teams 界面格式化给定文本,也可用于调试。用户明确指令优先于本技能指南。
主要能力:先根据内容、目标字段和现有载荷或 SDK 判断文本系统,必要时询问目标界面。不同界面规则不同:机器人活动文本使用 Bot Markdown 或 textFormat: "xml" 子集,提及元数据放在 Activity entities;Adaptive Card 的 TextBlock/facts 使用受限 Markdown、不支持 HTML,提及放在根 msteams.entities;Graph chatMessage.body 使用 text 或 Teams 受限 html,正文用 <at id="N"> 并配对应 mentions 条目;Hero/thumbnail 卡片文本使用 XML/HTML 子集,标题与副标题不格式化。注意 Slack mrkdwn 不是 Teams 标记;Adaptive Card Markdown 不支持标题、表格、图片、代码围栏和引用块,需要这些结构时应改用受支持的卡片元素;纯文本内容不需要卡片。
使用方式:按接收语法转义后再序列化 JSON,不要把未转义的用户文本拼进 HTML/XML 或提及标记;保持可见提及文本与元数据同步,使用提供或解析出的 ID,显示名不能作为身份依据;尊重客户端差异(如移动端对机器人列表的支持),不要仅为修正标点而更换传输方式。对 Graph 载荷,区分普通委托发送与迁移权限;仅应用通知需要受支持的投递路径,缺少能力时应说明,而不是假装载荷能创建它。
输出与限制:返回所请求的文本、修正后的字符串/对象或集成补丁,保留含义与已知界面;指出缺失的运行时 ID 或未经验证的客户端行为。发布与格式化是两回事,发布需要用户请求或已有授权。参考资料按需加载:MARKDOWN-HTML.md、MENTIONS.md、GRAPH-CHATMESSAGE.md、CHEATSHEET.md。卡片布局与操作请使用 teams-adaptive-cards 或 Teams 卡片文档;本文本格式化流程不依赖其他技能安装。