무료GitHub에 공개한국어 소개

debug-package

`debug` 라이브러리로 로그를 추가하거나 확인할 때 사용하는 가이드입니다. 일관된 `lobe-*` 네임스페이스와 형식 지정자를 설명하고, 브라우저·Node.js·Electron에서 로그 출력을 활성화하는 방법을 안내합니다.

원문원문 설명 보기

Use for debug() logging, lobe-* namespaces, DEBUG/localStorage.debug configuration and log formatting.

lobehub/lobehub스타 83,514(GitHub 83,514 + cccskills 0)

실행 점수 미검증

설치 방법 보기

이럴 때 유용합니다

모듈에 디버그 로그 추가하기
로그 네임스페이스 정하기
브라우저에서 로그 활성화하기
Node.js나 Electron에서 로그 확인하기

한국어 소개

할 수 있는 일

debug 라이브러리를 이용한 기본 로그 작성 방식과 모듈별 네임스페이스 지정 방법을 확인할 수 있습니다. lobe-server:market 같은 로거를 만들고 형식 지정자를 사용해 문자열, 숫자, 객체를 출력하는 예시가 있습니다. 브라우저에서는 localStorage.debug, Node.js에서는 DEBUG 환경 변수, Electron에서는 process.env.DEBUG를 설정해 lobe-* 로그를 활성화하는 방법도 설명합니다.

이럴 때 유용합니다

애플리케이션의 처리 흐름을 추적하는 로그를 추가하거나 기존 로그 이름 규칙을 확인할 때 유용합니다. 개발 중 특정 네임스페이스의 출력을 보려는 경우에도 참고할 수 있습니다. 서버, 클라이언트, 데스크톱, 라우터별 네이밍 방식도 확인할 수 있습니다.

사용 예시

“이 모듈에 debug 로그를 추가해 주세요.”
“서버 측 로그 네임스페이스를 어떻게 정하는지 알려 주세요.”
“브라우저에서 lobe-* 로그를 활성화해 주세요.”

주의 사항

예시는 debug 라이브러리를 사용합니다. 로그 활성화 방법은 브라우저, Node.js, Electron 환경마다 다릅니다.

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

문서 점검

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

안전성전송·삭제·명령 실행 등을 명시하고 있는가: A양호로그 설정이 중심이며 삭제나 외부 전송 작업은 지정하지 않습니다.
도입의 용이성필요한 도구나 API 키가 적고 적혀 있는가: B일부 부족`debug` 라이브러리가 필요하지만 설치 절차와 환경 요구 사항은 설명하지 않습니다.

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

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

포함된 파일(1)

SKILL.md1.1 KB

SKILL.md(원문)

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

Debug Package Usage Guide

Basic Usage

import debug from 'debug';

// Format: lobe-[module]:[submodule]
const log = debug('lobe-server:market');

log('Simple message');
log('With variable: %O', object);
log('Formatted number: %d', number);

Namespace Conventions

Desktop: lobe-desktop:[module]
Server: lobe-server:[module]
Client: lobe-client:[module]
Router: lobe-[type]-router:[module]

Format Specifiers

%O - Object expanded (recommended for complex objects)
%o - Object
%s - String
%d - Number

Enable Debug Output

Browser

localStorage.debug = 'lobe-*';

Node.js

DEBUG=lobe-* bun run dev
DEBUG=lobe-* pnpm dev

Electron

process.env.DEBUG = 'lobe-*';

Example

// apps/server/src/routers/lambda/agentEval.ts
import debug from 'debug';

const log = debug('lobe-lambda-router:agent-eval');

log('getAgent input: %O', input);

리뷰

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

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

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

같은 저장소의 스킬

acceptance

무료요약 있음

실제 제품을 적절한 조작 환경에서 실행해 변경 사항을 검증하고, 사용자가 확인할 수 있는 증거를 모아 인수 보고서로 게시합니다. 기존 검증 계획을 확인하거나 점검 항목을 만들고, `lh` CLI로 결과를 게시할 수 있습니다.

변경된 제품 동작을 실제로 확인하기
스크린샷 등 검증 증거 수집하기
검증 계획과 보고서 작성하기