Agent Skills › spacedriveapp/spacebot › messaging-adapter-parity

messaging-adapter-parity

GitHub

用于确保Slack、Telegram等消息适配器的行为一致性，防止回归。通过验证回复、状态更新、交付回执及重试机制的契约，执行跨适配器比对和针对性测试，保障功能降级与错误处理的可预测性。

.agents/skills/messaging-adapter-parity/SKILL.md spacedriveapp/spacebot

触发场景

修改 Slack adapter 修改 Telegram adapter 修改 Discord adapter 修改 Webhook adapter 调整 status delivery 配置 message routing 处理 delivery receipts

安装

npx skills add spacedriveapp/spacebot --skill messaging-adapter-parity -g -y

更多选项

非标准路径

npx skills add https://github.com/spacedriveapp/spacebot/tree/main/.agents/skills/messaging-adapter-parity -g -y

不安装直接使用

npx skills use spacedriveapp/spacebot@messaging-adapter-parity

指定 Agent (Claude Code)

npx skills add spacedriveapp/spacebot --skill messaging-adapter-parity -a claude-code -g -y

安装 repo 全部 skill

npx skills add spacedriveapp/spacebot --all -g -y

预览 repo 内 skill

npx skills add spacedriveapp/spacebot --list

SKILL.md

Frontmatter

{
    "name": "messaging-adapter-parity",
    "description": "This skill should be used when the user asks to change \"Slack adapter\", \"Telegram adapter\", \"Discord adapter\", \"Webhook adapter\", \"status delivery\", \"message routing\", or \"delivery receipts\". Enforces cross-adapter parity and explicit delivery semantics."
}

Messaging Adapter Parity

Goal

Prevent adapter-specific regressions by validating behavior contracts across messaging backends.

Contract Areas

User-visible reply behavior
Status update behavior (surfaced vs not surfaced)
Delivery receipt ack/failure semantics
Retry behavior and bounded backoff
Error mapping and logging clarity

Parity Checklist

For every changed adapter path, compare expected behavior with at least one other adapter.
If an adapter intentionally does not surface a status, ensure receipt handling still converges correctly.
Ensure unsupported features degrade gracefully and predictably.
Ensure worker terminal notices cannot loop indefinitely.