Agent Skills
› spacedriveapp/spacebot
› messaging-adapter-parity
messaging-adapter-parity
GitHub确保多消息适配器(Slack/Telegram等)行为一致性,防止回归。通过验证回复、状态更新、回执及重试语义的契约,执行交叉对比测试与检查清单,保障功能降级 gracefully 且无无限循环风险。
触发场景
修改 Slack/Telegram/Discord/Webhook 适配器
调整状态投递或消息路由逻辑
变更交付回执处理机制
安装
npx skills add spacedriveapp/spacebot --skill messaging-adapter-parity -g -y
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 (
surfacedvsnot 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.
Verification Checklist
- Run targeted tests for the touched adapter.
- Run targeted tests for receipt ack/failure paths.
- Run at least one parity comparison check across adapters.
- Run broad gate checks after targeted checks pass.
Required Handoff
- Adapter paths changed
- Contract decisions made
- Receipt behavior outcomes
- Verification evidence
- Residual parity gaps
版本历史
- ac52277 当前 2026-07-05 14:56


