关于 gtm-icp
gtm-icp 用于在 GTM 工作区管理理想客户画像(ICP),支持创建、更新、删除和检查;未提供的条件保留为 Unknown,并说明对相关工作流的影响。
主要功能
- 01创建、更新和删除 ICP
- 02检查 ICP 结构与完整性
- 03未提供的条件保留为 Unknown
- 04提交并验证工作区变更
适用场景
- 01为 GTM 工作流定义目标账户条件
- 02更新 ICP 信号或排除条件
- 03检查 ICP 文件的结构问题
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ eliasstravik/ gtm-skills --skill gtm-icp安装后在 Claude Code 中输入/gtm-icp确认已加载。
附带文件references/interactions.mdtemplates/ICP.md
详细介绍
GTM ICP
触发条件
当请求要在 GTM 工作区中创建、修改、删除或检查 ICP 时,应用此技能。
范围
此技能负责 契约 所指定工作区中的 icps/<slug>/ICP.md。ICP 记录目标客户的期望或认可标准,涵盖 公司数据 的 13 个字段,绝不记录组织本身的事实。
输入
来自用户或用户提供来源的标准;用于检查是否存在近似重复项的现有 ICP;读取此 ICP 的工作流(workflows/workflows/*.ts 中的 readIcp("<slug>")),用于工作流通知。
角色
用户通过宿主的写入权限批准每项变更;Agent 提议、编辑、提交并报告。
流程
对话中首次使用的 gtm 技能会按更新说明检查一次是否有较新版本。按照交互中的六条规则进行沟通;复现对话。
| 任务 | 操作 |
|---|---|
| 创建 | 如果现有 ICP 与请求重叠,先提议更新。否则,将 templates/ICP.md 复制到 icps/<slug>/ICP.md,只填写用户提供的标准,其余内容留为 Unknown,并说明其余内容保持为 Unknown,因为绝不从公司记录中借用标准。若 ## Company signals 和 ## Disqualifiers 为空,则省略。 |
| 更新 | 修改指定的标准、信号或排除条件。当某个工作流会读取此 ICP 时,说明该工作流下次运行时会使用此变更(推送部署完成后,已部署的副本才会使用),而已评分的行会保留原有评分,直到重新评分。 |
| 删除 | 如果匹配多个 ICP,询问要删除哪一个;说明是否有工作流读取它:在该工作流指定另一个 ICP 之前,运行都会失败。删除 icps/<slug>/;结束时说明删除了什么,以及它仍保留在工作区的历史记录中。 |
| 诊断 | 标记没有可用于匹配客户的标准(所有字段均为 Unknown)、仅有占位内容的空壳、缺少 H1,或文件夹名称与其 slug 不符的 ICP;将可选修复方案告知用户;按用户接受的方案重写。Description 和 Domain 为 Unknown 属于正常情况。 |
每次保存:用一句话说明将要变更的内容;当 origin/main 存在时先拉取;通过宿主的写入路径编辑;在 main 上用通俗易懂的提交说明进行提交;存在远程仓库时推送;验证提交(存在远程仓库时,还要验证提交已到达 origin/main);结束时说明创建、修改或删除了什么。
输出
符合模板结构的 icps/<slug>/ICP.md,每项变更都作为 main 上的提交。
例外情况
必须同时安装 gtm-workspace 技能;如果缺少 ../gtm-workspace/SKILL.md,请说明:按照安装此技能的相同方式安装它,即运行 npx skills add eliasstravik/gtm-skills -s gtm-workspace -y(如果此技能位于全局技能目录中,则添加 -g),然后重试。用户未说明的标准保持为 Unknown;不得从 ORG.md 推导任何内容。
质量检查
- 13 个字段按顺序出现,每个字段各占一行;仅在 Location、Products and services 和 Tech stack 下使用嵌套项目符号。
- 存在 H1,文件夹名称为其 slug;省略空的可选章节。
- 说明变更内容的结束语必须在提交验证后给出。
参考资料
interactions 对话;templates/ICP.md;来自 gtm-workspace 的:interaction、contract、company data。