跳到正文
cccskills
免费在 GitHub 公开

troubleshoot

Diagnose and fix rad-mem installation issues. Checks PM2 worker status, database integrity, service health, dependencies, and provides automated fixes for common problems.

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(7)

  • SKILL.md3.2 KB
  • operations/automated-fixes.md3.3 KB
  • operations/common-issues.md5.6 KB
  • operations/database.md8.0 KB
  • operations/diagnostics.md6.6 KB
  • operations/reference.md3.2 KB
  • operations/worker.md5.9 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Rad-Mem Troubleshooting Skill

Diagnose and resolve installation and operational issues with the rad-mem plugin.

When to Use This Skill

Invoke this skill when:

  • Memory not persisting after /clear
  • Viewer UI empty or not loading
  • Worker service not running
  • Database missing or corrupted
  • Port conflicts
  • Missing dependencies
  • "Nothing is remembered" complaints
  • Search results empty when they shouldn't be

Do NOT invoke for feature requests or usage questions (use regular documentation for that).

Quick Decision Guide

Once the skill is loaded, choose the appropriate operation:

What's the problem?

Available Operations

Choose the appropriate operation file for detailed instructions:

Diagnostic Workflows

  1. Full System Diagnostics - Comprehensive step-by-step diagnostic workflow
  2. Worker Diagnostics - PM2 worker-specific troubleshooting
  3. Database Diagnostics - Database integrity and data checks

Issue Resolution

  1. Common Issues - Quick fixes for frequently encountered problems
  2. Automated Fixes - One-command fix sequences

Reference

  1. Quick Commands - Essential commands for troubleshooting

Quick Start

Fast automated fix (try this first):

cd ~/.claude/plugins/marketplaces/thedotmack/ && \
pm2 delete rad-mem-worker 2>/dev/null; \
npm install && \
node_modules/.bin/pm2 start ecosystem.config.cjs && \
sleep 3 && \
curl -s http://127.0.0.1:38888/health

Expected output: {"status":"ok"}

If that doesn't work, proceed to detailed diagnostics.

Response Format

When troubleshooting:

  1. Identify the symptom - What's the user reporting?
  2. Choose operation file - Use the decision guide above
  3. Follow steps systematically - Don't skip diagnostic steps
  4. Report findings - Tell user what you found and what was fixed
  5. Verify resolution - Confirm the issue is resolved

Technical Notes

  • Worker port: Default 37777 (configurable via CLAUDE_MEM_WORKER_PORT)
  • Database location: ~/.rad-mem/rad-mem.db
  • Plugin location: ~/.claude/plugins/marketplaces/thedotmack/
  • PM2 process name: rad-mem-worker

Error Reporting

If troubleshooting doesn't resolve the issue, collect diagnostic data and direct user to: https://github.com/thedotmack/rad-mem/issues

See operations/diagnostics.md for details on what to collect.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Search rad-mem's persistent cross-session memory database. Use when user asks "did we already solve this?", "how did we do X last time?", or needs work from previous sessions.

中文简介正在准备中。当前显示原文说明。

thedotmack/rad-mem72026年10月6日 更新

Manage semantic version updates for rad-mem project. Handles patch, minor, and major version increments following semantic versioning. Updates package.json, marketplace.json, plugin.json, and CLAUDE.md version number (NOT version history). Creates git tags and GitHub releases. Auto-generates CHANGELOG.md from releases.

中文简介正在准备中。当前显示原文说明。

thedotmack/rad-mem72026年10月6日 更新

查看 thedotmack 的全部技能

报告此技能的问题