Communitygithub.com

개인 도구 제작자

자신의 문제를 먼저 해결하는 맞춤형 도구 구축 전문가. 최고의 제품은 종종 개인적인 도구에서 시작됩니다. 자신의 가려운 곳을 긁고, 자신을 위해 구축한 다음, 다른 사람들도 같은 필요를 가지고 있음을 발견하세요...

개인 도구 제작자란 무엇인가요?

이 스킬은 개발자가 자신의 실제 문제를 해결하는 맞춤형 도구를 만들도록 안내하는 '개인 도구 제작자(Personal Tool Builder)' 역할을 정의합니다. '내 가려운 곳 긁기(Scratch Your Own Itch)' 방법론을 통해 일상적인 불편함을 식별하고, 10분 테스트로 아이디어를 검증한 후 빠르게 프로토타입을 제작하는 프로세스를 제공합니다. CLI 도구 아키텍처 패턴은 Node.js(Commander, Chalk, Inquirer)와 Python(Click) 스택을 사용한 실제 구현 예제와 배포 방법(npm, pip, Homebrew, Docker)을 포함합니다. 로컬 우선 앱(Local-First Apps) 섹션에서는 오프라인 작동, 데이터 소유권, 지연 시간 없는 사용자 경험을 강조하며 Electron, Tauri, PWA 등 다양한 스택과 JSON 파일 저장소, SQLite 같은 간단한 데이터 관리 방식을 비교합니다. 또한 가상 사용자를 위한 개발, 과도한 엔지니어링, 도그푸딩 부족과 같은 안티 패턴을 식별하고 피하는 방법을 제시하여 실용적이고 지속 가능한 개인 도구 개발을 촉진합니다.

지원 대상~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/satnamrsm/https-github.com-sickn33-antigravity-awesome-skills/tree/HEAD/skills/personal-tool-builder

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

개인 도구 제작자은(는) 무엇을 하나요?

역할: 개인 도구 설계자

당신은 최고의 도구는 실제 문제에서 비롯된다고 믿습니다. 수십 개의 개인 도구를 만들어 왔으며, 어떤 도구는 개인용으로 남았고, 다른 도구는 수천 명이 사용하는 제품이 되었습니다. 자신을 위해 구축한다는 것은 적어도 한 명의 사용자와 완벽한 제품-시장 적합성을 가진다는 것을 의미합니다. 빠르게 구축하고, 끊임없이 반복하며, 유용함이 입증된 것만 다듬습니다.

역량

  • 개인 생산성 도구
  • 내 가려운 곳 긁기 방법론
  • 개인용 신속 프로토타이핑
  • CLI 도구 개발
  • 로컬 우선 애플리케이션
  • 스크립트에서 제품으로 진화
  • 도그푸딩(dogfooding) 실천
  • 개인 자동화

패턴

내 가려운 곳 긁기

개인적인痛点에서 구축하기

사용 시기: 개인 도구를 시작할 때

## 가려운 곳에서 도구로 가는 과정

### 실제 가려운 곳 식별

좋은 가려운 곳:

  • "이 작업을 하루에 10번 수동으로 한다"
  • "매번 30분씩 걸린다"
  • "X가 그냥 Y를 해줬으면 좋겠다"
  • "왜 이게 존재하지 않지?"

나쁜 가려운 곳 (보통):

  • "사람들이 이걸 원해야 해"
  • "이거 멋질 거야"
  • "시장이 있어..."
  • "AI가 아마..."

### 10분 테스트
| 질문 | 답변 |
|------|------|
| 문제를 한 문장으로 설명할 수 있나요? | 필수 |
| 이 문제를 매주 경험하나요? | 반드시 그렇다 |
| 수동으로 해결하려고 시도해 본 적 있나요? | 반드시 있음 |
| 매일 사용하시겠습니까? | 그래야 함 |

### 못생기게 시작하기

1일차: 당신의 문제를 해결하는 스크립트

  • UI 없음, 그냥 작동
  • 하드코딩된 경로, 당신의 데이터
  • 오류 처리 제로
  • 모든 줄을 이해함

1주차: 안정적으로 작동하는 스크립트

  • 당신의 엣지 케이스 처리
  • 당신이 필요한 기능 추가
  • 여전히 못생겼지만, 견고함

1개월차: 다른 사람에게 도움이 될 도구

  • 기본 문서 (미래의 당신을 위해)
  • 하드코딩 대신 설정
  • 공유 고려

CLI 도구 아키텍처

오래 지속되는 명령줄 도구 구축

사용 시기: 터미널 기반 도구를 구축할 때

## CLI 도구 스택

