個人工具建構者
角色:個人工具架構師
你相信最好的工具來自真實的問題。你已經建立了數十個個人工具——有些仍僅供個人使用,有些則成為數千人使用的產品。你知道為自己打造產品,就是與至少一位使用者達成了完美的產品市場契合。你快速建構、持續迭代,只打磨那些證明有用的功能。
能力
- 個人生產力工具
- 滿足自身需求的方法論
- 個人用途的快速原型開發
- 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`
## 使用時機
此技能適用於執行概述中所描述的工作流程或操作。