GTM 工程师技能

面向上市工程的一系列代理技能——研究、内容创作、SEO、地理定位内容研究及前端实现。该仓库旨在同时适用于 Codex 和 Claude Code。

---

工作流程

这些技能被设计为按顺序执行。每一步都会生成文件，作为下一步的输入。

flowchart TD
    RB["品牌研究<br/>URL → brand_dna"]

    RK["关键词研究<br/>→ keyword_research"]
    ROR["Reddit 机会研究<br/>→ reddit_opportunities"]
    GCR["地理内容研究<br/>→ geo_prompt_targets"]

    GCP["地理内容规划<br/>→ content_architecture"]
    BB["建立反向链接<br/>→ backlink_plan"]

    WSGC["撰写 SEO 地理内容<br/>→ markdown 文章"]
    CGC["创建地理图表<br/>→ SVG + 数据表"]

    AC["内容审核<br/>验证来源"]

    BRP["构建资源页面<br/>内容 → 前端"]
    IAG["优化 AEO 地理<br/>网站代码修复"]

    RB --> RK
    RB --> ROR
    RB --> GCR

    RK --> GCP
    ROR --> GCP
    GCR --> GCP
    ROR --> BB
    GCR --> BB

    GCP --> WSGC
    GCP --> CGC

    WSGC --> AC
    CGC --> AC

    AC --> BRP
    AC --> IAG

步骤详解

步骤	技能	输入	输出
1	research-brand	公司 URL	brand_dna.md — 定位、受众、竞争对手、声音
2a	research-keywords	品牌 DNA + 产品类别	keyword_research.md — 按意图优先排列的关键词
2b	reddit-opportunity-research	品牌 DNA + 可选关键词/GEO 文件	reddit_opportunities.md — 排名靠前的 subreddit 和帖子机会
2c	geo-content-research	品牌 DNA + 产品类别	geo_prompt_targets.md — 按商业价值分级的 AI 提示词
3	geo-content-planning	品牌 DNA + 关键词 + GEO 提示词 + Reddit 信号	content_architecture.md — 包含类型、URL 和优先级的页面规划
4a	write-seo-geo-content	内容架构 + 研究	带有 frontmatter 的 Markdown 文章
4b	create-geo-charts	文章中的数据	SVG 图表 + HTML 表格 + JSON-LD
5	audit-content	文章 + 品牌 DNA	审计报告 — 验证过的 URL、统计数据、声明
6a	build-resource-pages	审计后的内容 + 客户代码库	前端资源中心页面
6b	improve-aeo-geo	客户网站代码库	用于提升 AI 可发现性的代码修复

标有 a/b/c 的步骤可以并行运行。

安装

克隆一次仓库，然后将你想要使用的技能文件夹配置到 Codex 或 Claude Code 中即可。

git clone https://github.com/onvoyage-ai/gtm-engineer-skills.git
cd gtm-engineer-skills

每个技能都位于各自的文件夹中，并使用一个 SKILL.md 文件，这与两种工具通用的代理技能模式一致。

Codex

将所需的技能文件夹符号链接或复制到 ~/.codex/skills/（如果你使用自定义的 Codex 主目录，则为 $CODEX_HOME/skills/）。

mkdir -p ~/.codex/skills
ln -s "$PWD/research-brand" ~/.codex/skills/research-brand
ln -s "$PWD/reddit-opportunity-research" ~/.codex/skills/reddit-opportunity-research

Claude Code

将所需的技能文件夹符号链接或复制到 ~/.claude/skills/ 或项目本地的 .claude/skills/ 目录中。

mkdir -p ~/.claude/skills
ln -s "$PWD/research-brand" ~/.claude/skills/research-brand
ln -s "$PWD/reddit-opportunity-research" ~/.claude/skills/reddit-opportunity-research

平台说明

reddit-opportunity-research 流程在两种工具中都很有用，但具体的 Reddit 访问体验因产品而异。ChatGPT 已经在其产品内原生支持 Reddit 访问；Claude 通常不支持，因此在比较输出时请注意这一点。

---

技能

品牌 DNA 研究

通过公司 URL 对其进行研究，生成一份涵盖定位、受众、竞争对手、声音和信息传递的品牌 DNA 文件。

文件夹：research-brand/

SEO/GEO 关键词研究

利用网络搜索、AI 分析，以及可选的付费工具如 Ahrefs 或 Semrush，找出高价值的 SEO 和 GEO 关键词。

文件夹：research-keywords/

Reddit 机会研究

基于品牌 DNA，寻找 Reddit 上的痛点讨论、目标子版块以及搜索语言模式。生成一份排名靠前的机会列表，可用于有效的推广、内容投放和提示词研究。

文件夹：reddit-opportunity-research/

地理内容研究

研究用户就某一产品类别向 AI 引擎提出的问题。生成一张包含商业价值等级（购买/解决/学习）的 GEO 提示词目标表。

文件夹：geo-content-research/

地理内容规划

读取品牌 DNA、关键词研究和 GEO 提示词目标，然后制定内容架构——需要创建哪些页面、页面类型、URL 以及优先级。

文件夹：geo-content-planning/

撰写 SEO + 地理内容

撰写以产品为导向的内容页面，针对搜索引擎和 AI 引擎的引用进行优化。采用研究先行的方法论，结合页面类型框架，不捏造任何统计数据。

文件夹：write-seo-geo-content/

创建 GEO/SEO 图表

创建 AI 引擎能够解析、引用和标注的数据可视化图表。每个图表都包含文本摘要、HTML 数据表和 JSON-LD。

文件夹：create-geo-charts/

内容审核

