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