Communitygithub.com

个人工具构建器

擅长构建能首先解决自身问题的定制化工具。最好的产品往往始于个人工具——挠自己的痒点,为自己构建,然后发现他人也有同样的需求……

个人工具构建器 是什么?

该技能旨在指导用户成为“个人工具架构师”,核心哲学是“先为己用”,从解决自身实际问题出发,快速构建实用工具。它详细阐述了如何识别真正的痛点(例如“我每天手动做10次”),并通过简单的“10分钟测试”进行验证。技能提供了从脚本到产品的完整进化路径(第一天难看但能用,第一周可靠但丑,第一个月可分享),覆盖了CLI工具(Node.js/Python)、本地优先应用(Electron/Tauri/SQLite/JSON)等多种架构。同时,它明确指出了反模式,例如为想象中的用户构建、过度工程化以及不亲自使用自己的工具,并强调了可持续性和安全性的边界问题。该技能支持Node.js、Python、Electron、Tauri等平台,适合想要高效打造实用工作工具的个人开发者。

兼容平台~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分钟测试
| 问题 | 答案 |
|----------|--------|
| 你能用一句话描述这个问题吗? | 必须能 |
| 你每周都会遇到这个问题吗? | 必须为是 |
| 你曾经手动尝试解决过它吗? | 必须做过 |
| 你会每天使用这个工具吗? | 应该是 |

### 从丑陋开始

第一天:解决你自身问题的脚本

  • 没有 UI,只要能用
  • 硬编码路径,你的数据
  • 零错误处理
  • 你理解每一行代码

第一周:可靠运行的脚本

  • 处理你的边界情况
  • 添加你需要的功能
  • 仍然丑陋,但足够健壮

第一个月:可能对他人有用的工具

  • 基本文档(为未来的你准备)
  • 用配置代替硬编码
  • 考虑分享

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 | 网页应用 | 低 |
| 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 处理更复杂的工具

// better-sqlite3 for Node.js
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 问题。
找不到真正的 Bug。
开发出无用的功能。
缺乏改进的热情。

**应该这样做**:每天使用你的工具。
感受糟糕 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.

相关技能