무료GitHub에 공개한국어 소개

doctor

상태 점검과 로그를 사용해 Superset의 연결, 호스트, 터미널, 인증, 업데이트 문제를 진단합니다. 증상에 맞는 해결 방법을 제안하고, 변경은 승인 후 실행하며 원래 문제가 해결됐는지 확인합니다.

원문원문 설명 보기

Diagnose and fix Paradev (formerly Superset) problems such as connection failures, offline hosts, terminals not attaching, auth or update issues. Use when the user reports something broken or misbehaving in Paradev itself ("Paradev won't connect", "my host shows offline", "terminal won't attach", "the app is stuck"), before filing feedback.

ParadevAI/Paradev스타 15,724(GitHub 15,724 + cccskills 0)

실행 점수 미검증

설치 방법 보기

이럴 때 유용합니다

Superset 연결 실패 원인 조사
오프라인 호스트 문제 해결
터미널 연결 장애 진단
인증 또는 버전 문제 확인

한국어 소개

할 수 있는 일

Superset 자체의 문제를 진단하고 증상에 맞는 해결 방법을 제안합니다. 호스트 서비스 상태, 로그인 계정과 조직, 호스트 연결 여부, CLI 버전을 확인한 뒤 알려진 문제와 대조합니다. 이를 통해 만료된 인증, 중지된 서비스, 호스트 설정 실패, CLI와 데스크톱 앱의 버전 불일치 등을 구분할 수 있습니다. 변경을 승인받아 적용한 뒤에는 원래 실패했던 작업을 다시 실행해 결과를 확인합니다.

이럴 때 유용합니다

Superset이 연결되지 않거나 호스트가 오프라인으로 표시될 때, 터미널 연결이 되지 않을 때, 인증이나 업데이트 문제가 의심될 때 사용할 수 있습니다. 해결되지 않으면 수집한 진단 결과를 피드백 보고에 전달하는 방법도 제안합니다.

사용 예시

“Superset 호스트가 오프라인인 이유를 찾아 주세요.”
“터미널이 연결되지 않습니다. 상태와 인증을 확인해 주세요.”
“업데이트나 버전 문제가 있는지 진단해 주세요.”

주의 사항

superset CLI를 사용합니다. 상태를 바꾸는 명령은 사용자의 승인을 받은 뒤 실행하고, 이후 원래 작업을 다시 확인합니다. SSH로 호스트를 추가할 때는 macOS 또는 x64·arm64 glibc Linux를 지원하며 curl이 필요합니다. Alpine과 Windows는 지원하지 않습니다. 보고서에 로그 내용을 포함할 때도 먼저 확인을 요청합니다.

이 소개문은 공개된 SKILL.md를 바탕으로 AI(OpenAI Codex)가 작성했습니다. 정확한 사양은 아래 원문을 확인하세요.

문서 점검

AI가 SKILL.md의 내용에서 주의가 필요한 작업과 도입 전제를 확인했습니다. 점수는 실제로 실행한 결과(실행 검증)만으로 매깁니다.

안전성전송·삭제·명령 실행 등을 명시하고 있는가: A양호상태 변경과 로그 공유는 승인을 받으며 데이터 삭제를 해결책으로 쓰지 않습니다.
도입의 용이성필요한 도구나 API 키가 적고 적혀 있는가: B일부 부족`superset` CLI가 필요하며 SSH 호스트의 지원 운영체제와 `curl` 조건을 설명합니다.

점수에는 넣지 않았습니다. 2026년 10월 29일 기준으로 AI(OpenAI Codex)가 판정했습니다. 참고용이므로 설치 전에 원문도 확인해 주세요.

평가가 다르다고 생각되면 재검토를 요청하기

포함된 파일(2)

SKILL.md2.9 KB
agents/openai.yaml228 B

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Paradev Doctor

paradev is an alias for the superset CLI: every superset command here also runs as paradev.

Diagnose first, change one thing at a time, verify after each change.

1. Snapshot (read-only, run in parallel, tolerate failures)

superset status for host service health
superset auth whoami for auth and the active org
superset hosts list for host reachability
superset --version

2. Match known signatures

Signature	Fix
`whoami` fails / session expired	`superset auth login`
Host shows offline	`superset hosts wake <id>`; confirm the machine is awake and online
Host service not running	`superset start`
A host set up with `superset hosts add` is offline or broken	re-run `superset hosts add <ssh-target>`; it checks each step and fixes only what is wrong. On Linux its log is `ssh <ssh-target> journalctl --user -u superset-host -n 50`
`hosts add` cannot reach or set up the machine	confirm `ssh <ssh-target>` works from here, the remote is macOS or glibc Linux (x64 or arm64; Alpine and Windows are not supported), and it has `curl`
Private repos will not clone on a host added with `hosts add`	sign in GitHub there: `ssh -t <ssh-target> gh auth login` (install `gh` first if missing)
Linux host stops when the user logs out of it	enable lingering on that machine: `loginctl enable-linger`
`hosts add` stops on an empty or invalid `/etc/machine-id` (cloned VM or container image)	on that machine, `sudo rm -f /etc/machine-id && sudo systemd-machine-id-setup`, then re-run `hosts add`. The user runs this, since it needs sudo on their box
`superset pages publish` in a Paradev terminal fails with "Not a member of organization"	`superset update`; newer CLIs use the desktop app's account inside its terminals
CLI and desktop app version mismatch, or stale CLI	`superset update`
App-side misbehavior (macOS)	read the newest entries in `~/Library/Logs/Superset/main.log` for errors

Propose the matching fix and get the user's go-ahead before running anything that changes state. Never delete data as a "fix".

3. Verify

Re-run the originally failing action. If it works, say exactly what was wrong and what fixed it.

4. Escalate with evidence

If unresolved, offer to file it with the feedback skill and carry over the collected diagnostics (versions, status output, the relevant log excerpt) so the report arrives pre-triaged. Ask before including any log content; logs can contain paths and project names.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

같은 저장소의 스킬

10x

무료요약 있음

Superset 사용 현황을 살펴보고 아직 쓰지 않는 기능 중 업무 방식에 맞는 항목을 제안합니다. 각 기능을 설명하고, 사용자가 고른 예약 실행 에이전트나 병렬 작업 공간, 공유 작업 등을 설정합니다.

사용하지 않는 Superset 기능 찾기
에이전트 예약 실행 설정
여러 작업 공간에서 병렬 작업