Correspond Skill 技能

技能简介

Correspond 是一款面向 AI Agent 的统一通信通道外观层（channel facade），将 GitHub Issues、Email、ntfy 推送、macOS 通知、Telegram、Web Inbox 等异构通道抽象成同一套动词（read、listen、send、edit、react）与同一份引用语法（:），让 Agent 写跨平台消息时无需为每个通道单独写适配代码。它由 thorwhalen 开发，与同作者的 acquaint（人员注册中心）天然互补——后者管人，前者管通道。

核心能力

• 统一动词抽象：read、listen、send、edit、react 五个动词覆盖所有通道；某通道不支持某动词时被显式拒绝（NotSupported），从不静默跳过。
• 六通道覆盖：GitHub（issue/comment/label/webhook）、Email（IMAP/SMTP）、ntfy（推送）、macOS 通知、Telegram Bot API、Web Inbox（自托管 ASGI 收集器），后续将支持 Discord/Slack/Signal/Apprise。
• 发送者真实性分级：每条消息携带身份 + 真实性等级（platform / crypto / bound / domain / claimed / forged），并附证据（如 GitHub author_association、邮件 authserv-id、Webhook 签名方式），Agent 可按策略只接受特定等级。
• 可读性评估：在发送前调用 correspond audience 评估谁将读到这条消息，包括 scope（operator / named / group / org / public）、readers 列表、external 标志、durability、widening 路径，并附 hash 用于感知变更。
• dry-run 强制审查：每个 write 操作都先经过 before_send 检查并打印完整 plan（audience + audience_hash + before_send 判定），可在不触达外部的前提下预览发送结果。
• 能力分级接口：correspond capabilities 给出每个通道各操作的 full/partial/none 评级，外加 initiate、reply、priority、cc 等子能力，使 Agent 知道每个通道能做什么、不能做什么。

安装配置

1. pip install correspond 安装核心库与六个内置通道（仅依赖 Python 标准库，无第三方依赖）。
2. Email 通道需要 IMAP/SMTP 凭据，可放系统 Keychain 或远程主机——correspond 在发送时才读取，绝不写死在配置。
3. GitHub 通道直接复用 gh CLI 的登录态，correspond 自身不保存 token。
4. Telegram 通道需要在 @BotFather 申请 bot token 并写入 config；macOS 通道需要 terminal-notifier 或内置 osascript。
5. 计划中的 Discord / Slack / Signal / Apprise 通道以 extras 形式提供，运行 correspond channels 查看当前状态。

使用步骤

1. 在 Agent 启动脚本中加载 correspond 库，初始化 channel registry。
2. 调用 correspond capabilities telegram 查询目标通道的能力，确认 send/edit/react 是否可用、是否支持 priority 与 cc。
3. 构造 Reference（如 telegram:@somebody、github:owner/repo#12、email:someone@example.org），调用 correspond ref 取得规范化形式。
4. 起草消息后先 --dry-run 运行 correspond send ""，correspond 会打印 plan：audience（谁将读到）、audience_hash、before_send 判定。
5. 确认无误后去掉 --dry-run 真实发送；correspond 会先做 audience 检索与 before_send 检查，任一失败都会中止写入并打印原因。
6. 监听通道时调用 correspond listen github:owner/repo 进入 listen 模式，新 issue / comment 自动以统一事件模型上报。

适用场景

• AI Agent 多通道客户支持：同一份消息按通道能力自动选择 Telegram 直接回、Email 抄送、GitHub Issue 评论。
• 跨平台通知聚合：把 GitHub release / CI 失败 / 服务告警统一通过 ntfy / macOS 推到运维手机上。
• Agent-to-Agent 通信：两个 Agent 通过 web inbox + GitHub issue 互发消息，无需为通道写适配。
• AI 助理主动审计邮件 / IMAP 历史：read + 真实性分级让 Agent 区分平台认证邮件和伪造钓鱼。
• 团队自动化机器人：监听 GitHub PR review → 邮件通知 reviewer → Telegram 提醒 reviewer 上线。

适用人群

• 编写跨平台 AI 助理 / Agent 的工程师，希望用统一动词对接所有消息通道。
• 自动化运营与 SRE 团队，需要把多个 SaaS 通知聚合成一致的推送流。
• 安全敏感的 AI 应用开发者，需要对每条消息的发送者真实性做策略校验。
• 开源项目维护者，把 GitHub Issue / Discussions / Email 通知统一为同一个 Agent 处理流程。

工作原理

correspond 的核心思想是通道外观层 + 真实性证据 + 发送前审查三件套：每个通道实现统一的 verb 接口并由测试断言其能力等级，避免隐式跳过；每条消息附上通道自己产生的真实性证据（签名、authserv-id、author_association）形成六个等级的词汇表；任何 write 操作必须先经过 audience 检索与 before_send 策略检查，让 Agent 在真实写入前看到完整 plan——who reads it、which evidence it has、whether the policy lets it through。

官方链接

• PyPI：https://pypi.org/project/correspond/
• GitHub：https://github.com/thorwhalen/correspond
• 文档：https://thorwhalen.github.io/correspond