1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | codex-first-customer-finder-skill |
| 作者/维护者 | Francesco Mistero(Kappaemme-git) |
| 来源链接 | https://github.com/Kappaemme-git/codex-first-customer-finder-skill |
| 许可证 | MIT(GitHub API 验证) |
| GitHub Stars | 907(GitHub API 验证) |
| Forks | 99(GitHub API 验证) |
| 最新版本 | 0.1.0(package.json 记录,未打 Release 标签) |
| 安装方式 | npx --yes codex-first-customer-finder-skill@latest,或 git clone 后手动复制到 ~/.codex/skills/ |
2. 功能介绍与亮点
这是一个面向早期创业者的“首批客户挖掘”技能:给它一个产品 URL、仓库或一句话描述,它会自动定义目标客户画像(ICP)、在公开网络信息中搜索“痛点/替代品咨询/迁移吐槽/招聘扩张”等购买时机信号,为每个候选客户打分(痛点强度、产品匹配度、时机、可触达性、证据质量),并生成一份带来源链接的可分享 HTML 报告,附上基于公开信息撰写的开场白草稿。
核心亮点:① 全流程“只研究不打扰”——SKILL.md 正文明确禁止绕过登录墙/付费墙/访问限制与 robots 规则,禁止使用数据经纪商、泄露数据库、私人群组、个人邮箱或电话反查等私密信息渠道,也禁止依据健康、财务困境、政治、性取向、宗教等敏感属性做画像;② 拒绝自动执行——技能只产出候选名单与开场白草稿,不会自动发送消息、提交表单、关注或建立 CRM 记录,一切外联动作都需要用户另外确认;③ 报告生成脚本(generate_report.py)为纯本地 JSON→HTML 渲染,不发起任何网络请求,且对写入内容做了 HTML 转义处理;④ 提供 quick/standard/deep/design-partners/b2b/community 六种模式,覆盖从早期用户验证到 B2B 商机挖掘等不同场景。
3. 适用场景
所属分类:内容创作与知识管理
适合刚做出产品原型、还没有营销团队的独立开发者与早期创业者:把“上哪找第一批用户”这件事从凭感觉发消息,变成基于公开信号的证据链研究——先搞清楚谁在公开抱怨相关痛点、谁在寻找替代方案,再决定要不要联系。同样适合做设计伙伴招募(design-partners 模式)或本地小微企业陌拜调研(b2b 模式)的场景。
4. 跨 Agent 兼容性
- Codex:原生支持——官方
npx安装器直接把技能放入~/.codex/skills/,README 全部示例均以 Codex 触发语法给出。 - Claude Code / OpenClaw / Hermes Agent:未验证。技能本体是标准 SKILL.md(YAML frontmatter + Markdown 指令),结构上不依赖 Codex 专有能力,但仓库未提供官方安装路径或适配说明,是否可直接复制进对应 Agent 的 skills 目录使用,需用户自行测试。
5. 推荐理由
它把“找第一批客户”这个早期创业者最容易凭感觉、也最容易踩隐私红线的环节,变成了一条可审计的证据链:每个候选客户都挂着公开来源链接和具体的痛点/时机证据,报告里坦诚标注“这是基于公开信号的潜在客户,不是已确认的意向买家”。对没有销售团队、又不想为一次性调研订阅昂贵销售情报工具的独立开发者和初创团队,这是一个安装成本很低、且在设计上主动避开数据隐私雷区的替代方案。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | GitHub 907 stars、99 forks,仓库创建 11 天内快速增长;6 个 issue 来自 4 位不同用户,有真实多人参与 |
| 可用性 | 9 | npx 一条命令安装,SKILL.md 与 README 均含多场景示例,近期持续维护,无付费依赖 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单:
① Shell 命令执行权限范围明确——仅在本地运行 generate_report.py 把结构化 JSON 渲染成静态 HTML,脚本内无网络请求、无 subprocess/eval 等风险调用;
② 联网行为透明——由 Agent 本身执行公开网络研究,用途(客户线索调研)清楚,非隐蔽外发;
③ 无需 API Key 或账号凭据;
④ SKILL.md 正文未发现可疑指令或提示注入迹象,反而主动写明多条隐私红线(禁用数据经纪商/私人邮箱电话/敏感属性推断);
⑤ 作者身份可查(那不勒斯费德里科二世大学计算机专业学生,GitHub 主页与提交记录一致),无刷星或营销话术痕迹;
⑥ License 明确(MIT)。
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与本技能的差异 |
|---|---|---|
| marketingskills(coreyhaines31) | 47 个子技能覆盖文案、SEO、广告、留存等营销全链路 | 广度更大,但客户挖掘只是其中零散能力,没有“证据链打分 + 隐私红线”的专门设计;本技能只做一件事——把首批客户研究做深做透 |
| Agentic-SEO-Skill(Bhanunamikaze) | 面向 SEO 分析与内容优化 | 解决的是“让更多人搜到你”,本技能解决的是“主动找到已经在表达需求的人”,二者互补而非替代 |
8. 用户评价
该技能目前在 GitHub 之外的第三方平台尚无经核实的具名用户评价;仓库自身的 issue 区已有 4 位不同用户提出功能改进请求(如“给开场白补充更具体的联系渠道建议”),显示有真实用户在实际使用后反馈打磨方向。
9. 其他补充
作者 Francesco Mistero 名下还有 codex-startup-pressure-test-skill、local-client-prospector-skill 等同系列 Codex 技能,共享类似的“公开信号研究 + 证据链报告”设计思路。
10. 安装使用方式
方式一(推荐):
npx --yes codex-first-customer-finder-skill@latest
安装完成后重启 Codex,技能会出现在 ~/.codex/skills/first-customer-finder。
方式二(手动):
git clone https://github.com/Kappaemme-git/codex-first-customer-finder-skill.git
mkdir -p ~/.codex/skills
cp -R codex-first-customer-finder-skill/first-customer-finder ~/.codex/skills/first-customer-finder
使用时直接对 Codex 说明产品 URL 与想要的模式,例如:“用 first-customer-finder 帮我的 [产品 URL] 找 10 个有证据支撑的潜在首批客户,standard 模式,生成 HTML 报告。”
11. 注意事项
- 报告中的候选客户是“基于公开信号的推测”,不是已确认的意向买家,正式联系前仍需人工核实;
- 技能本身不负责发送消息、提交表单或建立 CRM 记录,外联动作需要用户自行执行并对合规性负责(如是否符合目标地区的营销/反垃圾邮件法规);
- 目前仅在 Codex 上有官方安装路径,其他 Agent 生态需自行验证兼容性;
- 仓库创建时间较短(11 天),长期维护节奏尚待观察。