메뉴
Diagnoses marchat client and server issues using -doctor, env configuration, and logs. Use when debugging connection failures, E2E decryption, database DSN, handshake errors, or when the user mentions doctor, diagnostics, or MARCHAT_ environment variables.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Implements marchat terminal client TUI, commands, keystore, and WebSocket client behavior. Use when editing client/, Bubble Tea models, :commands, themes, notifications, or client configuration paths.
Implements marchat server hub, WebSocket handlers, admin web, health, and startup validation. Use when editing server/, cmd/server/, hub routing, admin panel, or server configuration.
Writes and runs marchat tests with race detection, coverage, and dialect smoke patterns. Use when adding tests, fixing test failures, measuring coverage, or when the user mentions go test, -race, TESTING.md, or CI database smoke.
Changes marchat SQL schema and queries across SQLite, PostgreSQL, and MySQL using dialect helpers. Use when editing server/db.go, db_dialect.go, schema migrations, MARCHAT_DB_PATH, or multi-database behavior.
Implements and refactors marchat Go code with project toolchain and quality gates. Use when adding features, fixing bugs, touching client/server/plugin code, or when the user asks to develop, build, or validate marchat changes.
Develops and maintains marchat plugins: SDK, host IPC, manager install path, store downloads, and Ed25519 licenses. Use when editing plugin/, plugin commands, or plugin_state.json behavior.
| name | debugging-marchat |
| description | Diagnoses marchat client and server issues using -doctor, env configuration, and logs. Use when debugging connection failures, E2E decryption, database DSN, handshake errors, or when the user mentions doctor, diagnostics, or MARCHAT_ environment variables. |
| Binary | Command |
|---|---|
| Client | go run ./client -doctor or marchat-client -doctor |
| Server | go run ./cmd/server -doctor or marchat-server -doctor |
| JSON | Add -doctor-json (plain JSON; no TTY colors) |
Server doctor lists MARCHAT_* after config/.env load (godotenv.Overload: file wins on same key).
Skip GitHub release compare in tests or offline:
export MARCHAT_DOCTOR_NO_NETWORK=1
Implementation: internal/doctor/. DB dialect and DSN shape checks live there and in server/db_dialect.go.
| Symptom | Check |
|---|---|
| Handshake rejected / username taken | Reserved names; duplicate connection; server hub lock |
| WSS behind proxy | deploy/, docker-compose.proxy.yml, README proxy section; client WSS URL |
| E2E decrypt fails | Same global key on all clients (MARCHAT_GLOBAL_E2E_KEY or shared keystore.dat); not X25519 per-user |
| Postgres boolean errors | Dialect boolean helpers in server/db_dialect.go (:search, pin toggle) |
| MySQL time parsing | mysql.Config with parseTime=true in InitDB |
| SQLite path vs remote DSN | MARCHAT_DB_PATH; mysql: / postgres: prefixes for driver detection |
| Plugin disable race | StopPlugin waits for stdout/stderr readers (plugin/host) |
| Rate limit | server/loadverify_ratelimit_test.go constants match client.go read pump |
server/client.go).MARCHAT_ALLOWED_ORIGINS.MARCHAT_TRUSTED_PROXIES for X-Forwarded-For / X-Real-IP.Never log passphrases, admin keys, session secrets, or raw E2E keys.
-doctor on client and server.testing-marchat).