1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | discord-letta-ai-skills |
| 项目自述名称 | discord（SKILL.md name 字段） |
| 作者/维护者 | Letta, Inc.（官方组织账号） |
| 来源链接 | https://github.com/letta-ai/skills/tree/main/tools/discord |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars | 132（数据来自 GitHub API；数字为仓库整体，该仓库是多技能合集，不代表本技能自身热度） |
| Forks | 20（数据来自 GitHub API，同上口径） |
| 最新版本 | 无语义化版本号；该子目录最近一次维护提交为 2026-04-22 |
| 安装方式 | 复制/克隆子目录到 agent 的 skills 目录 |
2. 功能介绍与亮点
discord 是一个零外部依赖的 Discord 自动化技能：核心是一个仅使用 Python 标准库（urllib/json/argparse）封装 Discord REST API v10 的命令行脚本 discord_cli.py，覆盖以下能力：
- 服务器与频道查询（列出服务器、查看频道列表与分类）
- 消息读取/发送/编辑/删除/搜索（支持按服务器、频道、作者过滤搜索）
- 表情反应的添加、移除、查看
- 创建讨论串（thread），支持从指定消息发起
- 置顶消息的增删查
- 服务器成员查询
主要亮点：
- 零外部依赖：脚本只依赖 Python 标准库，无需安装任何第三方包，克隆即用
- 官方厂商出品：由 Letta, Inc.（AI agent 记忆框架公司）维护的官方技能知识库仓库收录
- 故障排查文档完整：针对“消息内容为空”“成员列表不全”“403 权限错误”“token 失效”等常见问题分别给出定位与解决步骤
- 输出结构统一：所有命令输出为 JSON，字段规范（消息含
id/author/content/attachments/reactions等），便于 agent 后续处理
3. 适用场景
所属分类：集成与工作流自动化
适合需要在日常工作流中直接与 Discord 服务器交互、而不想手动切换到 Discord 客户端的场景，例如：开源项目维护者让 agent 查询/回应社区频道的讨论；社区运营或 DevRel 从业者批量搜索历史消息、管理反应与置顶；小团队把 Discord 当作通知枢纽，让 agent 自动发送构建、部署等状态更新。受益人群主要是初中级 Claude Code / Codex 用户中日常使用 Discord 做团队协作或社区运营、希望把消息处理接入 agent 工作流的开发者。
4. 跨 Agent 兼容性
- Claude Code：原生支持——仓库描述明确写明“Intended to be used with Letta Code, Claude Code, Codex CLI, and other agents that support skills”，且技能遵循标准 SKILL.md（YAML front matter + Markdown 指令）格式
- Codex：原生支持——同一条官方仓库描述中直接点名 Codex CLI
- OpenClaw：未验证——官方材料未提及，技能本身不依赖任何 Claude 专属机制
- Hermes Agent：未验证——同上，官方材料未提及
5. 推荐理由
面向开发者与社区运营者的官方出品 Discord 自动化技能：一个零依赖的标准库脚本就覆盖了从消息收发、反应管理到讨论串创建的完整常用操作面，安装门槛低（无需装第三方包），故障排查文档齐全，权限模型清晰透明（仅用官方 Bot Token 访问 Discord 官方 API），适合想把 Discord 协作接入 agent 工作流、又不想引入额外服务依赖的用户。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 由 Letta, Inc. 官方团队开发并维护，仓库本身有一定关注度；该子目录自身有一次专属功能提交与后续维护，但尚未见独立于官方之外的第三方讨论或评价 |
| 可用性 | 8 | 零外部依赖、一个脚本覆盖全部操作；需要先在 Discord 开发者门户创建 Bot 并设置访问令牌（相当于配置一次 API key）；文档含完整命令清单与故障排查章节；子目录最近一次维护为 2026-04-22 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单：
① 执行 shell 命令及权限范围——是，通过 python3 调用仓库自带脚本，脚本仅用 urllib 发起 HTTP 请求，未见 subprocess/eval/exec 等风险调用，操作范围限定在 Discord REST API v10
② 运行时联网外发——是，仅访问官方地址 https://discord.com/api/v10，未见其他外联目标
③ API key/凭据存储方式——需要 Discord Bot Token，通过环境变量 DISCORD_BOT_TOKEN 设置，脚本源码未见将 token 写入日志或发送到第三方地址
④ 可疑指令/prompt injection 迹象——未见，脚本与文档均为常规功能实现
⑤ 作者/组织信誉——Letta, Inc. 官方组织账号，公开可查
⑥ License 是否明确——明确，MIT
⑦ 最近维护时间——子目录 2026-04-22 有维护提交，距今约 3 个月
7. 跟同类 Skills 相比的优势
| 维度 | discord-letta-ai-skills | Discord MCP Server（第三方 MCP 方案） |
|---|---|---|
| 运行形态 | 无常驻进程，按需调用脚本 | 需持续运行的 MCP 服务进程，监听本地端口 |
| 安装 | 复制目录 + 设置环境变量 | 克隆仓库、npm install/build/start，再向客户端注册 MCP 端点 |
| 依赖 | 仅 Python 标准库 | Node.js 运行时及其依赖 |
| 鉴权 | Discord 官方 Bot Token（环境变量） | 同样需要 Bot Token，另加 OAuth2 端点注册流程 |
同一社区仓库内还有一个 Slack 自动化技能，其 CLI 依赖第三方个人项目 agent-slack，支持通过读取本地浏览器（Chrome/Firefox）会话凭据完成鉴权；本技能走的是 Discord 官方 Bot Token 机制，不涉及浏览器凭据读取，鉴权路径更透明。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
所属仓库采用“agent 与人类共同贡献、经 Pull Request 同行评审”的协作模式，技能会随社区使用经验持续迭代更新。
10. 安装使用方式
渠道一：整体克隆（会同时获得仓库内其他技能）
git clone https://github.com/letta-ai/skills.git .skills渠道二：单独获取本技能——从仓库复制 tools/discord/ 目录到你的 agent 技能目录（如 .claude/skills/discord/）。
使用步骤：
export DISCORD_BOT_TOKEN="your_token_here"
python3 <path-to-skill>/scripts/discord_cli.py auth test安装后注意事项：需先在 Discord 开发者门户 创建 Bot、在 Privileged Gateway Intents 中开启 Message Content Intent（否则读到的消息内容为空），再通过 OAuth2 URL 邀请 Bot 加入目标服务器并勾选所需权限（View Channels / Send Messages / Read Message History / Add Reactions / Attach Files）。无需重启 agent，下次对话中让 agent 检查可用技能即可被发现。
11. 注意事项
- Bot 只能访问被邀请且被授权的服务器与频道，无法读取用户私信（DM）
- 需手动在开发者门户开启 Message Content Intent / Server Members Intent 等特权网关意图，否则消息内容或成员列表不完整
- Discord API 本身有速率限制，脚本未内置节流处理，高频调用时需自行留意
- OpenClaw / Hermes Agent 的兼容性暂无官方说明
- Bot Token 一旦泄露即可控制该 Bot 已获授权的全部权限，应按标准做法通过环境变量管理，不应提交到版本库