القائمة
系统化排查 MailAgent 服务问题
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | debug |
| description | 系统化排查 MailAgent 服务问题 |
| user_invocable | true |
按标准流程排查 MailAgent 各组件状态，快速定位问题。
/debug — 全面健康检查/debug redis — 排查 Redis 连接/消费问题/debug sync — 排查邮件同步问题/debug notion — 排查 Notion API 问题/debug webhook — 排查远程 webhook-server 问题按顺序执行，遇到异常立即深入：
pm2 status
pm2 logs mail-sync --lines 30 --nostream 2>&1 | grep -i 'error\|critical\|exception\|traceback'
sqlite3 data/sync_store.db "SELECT sync_status, COUNT(*) FROM email_metadata GROUP BY sync_status ORDER BY COUNT(*) DESC;"
sqlite3 data/sync_store.db "SELECT internal_id, subject, sync_error, retry_count FROM email_metadata WHERE sync_status='dead_letter' LIMIT 10;"
检查日志中是否有 Redis consumer started / Redis 断连告警
sqlite3 data/sync_store.db "SELECT internal_id, sync_status, retry_count, next_retry_at FROM email_metadata WHERE sync_status IN ('fetch_failed', 'failed') ORDER BY next_retry_at LIMIT 10;"
生成简洁的状态报告表格：
| 组件 | 状态 | 详情 |
|---|---|---|
| PM2 进程 | ✅/❌ | ... |
| SQLite 雷达 | ✅/❌ | ... |
| Redis 消费 | ✅/❌ | ... |
| Notion 同步 | ✅/❌ | ... |
| Dead letter | ⚠️/✅ | N 条 |
发现问题时给出具体修复建议。
跑 MailAgent 的 agent 行为回归网（零-LLM 硬闸 pytest + baseline compare）。改 chat agent 的 prompt/工具/编排引擎后必跑，总分不得低于 baseline。
MailAgent 桌面 App 对外发布全流程（dogfood → bump → tag → CI → draft 转正 → 验证），内置嵌入 Python / better-sqlite3 ABI / build:web / torn-bundle 检查点。不可逆，仅手动触发。
SQLite schema 升级（bump DB_VERSION + idempotent migration + 一致性更新）
按项目 house style 生成 Sprint / 功能交接文档
部署并验证 MailAgent 服务
快速服务健康检查（适合定时巡检）