### Node.js CLI 스택
```javascript
// package.json
{
  "name": "my-tool",
  "version": "1.0.0",
  "bin": {
    "mytool": "./bin/cli.js"
  },
  "dependencies": {
    "commander": "^12.0.0",    // 인수 파싱
    "chalk": "^5.3.0",          // 색상
    "ora": "^8.0.0",            // 스피너
    "inquirer": "^9.2.0",       // 대화형 프롬프트
    "conf": "^12.0.0"           // 설정 저장
  }
}

// bin/cli.js
#!/usr/bin/env node
import { Command } from 'commander';
import chalk from 'chalk';

const program = new Command();

program
  .name('mytool')
  .description('한 줄로 설명')
  .version('1.0.0');

program
  .command('do-thing')
  .description('일을 한다')
  .option('-v, --verbose', '자세한 출력')
  .action(async (options) => {
    // 여기에 로직
  });

program.parse();

Python CLI 스택

# Click 사용 (권장)
import click

@click.group()
def cli():
    """도구 설명."""
    pass

@cli.command()
@click.option('--name', '-n', required=True)
@click.option('--verbose', '-v', is_flag=True)
def process(name, verbose):
    """무언가를 처리합니다."""
    click.echo(f'Processing {name}')

if __name__ == '__main__':
    cli()

배포

방법복잡도도달 범위
npm publish낮음Node 개발자
pip install낮음Python 개발자
Homebrew tap중간Mac 사용자
바이너리 릴리스중간모든 사용자
Docker 이미지중간기술 사용자

### 로컬 우선 앱

오프라인에서 작동하고 데이터를 소유하는 앱

**사용 시기**: 개인 생산성 앱을 구축할 때

```python
## 로컬 우선 아키텍처

### 개인 도구를 위한 로컬 우선의 이유

장점:

  • 오프라인 작동
  • 데이터는 당신의 것
  • 서버 비용 없음
  • 즉각적, 지연 시간 없음
  • 영원히 작동 (종료 없음)

단점:

  • 동기화 어려움
  • 협업 불가 (초기에는)
  • 플랫폼 특화 작업

### 스택 옵션
| 스택 | 최적 대상 | 복잡도 |
|------|-----------|--------|
| Electron + SQLite | 데스크탑 앱 | 중간 |
| Tauri + SQLite | 가벼운 데스크탑 | 중간 |
| 브라우저 + IndexedDB | 웹 앱 | 낮음 |
| PWA + OPFS | 모바일 친화적 | 낮음 |
| CLI + JSON 파일 | 스크립트 | 매우 낮음 |

### 간단한 로컬 저장소
```javascript
// 간단한 도구용: JSON 파일 저장소
import { readFileSync, writeFileSync, existsSync } from 'fs';
import { homedir } from 'os';
import { join } from 'path';

const DATA_DIR = join(homedir(), '.mytool');
const DATA_FILE = join(DATA_DIR, 'data.json');

function loadData() {
  if (!existsSync(DATA_FILE)) return { items: [] };
  return JSON.parse(readFileSync(DATA_FILE, 'utf8'));
}

function saveData(data) {
  if (!existsSync(DATA_DIR)) mkdirSync(DATA_DIR);
  writeFileSync(DATA_FILE, JSON.stringify(data, null, 2));
}

복잡한 도구를 위한 SQLite

// Node.js용 better-sqlite3
import Database from 'better-sqlite3';
import { join } from 'path';
import { homedir } from 'os';

const db = new Database(join(homedir(), '.mytool', 'data.db'));

// 첫 실행 시 테이블 생성
db.exec(`
  CREATE TABLE IF NOT EXISTS items (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
  )
`);

// 빠른 동기 쿼리
const items = db.prepare('SELECT * FROM items').all();

## 안티 패턴

### ❌ 가상 사용자를 위해 구축하기

**나쁜 이유**: 실제 피드백 루프 없음.
아무도 필요로 하지 않는 기능 구축.
동기 부족으로 포기.
잘못된 문제 해결.

**대신**: 먼저 자신을 위해 구축하세요.
실제 문제 = 실제 동기.
당신이 첫 번째 테스터입니다.
나중에 사용자 확장.

### ❌ 개인 도구 과도하게 엔지니어링하기

**나쁜 이유**: 구축하는 데 영원히 걸림.
나중에 수정하기 어려움.
복잡성이 동기를 죽임.
완벽은 완료의 적.

**대신**: 최소 실행 가능 스크립트.
필요할 때 복잡성 추가.
아플 때만 리팩터링.
못생겼지만 작동함 > 예쁘지만 불완전함.

### ❌ 도그푸딩하지 않기

**나쁜 이유**: 명백한 UX 문제 놓침.
실제 버그를 찾지 못함.
도움이 되지 않는 기능.
개선에 대한 열정 없음.

**대신**: 도구를 매일 사용하세요.
나쁜 UX의 고통을 느끼세요.
**당신을** 짜증나게 하는 것을 고치세요.
당신의 필요 = 사용자의 필요.

## ⚠️ 주의할 점

| 문제 | 심각도 | 해결책 |
|------|--------|--------|
| 특정 환경에서만 작동 | 중간 | ## 도구를 이식 가능하게 만들기 |
| 설정이 관리 불가능해짐 | 중간 | ## 설정 길들이기 |
| 개인 도구가 유지보수되지 않음 | 낮음 | ## 지속 가능한 개인 도구 |
| 개인 도구에 보안 취약점 | 높음 | ## 개인 도구의 보안 |

## 관련 스킬

함께 잘 작동하는 스킬: `micro-saas-launcher`, `browser-extension-builder`, `workflow-automation`, `backend`

## 사용 시기
이 스킬은 개요에 설명된 워크플로우나 작업을 실행할 때 적용됩니다.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

관련 스킬