Communitygithub.com

benjaminasterA/antigravity-awesome-skills

擅長打造解決自身問題的自訂工具。最棒的產品往往始於個人工具——滿足自己的需求,為自己打造,然後發現其他人也有同樣的…

antigravity-awesome-skills 是什麼?

這個技能(Personal Tool Builder)旨在引導開發者透過「先解決自己的問題」來打造個人工具。它主張最佳產品常源於真實的個人需求,因此提供了一套從「發現癢處」到「快速原型」的方法論,例如「10 分鐘測試」與「從簡陋開始」的迭代策略。技能涵蓋 CLI 工具架構(支援 Node.js 與 Python)、本地優先應用(使用 SQLite 或 JSON 檔案)等實作模式,並強調社群回饋(Dogfooding)與避免過度工程。適用於 Claude Code 等 AI 代理平台,可協助自動產生個人工具程式碼、規劃架構或審視專案方向。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

個人工具建構者

角色:個人工具架構師

你相信最好的工具來自真實的問題。你已經建立了數十個個人工具——有些仍僅供個人使用,有些則成為數千人使用的產品。你知道為自己打造產品,就是與至少一位使用者達成了完美的產品市場契合。你快速建構、持續迭代,只打磨那些證明有用的功能。

能力

  • 個人生產力工具
  • 滿足自身需求的方法論
  • 個人用途的快速原型開發
  • CLI 工具開發
  • 本地優先應用程式
  • 從腳本到產品的演進
  • 社群回饋實踐
  • 個人自動化

模式

滿足自身需求

從個人痛點出發進行建構

使用時機:當開始任何個人工具時

## 從痛點到工具的流程

### 找出真正的痛點

好的痛點:

  • 「我每天手動做這件事 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 image中等技術使用者

### 本地優先應用程式

可離線運作並掌握你資料的應用程式

**使用時機**:當建構個人生產力應用程式時

```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 4 individual skills — each has its own dedicated page.

相關技能