G1GEO Skill 是给 AI Agent 使用的官方能力包。普通用户不需要先安装 CLI，也不用记命令或资源 ID：把安装提示发给 Agent，完成一次浏览器授权，之后直接用自然语言让它读取企业知识、生成内容、执行 GEO 检测、整理报告或推进发布。
开始前 准备一个可以正常登录的 G1GEO 账号，并确认该账号拥有目标产品的访问权限。密码、短信验证码、Cookie 和访问令牌只能由你在对应的安全页面中使用，不要发到 Agent 对话里。
选择可以运行 Skill 的 Agent
当前推荐以下 Agent 产品：
| Agent 产品 | 适合场景 | 开始位置 |
|---|---|---|
| OpenClaw 原版 | 个人或团队自行部署 | 已部署的 Agent 对话 |
| 腾讯 QClaw | 希望通过国内网络快速开始 | QClaw 对话 |
| CodeBuddy | 在 AI 编程工作区中使用 | CodeBuddy 工作区 |
不同产品的入口名称和界面可能变化，但使用路径相同：打开一个允许安装和执行 Skill 的 Agent 对话，把 G1GEO Skill 的安装提示直接发给它。当前支持范围和入口以G1GEO Skill 页面为准。
第一步：把安装提示发给 Agent
打开G1GEO Skill 页面，复制页面中的安装提示，或直接复制下面这句话：
请帮我安装极义GEO技能并登录使用(https://gitee.com/jw2019410/g1geo-skill/tree/main/skills/g1geo)
然后：
- 在 OpenClaw、腾讯 QClaw 或 CodeBuddy 中打开一个新对话；
- 粘贴安装提示并发送；
- 等待 Agent 读取官方 Skill，检查运行环境并完成所需组件安装；
- Agent 提示登录时，继续完成下一步授权。
普通使用者不需要先打开终端手动安装 G1GEO CLI，也不需要把页面中的执行记录复制到终端。Skill 会让 Agent 检查 Node.js 和 CLI 环境；如果当前环境不具备安装条件，Agent 应直接说明缺少什么。
第二步：完成浏览器授权
Agent 准备好环境后，会提供 G1GEO 授权地址，并可能同时显示一次性代码。
- 在浏览器中打开 Agent 提供的授权地址；
- 由你本人登录 G1GEO；
- 核对当前账号和授权内容后确认连接；
- 回到 Agent 对话，告诉它“我已完成授权，请继续检查连接状态”。
只在 G1GEO 页面输入账号信息。Agent 不需要知道你的密码、短信验证码、Cookie、访问令牌或刷新令牌。授权地址失效时，让 Agent 重新发起登录即可。
第三步：确认产品和权限
授权完成后，把下面这句话发给 Agent：
请检查 G1GEO 连接状态，列出我可以访问的产品；如果有多个产品，先让我选择，不要执行写入操作。
Agent 会读取账号可见的产品、最近任务和当前能力。正常情况下：
- 只有一个匹配产品时，Agent 会确认后继续；
- 有多个产品时，Agent 应先让你选择，不能自行使用列表中的第一个；
- 没有可见产品时，Agent 会提示检查账号、产品或成员授权；
- 存在未完成任务时，Agent 会先恢复任务状态，避免重复创建。
你通常不需要查找或输入产品 ID、问题集合 ID、文章 ID 和任务 ID；这些上下文由 Skill 和 Agent 管理。
第四步：直接描述要完成的工作
安装和授权通常只需在首次使用时完成；登录状态失效或被撤销后，需要重新授权。连接正常时，可以像交代同事一样说明目标、范围和限制。
检测品牌并生成报告
使用当前产品的信息，检测我的品牌和两个竞品在主流 AI 平台的表现。失败项单独整理，报告完成后给我分享链接。
整理企业知识和素材
检查当前产品的企业知识，告诉我哪些关键信息还不完整。先给出补充建议，不要直接覆盖已有内容。
从问题生成文章
围绕“企业如何选择 GEO 服务商”整理一组真实用户会问的问题。保存前让我确认，确认后再批量生成文章。
查看趋势并规划下一步
汇总当前品牌在各 AI 平台的整体表现，对比最近两次检测，说明变化来自哪些问题和引用来源，再给出下一步建议。
安排桌面发布
检查目标账号的登录状态，把两篇已确认文章安排到明天 9 点发布。创建发布任务前，先让我确认文章、账号、时间和预计费用。
更多可直接使用的任务示例见G1GEO Skill 页面。
在新对话中继续已有任务
更换 Agent 对话或隔一段时间继续时，不要直接重复上一次指令。先让 Agent 恢复现场：
继续我上次未完成的 G1GEO 工作。先检查当前产品、进行中的任务和最近结果，告诉我现在处于哪一步，不要重复创建任务。
检测、文章生成、裂变、报告和发布可能需要一定时间。Agent 应保留任务状态并继续查询；本地等待超时不代表远端任务失败。
哪些操作需要你确认
| 场景 | Agent 应怎样处理 |
|---|---|
| 多个产品都可能匹配 | 列出必要信息并让你选择 |
| 修改企业知识或文章 | 先读取现状，说明将修改什么 |
| 创建可能消耗积分的任务 | 提交前说明范围和预计费用 |
| 对外发布内容 | 再次确认文章、目标账号或媒体、时间和费用 |
| 删除产品、内容或任务 | 只有你明确要求时才能执行 |
| 查看状态、报告和已有资料 | 可以直接读取并解释结果 |
生成文章不等于获得发布授权；创建投稿任务不等于媒体已经收录；Agent 应分别说明任务已创建、处理中、成功、失败或部分完成。
为什么页面中仍会出现 CLI
G1GEO Skill 负责理解你的自然语言、规划步骤和解释结果，G1GEO CLI 负责在后台完成授权、权限检查、任务创建和状态查询。CLI 是 Agent 的执行层，不是普通用户必须学习的操作界面。
只有开发者维护自动化或排查运行环境时，才需要直接接触 CLI。日常使用中，你只需要和 Agent 对话，并在授权、费用、修改、删除和发布等关键节点做决定。
常见问题
Agent 无法安装 Skill
确认当前 Agent 产品支持 Skill 安装和工具执行，再重新发送完整安装提示。不要只发送仓库名称或截断链接。仍然失败时，让 Agent 保留原始错误并检查网络、运行环境和所需权限，不要反复安装多份副本。
授权完成后仍提示未登录
先确认浏览器中登录的 G1GEO 账号是否正确，再让 Agent 重新检查连接状态。授权地址或一次性代码过期时，重新发起授权；不要把验证码或令牌粘贴到对话中。
Agent 看不到目标产品
检查该账号是否已加入对应产品。子账号还需要主账号授予产品、功能和额度权限，详见主账号、子账号与权限。
Agent 一直显示任务处理中
让 Agent 查询已有任务状态和失败项，不要立即重复创建。需要较长时间的检测或内容任务可以稍后在新对话中恢复。
Agent 让你手动执行 CLI 命令
普通使用者可以直接回复：“请按照已安装的 G1GEO Skill 自行检查环境并执行，我只负责浏览器授权和必要确认。”如果 Agent 所在环境不允许安装或执行工具，需要更换受支持的 Agent 产品。