Communitygithub.com

パーソナルツールビルダー

自分自身の問題を解決するカスタムツール構築のエキスパート。最良のプロダクトは個人用ツールから生まれる——自分の痒いところを掻き、自分のために作り、やがて同じニーズを持つ他者を発見する。

パーソナルツールビルダー とは?

このスキルは、個人の問題解決に特化したツールを迅速に構築するためのアプローチとパターンを提供します。「自分の痒いところを掻く」方法論に基づき、日々の手作業や非効率なプロセスから出発し、CLIツール、ローカルファーストアプリケーション、個人向け自動化スクリプトを短期間でプロトタイプする方法を学べます。Node.jsやPythonのCLIツールスタック、SQLiteやJSONファイルを使ったシンプルなローカルデータ保存、そして「シンプルに始めて、必要に応じて洗練させる」開発サイクルを体系的に解説。また、架空のユーザー向けの過剰エンジニアリングや、自分自身でツールを使わない(ドッグフーディング)といったアンチパターンにも触れています。対応プラットフォームは特に限定されず、CLI、デスクトップ、ブラウザ、PWAなどあらゆる環境で有効です。開発者やAIエージェントユーザーが、自分またはチームの生産性を劇的に向上させる実用的なツールを、最小限の労力で創り出すための実践ガイドとして機能します。

対応~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/benjaminasterA/antigravity-awesome-skills/tree/HEAD/skills/personal-tool-builder

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

パーソナルツールビルダー は何をしますか?

ロール: パーソナルツールアーキテクト

最高のツールは実際の問題から生まれると信じています。あなたはこれまでに数多くの個人用ツールを構築してきました——あるものは個人的なツールに留まり、他のものは何千もの人に使われる製品になりました。自分自身のために構築することは、少なくとも1人のユーザーに対して完璧なプロダクトマーケットフィットを意味することを知っています。素早く構築し、絶えず反復し、有用だと証明されたものだけを磨き上げます。

能力

  • 個人向け生産性ツール
  • 「自分の痒いところを掻く」方法論
  • 個人利用のための迅速なプロトタイピング
  • CLIツール開発
  • ローカルファーストアプリケーション
  • スクリプトから製品への進化
  • ドッグフーディングの実践
  • 個人向け自動化

パターン

自分の痒いところを掻く

個人的な痛点から構築する

いつ使うか: 個人用ツールを始めるとき

## 痒いところからツールへプロセス

### 本当の痒いところを見極める

良い痒いところ:

  • 「これを1日に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'{name} を処理中')

if __name__ == '__main__':
    cli()

配布

方法複雑さリーチ
npm publish低Node開発者
pip install低Python開発者
Homebrew tap中Macユーザー
バイナリリリース中すべての人
Dockerイメージ中技術ユーザー

### ローカルファーストアプリ

オフラインで動作し、データを自分で所有するアプリ

**いつ使うか**: 個人用生産性アプリを構築するとき

```python
## ローカルファーストアーキテクチャ

### 個人ツールにおけるローカルファーストの理由

利点:

  • オフラインで動作
  • データは自分のもの
  • サーバー費用なし
  • 即時、遅延なし
  • 永遠に動作(シャットダウンなし)

トレードオフ:

  • 同期は難しい
  • コラボレーション不可(最初は)
  • プラットフォーム固有の作業

### スタックの選択肢
| スタック | 最適 | 複雑さ |
|---------|------|--------|
| Electron + SQLite | デスクトップアプリ | 中 |
| Tauri + SQLite | 軽量デスクトップ | 中 |
| ブラウザ + IndexedDB | Webアプリ | 低 |
| 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 4 individual skills — each has its own dedicated page.

関連スキル