cortex-utils
为Cortex提供队列管理、告警与日志工具的运维工具集
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：cortex-utils。 它的用途是：为Cortex提供队列管理、告警与日志工具的运维工具集 完整的 Skill 内容见：https://321skill.com/skills/cortex-utils/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我检查一下Cortex任务队列的积压情况。” 它会调用 `cortex-utils queue stats` 命令，为你展示各分区的任务数量和处理状态。或者，你可以说：“设置一个日志监控，把错误日志实时推送到团队Discord。” AI会指导你配置 `DISCORD_WEBHOOK_URL` 并启动 `cortex-utils alerter run` 守护进程。
介绍
cortex-utils是一个专为Cortex设计的运维工具集，旨在解决分布式系统中常见的队列管理、任务失败处理和实时告警问题。它通过自动化的队列分区维护、死信队列（Dead Letter）跟踪与重试，以及基于Discord的日志监控告警，帮助开发者维护系统的稳定性和可观测性。
使用方式主要通过命令行工具，例如检查队列状态、执行分区维护任务，或者启动一个常驻的告警守护进程。用户需要配置PostgreSQL数据库连接和Discord的Webhook URL，即可快速启用各项功能。
该工具非常适合负责系统运维和监控的后端开发、运维工程师或运维开发人员。他们通常需要处理后台任务队列、排查作业失败原因，并希望实时获得系统异常通知。
建议在使用前确保数据库连接稳定，并根据业务量合理设置分区保留天数。注意，该工具主要与Cortex生态集成，其告警功能目前深度绑定Discord，若团队使用其他通讯工具则需自行适配。
核心特点
核心区别在于它专为Cortex生态设计，提供了开箱即用的队列分区自动维护和基于日志内容分类的Discord告警，将队列运维与实时监控告警流程进行了深度整合，而非通用的独立工具。
注意事项
不适合非Cortex项目或需要对接Slack、钉钉等其他告警平台的使用场景。
常见问题
cortex-utils的主要功能是什么？
主要提供Cortex系统的队列管理、死信任务处理以及基于Discord的日志监控与告警功能。
使用alerter需要配置什么？
需要设置环境变量DISCORD_WEBHOOK_URL，用于接收告警消息的Discord频道Webhook地址。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/cortex-utils/raw/index.md 读取 cortex-utils 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/cortex-utils/raw/index.md（查看排版版本）