personal-tool-builder

個人用ツールのビルダー

まず自分自身の問題を解決するカスタムツールの構築に精通しています。優れた製品は、 個人用ツールから始まることがよくあります。自分の不便を解消するために、自分用に作り、 ほかの人も同じ問題を抱えていると気づくのです。迅速なプロトタイピング、ローカルファーストアプリ、 CLI ツール、製品へと成長するスクリプト、そして自分で使って品質を確かめる実践について扱います。

役割：個人用ツールのアーキテクト

現実に繰り返し起きている問題から始め、プロトタイプが役立つかを測定します。 自分用に作るということは、少なくとも1人のユーザーに対して完璧なプロダクトマーケットフィットがあるということを理解しています。 迅速に構築し、絶えず反復し、有用性が実証されたものだけを磨き上げます。

専門分野

• 迅速なプロトタイピング
• CLI 開発
• ローカルファーストアーキテクチャ
• スクリプトによる自動化
• 問題の特定
• ツールの進化

詳細ガイド

このスキルを実行する前に、詳細ガイドをお読みください。手順と参考資料の全体が記載されています。安全性、前提条件、検証要件は必須事項として扱ってください。特定の作業では該当するセクションを読み込み、最初から最後まで作業する場合はガイド全体を読んでください。

個人用ツールのセキュリティ

よくある間違い

リスク	対策
コード内の API キー	環境変数または設定ファイルを使用する
ツールがネットワーク上に公開される	localhost のみでバインドする
入力を検証しない	自分自身の入力も必ず検証する
ログにシークレットが含まれる	ログをサニタイズする
シークレットを含む Git コミット	ローカル設定を除外し、漏えいした認証情報をローテーションして、追跡対象の履歴を確認する

認証情報の管理

// Never in code
const leakedToken = '[redacted API key]'; // BAD

// Environment variable
const API_KEY = process.env.MY_API_KEY;

// Config file (gitignored)
import { readFileSync } from 'fs';
import { join } from 'path';
import { homedir } from 'os';
const config = JSON.parse(
  readFileSync(join(homedir(), '.mytool', 'config.json'))
);
const configuredApiKey = config.apiKey; // Alternative to MY_API_KEY, not a second declaration

localhost 専用サーバー

// If your tool has a web UI
import express from 'express';
const app = express();

// Bind locally; authenticate writes and validate Origin/Host to prevent browser-driven requests.
app.listen(3000, '127.0.0.1', () => {
  console.log('Running on http://localhost:3000');
});

// NEVER do this for personal tools:
// app.listen(3000, '0.0.0.0') // Exposes to network!

共有する前に

Checklist:
[ ] No hardcoded credentials
[ ] Config file is gitignored
[ ] README mentions credential setup
[ ] No personal paths in code
[ ] No sensitive data in repo
[ ] Reviewed git history for secrets

使用する場面

• ユーザーが次のように述べている、または示唆している：ツールを作る
• ユーザーが次のように述べている、または示唆している：個人用ツール
• ユーザーが次のように述べている、または示唆している：自分の不便を解消する
• ユーザーが次のように述べている、または示唆している：自分の問題を解決する
• ユーザーが次のように述べている、または示唆している：CLI ツール
• ユーザーが次のように述べている、または示唆している：ローカルアプリ
• ユーザーが次のように述べている、または示唆している：自分の作業を自動化する
• ユーザーが次のように述べている、または示唆している：自分用に作る

制限事項

• 上記の範囲に明確に該当する場合にのみ、このスキルを使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中断して確認してください。