built-for-devs/dev-trace-skill

# Dev Trace **只需一条命令，即可将邮箱转化为内容丰富、附带引用的公开个人资料。** [](./LICENSE) [](https://nodejs.org) [](https://builtfor.dev) 这是一个来自 [Built for Devs](https://builtfor.dev) 的独立 [agent skill](https://docs.claude.com/en/docs/claude-code/skills)。只需提供一个邮箱，它就会针对公开数据源运行确定性的 **waterfall** 流程——验证、表层信息、核实、GitHub、企业信息丰富、个人信息丰富，以及生成带引用的简介——并返回一份结构化的个人资料，其中每个字段都包含置信度评分和信息来源。 - **无需任何密钥即可在第一天直接运行**，并且随着你添加密钥，获取的数据会更加丰富。 - **默认不产生任何费用。** 付费服务提供商均为可选（opt-in），因此只有当潜在客户值得关注时你才需要付费。 - **仅使用公开数据。** 当结果低于置信度阈值时，它会返回*候选信息*，绝不捏造。 - **零依赖**（需 Node 18+）。每次运行方式完全一致。 ## 快速开始 ``` git clone https://github.com/built-for-devs/dev-trace-skill cd dev-trace-skill # 仅 Free layers，无 keys，无 cost： node scripts/dev-trace.mjs someone@example.com --pretty ``` 这已经能够验证邮箱地址，并抓取 Gravatar、域名以及 GitHub 身份信息。添加密钥（见下文）可解锁企业数据、邮箱核实、个人信息丰富以及带引用的简介。 ## 示例 ``` node scripts/dev-trace.mjs jordan@acme.dev --pretty ``` ``` { "meta": { "email": "jordan@acme.dev", "depths_run": [0,1,2,3,4,5], "match_status": "verified", "sixtyfour_confidence": 9 }, "profile": { "name": { "value": "Jordan Lee", "confidence": 0.90, "sources": ["hunter","sixtyfour"] }, "role": { "value": "Head of Platform", "confidence": 0.90, "sources": ["hunter"] }, "seniority": { "value": "executive", "confidence": 0.85, "sources": ["hunter"] }, "location": { "value": "Austin, Texas, United States", "confidence": 0.90, "sources": ["sixtyfour"] }, "avatar": { "value": "https://gravatar.com/avatar/...", "confidence": 0.80, "sources": ["gravatar"] }, "bio": { "value": "Jordan Lee leads platform engineering at Acme ... [1][2]", "confidence": 0.85, "sources": ["tabstack-research"] }, "company_name": { "value": "Acme", "confidence": 0.90, "sources": ["tabstack","hunter"] }, "company_industry": { "value": "Developer tools", "confidence": 0.85, "sources": ["tabstack"] }, "company_domain": { "value": "acme.dev", "confidence": 0.90, "sources": ["domain"] }, "website": { "value": "https://acme.dev", "confidence": 0.81, "sources": ["sixtyfour"] }, "phone": { "value": "+1 512 555 0143", "confidence": 0.90, "sources": ["sixtyfour"] }, "social_linkedin": { "value": "https://linkedin.com/in/jordanlee", "confidence": 0.90, "sources": ["hunter"] }, "social_github": { "value": "https://github.com/jordanlee", "confidence": 0.90, "sources": ["sixtyfour"] } // ...and more, depending on which layers ran } } ``` 每个字段都带有各自的 `confidence`（置信度）、生成该字段的 `sources`（来源），以及当不同提供商提供的数据存在分歧时的 `conflict`（冲突）标记——因此你始终清楚各个数据的可信度。 ## 可填充的字段 你最终获取的内容取决于实际运行了哪些层级，但 waterfall 流程可以填充非常全面的个人资料： - **身份信息**——`name`、`role`、`seniority`、`location`、`avatar`、`bio` - **企业信息**——`company_name`、`company_description`、`company_industry`、`company_size`、`company_location`、`company_domain` - **社交账号**——`social_linkedin`、`social_twitter`、`social_github`、任何关联 Gravatar 的账号，以及 `company_social_*` - **联系方式**——`email_found`、`phone`、`website` - **GitHub**——`github_login`、`github_public_repos`、`github_followers` 只有在数据源确实返回了相关数据时，相应字段才会出现（仅限公开数据），并且每个字段都会包含 `value` / `confidence` / `sources` / `conflict` 等包装信息。 ## 费用说明 Dev Trace 的设计初衷是让你**免费**获取真正有用的个人资料，并且所有付费提供商均为**可选（opt-in）**。 | 级别 | 提供商 | 获取内容 | |---|---|---| | 🟢 **免费，无需账号** | 内置 | 邮箱验证（语法/MX/一次性邮箱）、Gravatar + 域名表层信息、**GitHub** 身份 | | 🟢 **免费密钥，可选** | GitHub token | 更高的 GitHub rate limits（生成 `GITHUB_TOKEN` 是免费的） | | 🟢 **免费账号，功能强大** | **Tabstack** | 企业/网页信息丰富**以及**带引用、多来源的 `/research` 简介 | | 🟡 **按量计费，提供免费额度，超出后付费** | **Hunter** | 邮箱核实 + 个人信息丰富（LinkedIn、职位、资历） | | 🔴 **高级付费，需真实 $$$$** | **SixtyFour** | 最深入的个人信息 + LinkedIn 挖掘。**约 $4.80/次拉取**（在 `medium` 模式下约 20 点积分，$0.24/积分），入门套餐每月约可使用 5 次。属于应急深度挖掘层，需通过 `--deep` 主动开启。 | 你可以完整运行所有免费流程，不花一分钱。只有当你需要更深度的数据并主动选择付费时，才会用到按量计费和高级付费层级。 ## Waterfall 流程 | 深度 | 层级 | 来源 | 密钥 | 运行条件 | |---|---|---|---|---| | 0 | 验证 | 语法 + MX + 一次性邮箱 | 无 | 始终运行，免费 | | 1 | 表层信息 | Gravatar + 域名抓取 | 无 | 始终运行，免费 | | 1 | 核实 | Hunter 邮箱核实 | `HUNTER_API_KEY` | 存在密钥时 | | 2 | 个人资料 | GitHub 身份 + 基本信息 | `GITHUB_TOKEN`（可选） | 始终运行，免费 | | 3 | 信息丰富 | Tabstack 网页/企业信息 | `TABSTACK_API_KEY` | 存在密钥时 | | 4 | 深度信息 | Hunter 个人信息丰富 | `HUNTER_API_KEY` | 存在密钥时 | | 5 | 最深信息 | SixtyFour 人物情报 | `SIXTYFOUR_API_KEY` | 仅在使用 `--deep` 时 | | 简介 | 综合整理 | Tabstack `/research`（带引用） | `TABSTACK_API_KEY` | 当能解析出姓名时 | 各层级按顺序运行并合并为一份个人资料。如果没有提供某层级的密钥，则会跳过该层级；如果某层级发生错误，该错误会被记录在 `meta` 中，且绝不会中断后续流程。 ## 获取密钥 所有密钥均为可选。只需添加你需要的密钥，并将其放入 `.env` 文件中。 | 提供商 | 获取密钥的地址 | 解锁功能 | 级别 | |---|---|---|---| | **GitHub** | [github.com/settings/tokens](https://github.com/settings/tokens?utm_source=dev-trace-skill&utm_medium=github&utm_campaign=skill) | 更高的 GitHub rate limits | 免费 | | **Tabstack** | [tabstack.ai](https://tabstack.ai/?utm_source=dev-trace-skill&utm_medium=github&utm_campaign=skill) | 企业信息丰富 + 带引用的 `/research` 简介 | 免费账号，额度充足 | | **Hunter** | [hunter.io/api-keys](https://hunter.io/api-keys?utm_source=dev-trace-skill&utm_medium=github&utm_campaign=skill) | 邮箱核实 + 个人信息丰富 | 按量计费 | | **SixtyFour** | [sixtyfour.ai](https://sixtyfour.ai/?utm_source=dev-trace-skill&utm_medium=github&utm_campaign=skill) | 最深入的个人信息 + LinkedIn（`--deep`） | 高级付费 | ``` cp .env.example .env # 添加你拥有的 keys；引擎从 skill 根目录或 scripts/ 读取 .env ``` `.env` 默认被 gitignore 忽略——密钥永远不会被提交到代码库。 ## 作为 Skill 安装 Dev Trace 是一个自包含的 skill 文件夹。要在 agent 中使用它，请将其 clone 到该 agent 加载 skill 的目录中： ``` git clone https://github.com/built-for-devs/dev-trace-skill ~/.claude/skills/dev-trace ``` 对于 Claude Code，该目录是 `~/.claude/skills/`（全局）或项目的 `.claude/skills/`。agent 会读取 `SKILL.md` 并为你调用引擎。如果你使用的 agent 不支持 skill 识别？你可以像在[快速开始](#quickstart)中那样直接运行引擎。 或者，也可以通过 Claude Code 插件市场进行安装： ``` /plugin marketplace add built-for-devs/dev-trace-skill /plugin install dev-trace@built-for-devs ``` ## 与其他 Agent 配合使用 该引擎是一个普通的 Node CLI，因此任何能够运行 shell 命令的 agent 或脚本都可以使用 Dev Trace——例如 Codex、Cursor、Gemini CLI、OpenClaw 或你自己的自动化工具。 - **Claude Code** 读取 [`SKILL.md`](./SKILL.md)。 - **Codex** 以及任何支持 [AGENTS.md](https://agents.md) 的工具会读取 [`AGENTS.md`](./AGENTS.md)。 - **Gemini CLI / Cursor / 其他工具**：直接运行引擎，或者将 `AGENTS.md` 中的用法和成本策略复制到你的 `GEMINI.md` 或 Cursor 规则中。 这两个指令文件描述的是同一个引擎和相同的成本策略，因此无论哪个 agent 驱动它，其行为都是完全一致的。 ## Headless / 自主运行 Agent Dev Trace 可以在任何 headless 环境（云 agent、CI、定时任务）中完美运行，无需修改任何代码： - **密钥直接来自环境变量**——通过你平台惯用的机密注入方式设置 `HUNTER_API_KEY`、`TABSTACK_API_KEY` 等。无需 `.env` 文件。 - **非交互式运行**——无提示符；JSON 直接输出到 stdout，失败的层级会被记录在 `meta` 中，确保单次运行绝不会让整个任务崩溃。 - **未经授权 SixtyFour 绝不扣费**——昂贵的 `--deep` 层级只有在相关人员接受成本后才会运行：在环境中设置 `DEV_TRACE_ALLOW_DEEP=1`（由操作员设定的长期授权）或通过交互式确认。如果自主运行的 agent 在没有进行此项授权的情况下传入了 `--deep`，只会得到一个被跳过的层级记录（记录在 `meta.errors` 中），且 SixtyFour 的扣费为零。 - **`DEV_TRACE_MAX_DEPTH=N`** 可限制默认深度（`--max-depth` 标志仍可针对单次调用进行覆盖），例如 `DEV_TRACE_MAX_DEPTH=2` 会将 agent 限制在免费层级。 - **运行时：** 需要在你的 container/运行时环境中提供 Node 18+ 的支持。 ## 用法 ``` node scripts/dev-trace.mjs [options] ``` | 标志 | 效果 | |---|---| | `--pretty` | 输出人类易读的 JSON | | `--json ` | 将原始 JSON 写入文件 | | `--max-depth N` | 在深度 N（0–4）处停止。`--max-depth 2` 可保持完全免费 | | `--deep` | 启用 SixtyFour（深度 5）。费用高昂、有速率限制、需主动开启 | | `--tier low\|medium\|high` | SixtyFour 研究深度（默认为 `low`） | | `--no-bio` | 跳过 Tabstack `/research` 简介 | | `--bio-mode fast\|balanced\|deep\|max` | 简介研究深度（默认为 `fast`） | ## 输出 ``` { "meta": { "email": "someone@example.com", "depths_run": [0, 1, 2, 3], "match_status": "verified | probable | unverified_candidates", "generated_at": "" }, "profile": { "": { "value": "...", "confidence": 0.0, "sources": ["..."], "conflict": null } } } ``` - `match_status`：`verified`（已确认且可送达）、`probable`（已找到，未确认）、`unverified_candidates`（低于阈值）。 - 失败或受限的层级会被记录在 `meta.errors` / `meta.rate_limited` 中。 ## 核心原则 - **仅使用公开数据。** 绝不捏造个人资料。当结果低于置信度阈值时，会返回候选结果，而不是予以断言。 - **确定性。** 层级顺序和标志固定不变；输出仅随实时源数据和现有密钥的变化而变化。`meta.depths_run` 始终会说明运行了哪些内容。 - **透明的成本。** 默认免费；付费层级均为 opt-in 且有明确标识。 ## 贡献 欢迎提交 Issue 和 PR。请保持引擎的零依赖性（仅使用 Node 内置模块），并确保每个新增层级均受密钥控制且明确标识成本。 MIT © [Built for Devs](https://builtfor.dev)。Hunter、Tabstack、SixtyFour 和 GitHub 均为独立服务——请自备相关的密钥和账号。

标签：AI智能体, ESC4, GNU通用公共许可证, Homebrew安装, MITM代理, Node.js, OSINT, SOC Prime, 信息丰富化, 开发工具, 文档结构分析, 自定义脚本