SuperAPI AI 工具集

matrix-announcement

写作与研究

查看项目

更新于 10-16 01:35

技能介绍

用途:为 Matrix 公告撰写提供内容规则;实际发送由 matrix-communication 完成。适用于技能首次发布、功能版本、仅修 bug 的补丁、每周汇总、破坏性变更或弃用提醒、事故复盘、调查或审计发现、征集反馈的 RFC,以及多技能流水线总结等场景。

主要能力:给出五条规则——一个标题一个目的;正文用 HTML 子集的 formatted_body 而非 Markdown,body 作为纯文本回退;可枚举项(发现、项目、失败、工单)用列表而非段落;命令、路径、版本、ID、环境变量用 code 包裹,多行用 pre 加 language 类,并指名标识符本身;布局优先时渲染 HTML 卡片为 PNG。类型标签只能选一个,不得叠加,如首次发布、功能版本、补丁、摘要、提醒、复盘、发现、RFC。发现类报告按发现类别分组,不按责任人分组。字形最多一个前置符号,禁用尾部装饰、多表情阶梯及 🚀🎉 等,并给出了允许的符号集合。

使用方式:发送前按清单自检——标题一行且以变更开头;URL 用 a 标签且以目标为文本;每个实体都加链接(工单键、版本、MR/PR、流水线、提交);状态更新每行一条、链接键在前、空行分隔;无值守自动化用 m.notice,否则用 m.text,除非是故障否则不用 @room;正文控制在 3000 字符以内或改为线程,布局重时用图像卡片。参考目录包含 html-subset.md、structure.md、glyphs.md、anti-patterns.md、image-cards.md、threading.md、text-templates.md、templates 与 gallery.html。

限制:资料未提供安装命令、代码示例、收费或平台支持等细节。正文长度、m.text 与 m.notice 的取舍等规则来自资料,未展开之处暂未提供。