在发布之前，验证内容的真实性、准确性和链接完整性。及时发现捏造的统计数据、失效的 URL 和错误的来源标注。

文件夹：audit-content/

构建资源页面

将现有的内容 Markdown 文件整合到客户网站上，利用其现有的技术栈和设计系统，构建生产就绪的资源中心页面。

文件夹：build-resource-pages/

优化网站 AEO/GEO

审计网站代码库，并进行代码更改，使 AI 引擎能够更好地发现、解析、引用和标注该网站。

文件夹：improve-aeo-geo/

先检查你的分数：aeo-audit.sh

---

贡献

请参阅 CONTRIBUTING.md，了解如何贡献新技能、改进现有技能或添加示例。

许可证

MIT — 详见 LICENSE。

GTM Engineer Skills 快速上手指南

GTM Engineer Skills 是一套专为“走向市场（GTM）”工程设计的 AI Agent 技能集合，涵盖品牌调研、内容创作、SEO/GEO 优化及前端实现。本工具链旨在与 Codex 和 Claude Code 无缝协作，通过自动化工作流生成高质量的市场营销资产。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux、macOS 或 Windows (WSL2)。
• 核心依赖：
  • git：用于克隆代码仓库。
  • AI 编程助手：需安装并配置好 Codex 或 Claude Code。
• 网络环境：部分技能（如 reddit-opportunity-research）需要访问 Reddit 等海外网站。若在中国大陆开发，建议配置全局代理或使用稳定的网络加速方案，以确保数据抓取成功。
  • 注意：ChatGPT/Codex 通常内置 Reddit 访问能力，而 Claude Code 可能需要依赖外部环境配置。

安装步骤

1. 克隆仓库

首先将项目代码克隆到本地：

git clone https://github.com/onvoyage-ai/gtm-engineer-skills.git
cd gtm-engineer-skills

2. 配置技能路径

根据您使用的 AI 工具，将所需的技能文件夹链接到对应的配置目录中。您可以选择链接全部技能或仅链接需要的部分。

针对 Codex 用户

将技能文件夹软链接至 ~/.codex/skills/ 目录：

mkdir -p ~/.codex/skills
ln -s "$PWD/research-brand" ~/.codex/skills/research-brand
ln -s "$PWD/research-keywords" ~/.codex/skills/research-keywords
ln -s "$PWD/reddit-opportunity-research" ~/.codex/skills/reddit-opportunity-research
ln -s "$PWD/geo-content-research" ~/.codex/skills/geo-content-research
ln -s "$PWD/geo-content-planning" ~/.codex/skills/geo-content-planning
ln -s "$PWD/write-seo-geo-content" ~/.codex/skills/write-seo-geo-content
ln -s "$PWD/create-geo-charts" ~/.codex/skills/create-geo-charts
ln -s "$PWD/audit-content" ~/.codex/skills/audit-content
ln -s "$PWD/build-resource-pages" ~/.codex/skills/build-resource-pages
ln -s "$PWD/improve-aeo-geo" ~/.codex/skills/improve-aeo-geo

针对 Claude Code 用户

将技能文件夹软链接至 ~/.claude/skills/ 目录（或项目本地的 .claude/skills/）：

mkdir -p ~/.claude/skills
ln -s "$PWD/research-brand" ~/.claude/skills/research-brand
ln -s "$PWD/research-keywords" ~/.codex/skills/research-keywords
# ...重复上述命令链接其他所需技能...

基本使用

本工具的核心在于按顺序执行工作流。每个技能都会生成特定的文件（如 .md 文档），作为下一个技能的输入。

推荐工作流示例

假设您要为一个新公司制定内容策略并生成页面，请按以下步骤操作：

第一步：品牌基因调研

启动 AI 助手，调用 research-brand 技能，输入公司官网 URL。

• 输入：公司 URL
• 输出：brand_dna.md（包含定位、受众、竞争对手、语调等）

第二步：并行市场调研 (可同时进行)

基于生成的 brand_dna.md，并行运行以下三个技能：

1. 关键词调研 (research-keywords)：生成 keyword_research.md。
2. Reddit 机会挖掘 (reddit-opportunity-research)：生成 reddit_opportunities.md。
3. GEO 内容调研 (geo-content-research)：生成 geo_prompt_targets.md（针对 AI 引擎的提问模式）。

第三步：内容架构规划

调用 geo-content-planning 技能，整合上述所有调研结果。

• 输入：Brand DNA + 关键词 + GEO 目标 + Reddit 信号
• 输出：content_architecture.md（详细的页面计划、URL 结构及优先级）

第四步：内容生成与可视化

基于架构文档，并行执行：

1. 撰写内容 (write-seo-geo-content)：生成带 Frontmatter 的 Markdown 文章。
2. 创建图表 (create-geo-charts)：生成 SVG 图表、HTML 表格及 JSON-LD 数据。

第五步：审计与部署

1. 内容审计 (audit-content)：验证数据来源、链接有效性及统计数据的真实性。
2. 构建页面 (build-resource-pages)：将审计后的内容集成到客户前端代码库中，生成资源中心页面。
3. 代码优化 (improve-aeo-geo)：自动修复网站代码，提升 AI 引擎对网站的发现和引用能力。

使用提示

• 串行依赖：请确保上一步骤的输出文件已生成，再开始下一步骤，以保证上下文连贯。
• 并行执行：标记为 a/b/c 的步骤（如第二步中的三个调研任务）可以同时在不同的对话窗口或线程中运行以提高效率。
• 检查评分：在进行 AEO/GEO 优化前，建议先运行官方脚本检查当前得分：

  curl -sSL https://aeo-audit.sh/ | bash