findscripter 何时使用
当你有一个自己反复遭遇的真实痛点，想用最小成本做成工具来解决它时。最好的产品常常起步于个人工具：先给自己挠痒处，做到自己每天都用，再发现别人也有同样的痒处。
适用：把每天手动操作 10 次的事自动化、做 CLI、做本地优先的小应用、把脚本逐步养成产品、为自己 dogfood。
不该用（负边界）：
- 没有真实自身痛点，只是"觉得别人会想要""这会很酷""市场上有空白"——这类多半是坏痒处，先别建。
- 一上来就要企业级、多人协作、跨团队的复杂系统。
- 纯 UI/视觉设计需求。
- 需要环境特定的真实测试与专家评审才能定论的场景——本方法论不替代实测。
步骤
- 识别真痒处：用一句话能描述问题；每周都会遇到；已经手动解决过；理想情况下每天会用。任一不满足就要警惕。
- 从丑陋起步（Day 1）：写一个只解决"你自己问题"的脚本——没有 UI、硬编码路径和你的数据、零错误处理、你看得懂每一行。
- 跑稳（Week 1）：处理你自己的边界情况，加上你真正需要的功能；仍然丑，但可靠。
- 可能帮到别人（Month 1）：给未来的你写最简文档、用配置替代硬编码、再考虑分享。
- 选型：CLI 用 Node(commander/chalk) 或 Python(click)；存储按复杂度选 JSON 文件 / better-sqlite3 / IndexedDB / Electron/Tauri+SQLite。
- 判断是否产品化：见下方信号表，命中"别人主动要""每天在用""解决 $100+ 问题""别人愿付费"再投入。
- 分享前过安全与可移植清单（见注意事项）。
指令
Node CLI 起手（commander）：
#!/usr/bin/env node
import { Command } from 'commander';
const program = new Command();
program.name('mytool').description('一句话说明').version('1.0.0');
program.command('do-thing')
.option('-v, --verbose', '详细输出')
.action(async (opts) => { /* 你的逻辑 */ });
program.parse();
package.json 关键："bin": { "mytool": "./bin/cli.js" }，依赖按需取 commander/chalk/ora/inquirer/conf。
Python CLI 起手（click，推荐）：
import click
@click.group()
def cli(): """工具说明"""; pass
@cli.command()
@click.option('--name', '-n', required=True)
def process(name): click.echo(f'Processing {name}')
if __name__ == '__main__': cli()
本地存储——简单用 JSON，复杂用 SQLite：
import { homedir } from 'os'; import { join } from 'path';
const DATA_DIR = join(homedir(), '.mytool'); // 可移植路径
// JSON：loadData/saveData 读写 join(DATA_DIR,'data.json')
// SQLite：new Database(join(DATA_DIR,'data.db'))，建表用 CREATE TABLE IF NOT EXISTS
演进四阶段：① 个人脚本（只你用、硬编码，数小时数天）→ ② 可分享工具（README + 基本错误信息 + 配置文件，数天）→ ③ 公开工具（安装说明、跨平台、版本号、基本测试，一两周）→ ④ 产品（落地页、文档站、支持渠道、隐私友好埋点、收款，数周数月）。
示例
场景：把每天手动转码的操作做成 CLI。
- 识别：每天手动跑 ffmpeg 10 次 → 真痒处。
- Day 1 丑脚本：硬编码输入目录，直接调 ffmpeg，跑通即可。
- 加依赖检查，避免"在我机器上能跑"：
import { execSync } from 'child_process';
function checkDep(cmd, hint) {
try { execSync(`which ${cmd}`, { stdio: 'ignore' }); }
catch { console.error(`Missing: ${cmd}\nInstall: ${hint}`); process.exit(1); }
}
checkDep('ffmpeg', 'brew install ffmpeg');
- 路径改可移植（
join(homedir(), '.mytool', ...)而非'~/data.json'）。 - 加自文档化头注释（WHAT/WHY/WHERE/DEPS + 最后可用日期），方便半年后的你。
- 朋友开始要 → 对照产品化信号，考虑加 web UI 并
npm publish。
注意事项
- 凭据绝不入码（CRITICAL）：
const KEY='sk-xxx'是错的；用process.env.MY_API_KEY或 gitignore 的 config.json。提交前审查 git 历史是否泄密。 - 服务只绑 localhost（HIGH）：个人工具的 web UI 必须
app.listen(3000, '127.0.0.1')，绝不用'0.0.0.0'暴露到网络。 - 可移植性：硬编码绝对路径→用
homedir()/env；shell 写进 shebang；缺依赖要检测并提示安装；OS 差异用platform()/sep处理。脚本顶部加#!/usr/bin/env node（或 python3）。 - 驯服配置：优先级 智能默认 > 单一配置文件 > 环境变量 > 命令行 flag > 交互提问。"我会想改吗"才暴露选项，而非"有人可能想改吗"。每个边界都加 flag 会让配置比工具还大。
- 为遗忘而设计：假设未来的你不记得为何/如何/数据在哪/依赖干嘛。README 写 WHY 而非只写 WHAT；架构简单、依赖最少、数据用标准格式。出错时友好降级，打印数据位置让用户手动取数据。
- 别忘的小项：CLI 要有
.description()与--help（否则未来的你忘了怎么用）；保留版本号与--version；移除调试 console.log；同步操作包 try/catch。 - 何时放手：6 个月没用、问题已不存在、有更好工具、会推倒重来——就归档（注明原因、导出标准格式数据、别删，可能以后还要）。
互见
- 想把工具变现/做成 SaaS → micro-saas-launcher
- 浏览器扩展/Chrome 扩展 → browser-extension-builder
- 自动化/工作流/cron/触发器 → workflow-automation
- 后端/API/数据库 → backend
- AI/GPT/Claude/LLM 包装 → ai-wrapper-product
- Telegram bot → telegram-bot-builder
采编自 sickn33/antigravity-awesome-skills（MIT）。原条目上游源为 vibeship-spawner-skills（Apache 2.0）。