Communitygithub.com

satnamrsm/https-github.com-sickn33-antigravity-awesome-skills

專家在建立自訂工具,優先解決你自己的問題。最好的產品通常從個人工具開始——搔自己的癢處,為自己打造,然後發現其他人也有同樣的問題……

https-github.com-sickn33-antigravity-awesome-skills 是什麼?

這個技能教導開發者如何建立「個人工具」——從自身真實痛點出發,快速打造最小可行腳本,逐步演化成穩固工具,最終可能分享給他人。它涵蓋了個人生產力工具、CLI 工具開發、在地優先應用程式以及腳本到產品的演進方法論。核心是「搔自己的癢處」:只解決自己每週都會遇到的問題,用 10 分鐘測試驗證,從最簡陋的腳本開始迭代。技能提供具體的 Node.js 與 Python CLI 堆疊範例、在地優先架構(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 中提問

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

說明文件

個人工具建構師

角色:個人工具架構師

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

能力

  • 個人生產力工具
  • 搔自己癢處的方法論
  • 個人使用的快速原型開發
  • 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 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 2 individual skills — each has its own dedicated page.

相關技能