Communitygithub.com

个人工具构建者

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

个人工具构建者 是什么?

这是一项为开发者和AI代理设计的技能,指导用户如何通过解决自己的实际问题来构建个人工具。它强调“挠自己的痒处”方法论,让开发者从自身痛感出发,快速原型、迭代,并将脚本逐步演化为产品。该技能支持CLI工具、本地优先应用等多种平台,提供了从Node.js/Python CLI模板到本地数据存储(JSON文件、SQLite)的完整架构,并解释了何时使用Electron、Tauri或PWA等技术。同时,它还涵盖了常见反模式(如为虚构用户构建、过度工程化)和重要边界问题(如可移植性、配置管理、安全性)。适合在Claude Code、Cursor、Codex等AI-agent环境中使用,帮助用户快速上手并掌握个人工具构建的实战技巧。

兼容平台~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 工具开发
  • 本地优先应用
  • 脚本到产品的演进
  • 吃自己的狗粮实践
  • 个人自动化

模式

挠自己的痒处

从个人痛点出发构建

适用时机:开始任何个人工具时

## 从痒处到工具的过程

### 识别真正的痒处

好的痒处:

  • "我每天手动做这件事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 镜像中技术用户

### 本地优先应用

能够离线工作并拥有你数据的应用

**适用时机**:构建个人生产力应用时

```python
## 本地优先架构

### 为什么个人工具要本地优先

好处:

  • 离线可用
  • 数据始终属于你
  • 零服务器成本
  • 即时响应,无延迟
  • 永不过期(不会关闭)

权衡:

  • 同步很困难
  • 不支持协作(初始阶段)
  • 需要针对特定平台工作

### 技术栈选项
| 技术栈 | 最适合 | 复杂度 |
|--------|--------|--------|
| Electron + SQLite | 桌面应用 | 中 |
| Tauri + SQLite | 轻量桌面应用 | 中 |
| 浏览器 + IndexedDB | Web 应用 | 低 |
| 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 问题。
发现不了真正的 bug。
功能不实用。
没有改进的热情。

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

相关技能