用途：agent-memory 的诊断与故障排查工作流，覆盖安装、配置、守护进程（daemon）与数据采集（ingest）等常见问题。适用症状包括：守护进程无法启动、命令找不到、连接被拒绝、未采集到事件、摘要生成失败等。
主要能力：提供分步诊断流程。第一步识别症状并让用户选择 1-6 的编号；第二步仅给出针对性诊断命令，例如 which memory-daemon、which memory-ingest、echo $PATH、memory-daemon status、lsof -i :50051、memory-daemon query --endpoint http://[::1]:50051 root、tail -50 ~/Library/Logs/memory-daemon/daemon.log、tail -50 ~/.local/state/memory-daemon/daemon.log、grep -n "memory-ingest" ~/.claude/hooks.yaml、echo "OPENAI: ${OPENAI_API_KEY:+set}"、echo "ANTHROPIC: ${ANTHROPIC_API_KEY:+set}"；第三步在确认后提供安全修复，如更新 PATH、重启守护进程（memory-daemon stop、memory-daemon start）、修改 hooks 文件；第四步给出可选验证命令。
使用方式：按技能引导逐项选择症状，运行所提供的诊断命令，再决定是否应用修复。常见修复手册包括：命令找不到时确认二进制已安装并将安装目录加入 PATH，缺失时重跑 memory-install；连接被拒时确认守护进程运行、检查 50051 端口冲突、必要时更新配置中的 grpc_port；无事件时确认 hooks 文件含 memory-ingest 且其位于 PATH，并在修改 hook 后重启 agent 会话；摘要失败时设置提供方 API key 并确保配置的提供方与 key 匹配。
限制：该技能不自动运行验证命令，编辑文件或重启服务前必须获得确认，修复仅限所报告的问题。若诊断未能解决，建议重跑 memory-verify 做完整检查，或用全新设置重跑 memory-install。