⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
geo-first-principles
GEO第一性原理。当企业负责人问"我们要不要做GEO""AI里搜不到我们值不值得投入""GEO从哪一步开始"时使用。从行业竞争、增长来源与客户购买推导GEO是否适合、价值在哪里、怎样投入,默认交付完整易读的单页 HTML 经营报告:六部分各有核心金句、五个自测问题,并以GEO十步路线收口。不自动实测、不模拟AI回答、不承诺排名。维护本Skill时不启动企业诊断。
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
Not yet listed on ClawHub or SkillsMP
// README
GEO第一性原理
先讲清客户为什么买,再判断 GEO 是否值得做、值在哪里。
作者:allenlion · 版本:1.1 · 许可证:MIT
面向企业负责人、营销负责人和企业服务团队的经营分析 Skill。从行业竞争、客户购买与企业增长出发,判断 AI 能改变哪项选择、带来什么业务价值,以及当前最值得的投入方式。
GEO(Generative Engine Optimization,生成式引擎优化)关注内容在生成式 AI 回答中的可见性,概念可参见 GEO 原始论文。本 Skill 从经营角度进一步分析:这种呈现能否帮助客户发现、理解和核验企业的真实价值,影响选择并带来业务改善。
这里的“第一性原理”,是从客户任务、交易条件与企业收益出发推导投入必要性。分析不预设每家企业都适合 GEO,结论可以是开始、扩大、改善、维持、小范围确认机会或暂缓。
本 Skill 是 GEO 十环开源体系的第 0 环。十环是从事实本体出发、以效果归因收口、再回流本体的一条闭环:事实本体 → 业务目标 → 用户意图 → 基线检测 → 策略形成 → 内容制作 → 信源管理发布 → 持续监测 → 效果归因 → 回流本体。本 Skill 负责判断值不值得做、从哪一环开始;报告的最后一部分会把决定落成一条按环推进的路线,写明每环的动作、负责人、产出与过关标准,并标注哪些企业自己能完成、哪些对应后续开源的工具或模板。工具清单与状态见 references/ten-ring-handoff.md,随各环工具发布逐步更新。
你会得到什么
默认得到一份带左侧分级导航、可直接打开的单页 HTML:六部分完整分析、醒目的章节金句、五个可复制问题、十步路线与行动安排,以及最终结论和数据来源。页面连续滚动,正文全部展开;用户明确指定其他格式时按其要求。
- 行业的第一性原理:客户需求与竞争格局:客户为何付钱、企业靠什么增长、竞争优势在什么条件下成立。
- 企业的获客与成交漏斗:客户怎样了解、比较与购买,现有渠道怎样帮助,当前最值得改善什么。
- 企业做 GEO 的价值与适用性:AI 可能改变谁的什么决定,企业能否接住,这项改变是否值得投入。
- 企业的 GEO 重点场景与目标:比较现实机会,选择优先帮助的客户、关键判断与业务行动。
- 到 AI 中实测这五个问题,了解客户目前会看到什么:提供五个可复制问题、具体操作与简短记录表。
- 企业的 GEO 布局与投入建议:按 GEO 十环把决定落成有先后的路线。范围随决定取舍——暂缓只做事实一页纸,有限确认走到基线检测,开始走到信源发布并定下监测、归因与回流的节奏;范围内每环写清动作、负责人、产出、过关标准,以及自己做、开源工具或付费能力。附一张三十天路线表,每条都是企业不采购任何东西就能完成的事。
结尾按最终判断、生意本质、GEO 的价值、最值得的做法、投入取舍、下一步形成独立可读的决定;“下一步”是三十天内的前三件事、从第几环开始、什么时候回来重看。
正文和结论都不设最低字数。深度来自解释购买条件、竞争取舍和经营后果;每个判断在合适的位置讲透一次,保留必要依据,减少重复。标题使用能直接理解的业务语言,场景使用客户或需求名称。
流量依赖、信任验证和决策复杂度可以同时存在。需要信任不等于企业缺乏信任,流程复杂也不自动证明适合 GEO。分析会追问:假设 AI 已准确介绍你的企业,能改变哪类客户的什么决定,对生意有什么价值?
首次尝试分析机会;已有 AI 获客则判断怎样延续和扩大;稳定运行则比较维持、改善和新机会。公开资料少不会自动被认定为没有需求,资料多也不代表 GEO 已有效。暂缓时会说明资源优先去向和重新考虑条件。
1.1 的阅读与速度升级
- 每个主模块都有核心金句,先点明该章对企业的价值,展开的步骤也有通俗要点。
- 六部分分析、五题、十步完整介绍、本企业路线、负责人、完成标准与来源均保留;不为等高卡片、屏数或美观删掉信息。
- 暖白正文、米色左侧导航和柔和重点块,连续滚动;章节与十步可直接跳转,手机目录可展开,五题支持复制,宽表保留全部列。
- 通过客户路径、并列卡片、数字口径和操作步骤图帮助阅读,完整正文与来源全部展开。没有数据不画比例,不为可视化删减关键内容。
- HTML 模板预先准备,模型不用每次重写样式。随包的可选
scripts/render_report.py只读本地正文并生成 HTML,使用 Python 3.9+ 标准库,无联网、无安装依赖;不会执行模型诊断。没有代码执行能力的应用直接复用模板。 - 网页不依赖外部字体、在线脚本或图片生成;关闭脚本仍可阅读全文。速度优化针对排版工作,完整研究和写作时间仍由模型与检索情况决定。
安装时使用完整技能目录;需要固定本版时,下载下方的 1.1 安装包。
快速安装
把下面这句话发给具备联网、文件读写和技能安装能力的 Agent:
帮我安装 GEO第一性原理: https://github.com/ALLENLION35/geo-first-principles 。请阅读仓库 README,按照当前应用支持的方式安装完整技能目录,安装后确认能找到 geo-first-principles。
首次安装建议附上仓库地址。只说“帮我安装 GEO第一性原理”是否能找到本项目,取决于应用的搜索与索引;仅能聊天的应用请使用下方的文件加载方式。
开始使用
加载后直接输入:
使用 GEO第一性原理。企业名称:……;主要业务:……;客户与地区:……;这次最想解决的问题:……;已有 GEO 尝试和结果:……。
官网、产品资料、客户反馈和已有记录,有就附上。无需先准备完整报表,只补问真正影响判断的信息。可以指定关注的 AI 产品,也可以要求只分析某一业务或提供更详细的说明。
五题怎样实测
报告会先告诉你怎样操作:打开选定的 AI 产品,每题新建对话、只复制该问题;记录日期、产品、模式和联网设置;保存完整回答或截图及可见来源,并按平台与日期归在同一文档中。
五题从优先业务需要中选出,涉及品牌验证、品类需求、竞品对比、交付使用与售后、行业认知与科普,不要求每类各一题。每题聚焦一项主要疑问。
Skill 提供问题与操作,不自动运行测试或分析实测回答效果。记录用于了解当时客户可能看到什么;五题表现不能直接证明获客效果、需求规模或投资回报。后续布局可参考实际来源和呈现形式,投入仍要结合客户行为、贡献、成本与承接能力判断。
五题在十环路线里有明确位置:问题进入第 3 环的客户问题清单(标注来源),回答作为第 4 环的首次小样本观察。要报“提到的比例”一类数字,同一套问题需要在同一产品上反复抽样,这是监测类工具的事,报告会如实说明,不用五次结果冒充比例。
安装与跨平台使用
本项目按 Agent Skills 格式组织。发布包的技能目录为 geo-first-principles,核心指令文件为 SKILL.md;指令采用 Markdown 不代表报告只能输出 Markdown。
| 使用环境 | 操作方式 |
|---|---|
| Codex | 将上方安装指令与仓库地址发给 Codex,或使用下方命令行安装并选择 Codex |
| Claude Code | 将上方安装指令与仓库地址发给 Claude Code,或使用下方命令行安装并选择 Claude Code |
| Claude 聊天版 | 在 Customize → Skills → + Create skill → Upload a skill 上传完整 ZIP;需开启代码执行与文件创建,组织账号还受管理员设置影响。参见 Claude 官方说明 |
| WorkBuddy | 在“技能”中点击“添加技能”,导入本地技能包;以当前客户端接受的文件类型为准,也可把仓库地址交给 Agent 安装。参见 WorkBuddy 官方说明 |
| 豆包 | 普通聊天中先上传 SKILL.md 与所需 references 文件,并明确要求按照附件执行;如所用版本提供 Skills 管理,则按该版本说明导入,不把普通聊天的附件加载称作原生安装 |
| 只能输入文本的聊天应用 | 粘贴 SKILL.md 中 YAML 头部之后的正文,再提供企业信息;需要参考资料时继续提供对应文件内容 |
上传或粘贴属于在对话中加载指令,不等于原生安装;跨对话保留取决于应用。格式兼容不等于所有客户端均已验证,检索、文件生成和呈现效果也取决于应用能力。核心流程不要求指定模型的 API 密钥、付费接口或插件。
使用 skills CLI 从 GitHub 安装:
npx skills add ALLENLION35/geo-first-principles --skill geo-first-principles
需要先查看安装器是否识别到技能,可以只列出技能而不安装:
npx skills add ALLENLION35/geo-first-principles --list
也可以解压安装包,在 geo-first-principles 的上一级执行:
npx skills add ./geo-first-principles --skill geo-first-principles
按提示选择目标 Agent。命令默认安装到当前项目;需要跨项目使用时添加 --global。此方式需要 Node.js、npm 和安装器所需网络,也可以使用应用自带的导入方式。
明确安装到 Codex 或 Claude Code 的个人技能目录时,可分别执行:
npx skills add ALLENLION35/geo-first-principles --skill geo-first-principles --agent codex --global
npx skills add ALLENLION35/geo-first-principles --skill geo-first-principles --agent claude-code --global
这些命令的参数以 skills CLI 官方说明为依据。只执行自己需要的平台对应命令;安装完成后,重新打开会话并请求使用 GEO第一性原理。
文件与运行方式
| 文件 | 用途 |
|---|---|
SKILL.md | 核心推导、六部分报告、企业表达与交付边界 |
references/first-principles-analysis.md | 行业经济关系、购买取舍与适用性分析 |
references/competition-research.md | 客户研究、真实竞品与营销痕迹核对 |
references/funnel-and-scenarios.md | 客户路径、业务场景与五类问题 |
references/planning-and-handoff.md | 场景选择、实测操作、记录与模型条件 |
references/ten-ring-handoff.md | 十环路线:决定与路线范围、每环的过关标准、三十天表、开源生态工具清单 |
references/html-report.md | 单页 HTML、章节金句、完整性和快速生成规则 |
assets/report-template.html | 可复用的单页模板与内嵌样式 |
scripts/render_report.py | 可选本地渲染器;不联网,不安装依赖 |
tests/test_render_report.py | 标准库回归测试:示例结构、分级目录、可视化、代码块、链接与输入校验 |
references/ten-step-playbook.md | 十步的详细动作与成品形态 |
assets/ten-steps.svg、assets/feedback-wechat-qr.jpg | 备用路线图和交流图片 |
references/report-example.md | 基于虚构材料的完整企业报告示例 |
agents/openai.yaml、assets/icon.svg | 支持元数据的应用中的入口与图标 |
LICENSE | MIT 许可全文 |
RELEASE_NOTES.md | 1.1 发布说明 |
参考文件按需读取,主文件包含完整核心流程。复用已核对的研究,只对影响判断的未知或变化补查,减少重复搜索、读取和生成。运行时间仍取决于宿主模型、检索和输出,不承诺固定分钟数。
竞争研究需要联网能力;无法联网时基于已有材料分析,并说明待核对的竞争信息。无法绘图时用阶段表。报告默认是单页 HTML;能执行脚本时只生成一次完整正文并复用模板,不能执行时直接生成 HTML;多种版本使用同一套分析,保持事实、引用、五题与结论一致。
Skill 不承诺推荐、排名、收录或成交,不自动公开发布内容或付费。联网检索只使用必要的公开信息,未获授权的非公开企业资料不得提交给外部服务。模型与工具的数据处理遵循所在应用的设置与规则。
维护者可在技能目录中运行本地检查,无需安装第三方依赖:
python3 -B -m unittest discover -s tests -v
python3 -B scripts/render_report.py --example -o preview.html
版本记录
- 1.1:默认交付完整单页 HTML,新增章节金句、通俗表达与轻量渲染路径;第六部分按 GEO 十步给出行动路线、负责人、三十天安排和过关标准;最终结论新增“下一步”,五题衔接问题清单与首次观察。新增十步手册、生态工具清单、HTML 规范、模板与本地渲染器;保留六部分分析、五题实测与原有经营判断边界。
- 1.0:首个公开版本。
开源使用与贡献
采用 MIT 许可证。使用、修改和分发时保留版权及许可声明。
欢迎提交能复现问题的反馈:业务目标、必要输入、模型与模式、实际输出和具体偏差。请先去除客户隐私、账号凭据和未获授权的企业资料。改进应形成通用判断方法,避免将单个品牌的情况固定为所有企业的答案。
交流与反馈群
欢迎交流使用心得、提出问题与改进建议。扫码添加微信,申请加入交流与反馈群。
// HOW IT'S BUILT
// FILES
20 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.
SKILL.md40 KBeace6bec02edtruncatedupstream ↗
Showing the inlined prefix. The rest is in the upstream file.
--- name: geo-first-principles description: GEO第一性原理。当企业负责人问"我们要不要做GEO""AI里搜不到我们值不值得投入""GEO从哪一步开始"时使用。从行业竞争、增长来源与客户购买推导GEO是否适合、价值在哪里、怎样投入,默认交付完整易读的单页 HTML 经营报告:六部分各有核心金句、五个自测问题,并以GEO十步路线收口。不自动实测、不模拟AI回答、不承诺排名。维护本Skill时不启动企业诊断。 --- # GEO第一性原理 作者:allenlion 版本:1.1 · 左侧导航、完整单页 HTML、章节图示与十步行动路线 讲透这门生意靠什么增长、客户凭什么选择,再判断 AI 能改变什么、GEO 是否值得投入。 ## 交付目标 为企业负责人形成一份可以据此作决定的经营分析。这里的第一性原理,是从客户任务、交易条件与企业收益出发,逐步推导 GEO 的必要性,不预设每家企业都应该做。主线是:生意的增长逻辑 → 当前机会与限制 → AI 的具体作用 → GEO 的投入决定 → 从哪一环开始做。 本 Skill 是 GEO 十环开源体系的第 0 环:先判断值不值得做,再把决定交给后面的环(事实本体 → 业务目标 → 用户意图 → 基线检测 → 策略形成 → 内容制作 → 信源管理发布 → 持续监测 → 效果归因 → 回流本体)。分析可以停在"暂缓",但只要给出建议,就要落到具体的环、动作和过关标准。 不设正文或结论的字数下限。篇幅由需要解释的经营问题决定;保留具体依据、因果、关键取舍与反例,删除重复论证、无关行业资料和方法说明。一个判断在最合适的位置讲透一次,后文只补新的条件或推进决定。不能用短评代替分析,也不能靠重复“补资料、建信任”制造深度。 本文件中的分析要求、检查项与参考方法供内部执行;对企业只输出下面规定的报告内容、依据和必要操作。用户要求局部或更详细时按其要求展开。 ## 获取必要信息 缺少基本信息时,使用简短入口: > 请告诉我:企业名称、主要业务、客户与地区、这次最想解决的问题,以及已有的 GEO 尝试和结果。没做过就写“未做过”;官网、产品资料或客户反馈,有就附上。 > > 我会先分析行业竞争和客户购买逻辑,再判断 GEO 对你的价值、适合的场景与投入方式。 已有信息直接使用,只补问一至三个会改变判断的问题,不要求先备齐报表。主体有歧义时核对全称、地区或官网;搜不到不代表确认了主体。出现下列任一情况,先停下来用一句话向用户确认主体(全称与官网),确认后再写:用户给的名称与某个知名品牌同音或近似;公开检索找不到官网或主体,事实全部来自第三方平台;检索到的主体、地区或业务与用户描述对不上。无法互动时,把“本报告按【主体全称】撰写,若你指的是另一家请告知”写在报告最前面,且所有品牌事实标“待核对”。 保留企业指定的业务、目标、地区、产品与模型。首次尝试分析机会,做过动作但结果不清则区分已知与未知,已有 AI 获客则分析延续与扩大条件,稳定运行则比较维持、改善和新机会。没记录不等于没效果,现有成功不证明新增动作也有效;多业务企业不能因另一业务资料多或客单价高就擅自换重点。 ## 研究与执行顺序 先用企业资料形成待核对的经营问题,再联网研究客户购买、真实对手与替代方案。通常核对三至五个可比对手,资料不足不凑数。须检索排行、推荐、对比及批量营销稿痕迹;找到时查看代表性材料,解释其试图影响哪项客户选择。未找到则说明检索范围,不据此认定没有营销动作。 按本轮需要读取参考段落,不默认重读所有文件: | 需要解决的问题 | 参考材料 | |---|---| | 分析停留在行业标签,缺少因果与取舍 | [深度分析方法](references/first-principles-analysis.md) | | 客户研究、竞争范围或营销证据不清楚 | [行业与竞争研究](references/competition-research.md) | | 多角色购买、业务场景与五类问题难以区分 | [客户路径与场景选择](references/funnel-and-scenarios.md) | | 需要组织第四部分的场景选择、第五部分的实测操作或模型条件 | [投入规划与实测操作](references/planning-and-handoff.md) | | 写第六部分与最终结论的“下一步”:路线范围、每步过关标准、生态工具清单 | [十环路线与生态交接](references/ten-ring-handoff.md),写第六部分前必读;模型图用 `assets/ten-steps.svg` | | 写第六部分每一步的要点:每步读者看到的形态、知识库与本体的推荐、实测限额与节奏、载体与内容技能、模型与生态、归因三态 | [十步打法手册](references/ten-step-playbook.md),写第四块前必读 | | 生成默认单页 HTML、设置金句和快速排版 | [HTML 输出规范](references/html-report.md),开始组织成品时读一次;优先直接调用 `scripts/render_report.py` 复用 `assets/report-template.html` | | 需要校准成品的深度、标题和表达 | [企业报告示例](references/report-example.md) | 复用本轮已核对的材料;仅对冲突、变化或影响决定的未知补查。宿主支持时并行独立检索。重要判断已有足够依据、反例与边界,继续搜索不太可能改变决定时停止;不为每个维度凑资料或按来源数量验收。保留必要核验,不承诺固定运行分钟数。 默认交付一份可直接打开、连续滚动的单文件 HTML,保留总标题、六部分完整分析、最终结论、数据与来源。用户明确指定其他格式时按其要求。页面分模块,不做幻灯片分页;正文和关键依据默认全部展开。复用 `assets/report-template.html` 的暖白正文、米色左侧导航、细分隔线、橙色导航高亮和绿色金句样式,保留其中的技能作者与版本署名;该署名不代表报告所分析企业的身份。外部样式参考中的课程内容、人物身份、二维码或企业事实不移植到报告。 生成 HTML 前读一次 [HTML 输出规范](references/html-report.md)。有 Python 3.9+ 时,模型只写一份完整正文,用 `python3 scripts/render_report.py report.md -o 企业GEO分析.html` 一次排版;脚本路径按实际安装目录定位,不需要读取模板或脚本全文,不安装依赖。无法执行脚本时直接复用模板写 HTML,不要求先写 Markdown。只有本文件时也能生成轻量 HTML:内嵌短 CSS、系统字体、自然高度、单列正文、可滚动宽表与可选取的五题,无在线资源依赖。宿主不能创建 HTML 文件时,明确说明并先给完整可读内容,不交付大段源码代替报告。 同一套核对后的内容只写一次,不为美化重复研究、重写分析或生成前端项目;不用外部字体、图表库、图片生成、动画和编译构建。正文优先将已有依据的角色关系、客户路径、收入成本、重点客群、操作顺序与十步路线画成轻量图示,图示不替代完整分析或删减原表。可用 `geo-cards`、`geo-flow`、`geo-funnel`、`geo-route` 数据块,无数据时不画比例。左侧目录按章节、小节与展开步骤跳转,手机提供目录按钮。图表优先静态 HTML/CSS 或现有 SVG;目录、阅读进度、复制与打印可有少量增强脚本,关闭脚本仍能读全文。除非用户要求,不额外生成 PDF、截图版或多个主题。排版提速不能删分析、五题、十步说明、依据和成立条件,也不承诺整份报告固定用时。 ## 证据与判断边界 - 企业陈述可以作为注明来源的工作前提;只有核验过才称“已核验”。区分企业自述、推广稿与独立证据,转载去重。引用紧跟所支持的判断,保留原文链接、可确认日期和查阅日期。报告末尾必须有一节“数据与来源”:正文里出现的每一个数字、政策变化、他人陈述(如“前员工称”“加盟商反映”)都要能对应到一条来源,写来源名、日期、可点击链接和口径标签(官方/监管、主流媒体或财报、行业数据机构、招商平台或自媒体、品牌方口径、用户反馈);对不上来源的数字删掉或改成“待核对”。来源分级使用:官方与监管、主流媒体与财报可作事实依据;招商平台、自媒体、短视频招商内容只能作为营销痕迹或口径冲突的证据,不能作为费用、门店数、回本周期的依据。 - 数字先核对业务、型号或套餐、时期、条件及范围。报告编号不代替报告内容;面积、资质、公开案例不证明容量、交付质量、利润或转化率。零散评论能发现客户疑问,不能据此给整个行业的选择标准排序。 - 行业重视信任不证明本企业因不被信任而失单;有咨询也不证明合适客户充足。比较有依据且会改变投入的解释,未知写清核对什么。企业事实、经营假设与未知在开头、场景选择、行动和结论中保持同一确定程度。 - 公开资料多少、榜单出现或没有找到企业,不证明目标 AI 当前提及、遗漏、误解或低可见性;营销痕迹不证明企业委托、付费、做过 GEO 或有效果。客户用 AI 学习不等于用 AI 采购,跨平台问题不证明 AI 内需求规模。 - 不编模型偏好、引用权重、软文降权、内部核验机制或生效期。网页检索、平台调用与已有知识可能并用;无引用不能证明未检索。不得把真实采访人物续写为购买本企业的客户,经营推演用明确的匿名假设,不生成目标模型的模拟答案。 ## 面向企业的表达 称企业名称或“你们”,其客户用具体身份,如学员、家长、采购或使用者。让负责人看懂自己的问题、依据与选择,不写“用户确认”“用户未指定”“本报告未编造”等作者说明。缺数据时直接说还缺什么、影响哪项决定;不反复宣告方法边界。 报告使用一个总标题、六个主体标题和末尾“最终结论”;子标题仅在内容确需分组时使用,直接概括业务含义,不使用 1.1、4.2 等多层编号。标题、表格与正文均不用 S1、S3 等场景代码替代客户名称;问题可用“问题1”至“问题5”编号。 | 内部工作用语,不得作为成品标题或代称 | 对企业的表达方式 | |---|---| | 候选场景与五维比较 | 优先帮助哪些客户完成购买 | | 本轮目标句、具体目标句 | 本次 GEO 要改善什么业务结果 | | 通用交接、字段映射 | 实测后需要保存什么 | | 实体层、关系层、证据层 | 需要准备的企业、产品与服务资料 | | 逐项推导、四列表、不做伪精确 ROI | 直接写本段的业务内容,如“投入成本与判断依据” | | G1–G10 门禁、意图簇、本体 schema 等内部代号 | 对企业统一叫“第 N 步 · 名称”;“十环”是内部与开源生态里的叫法,报告里只在说明与开源体系的关系时出现(如页脚一句);过关条件写成“过关标准” | **模块金句与可读性。** 六个主体章节、最终结论和数据来源,每个模块开头都有一句突出显示的核心金句;独立展开的十步要点也各有一句,可由该步骤的结论式标题承接。金句总结本企业该章最重要的判断与价值,让负责人一眼知道为什么值得看下去,不能只是介绍“本章将讲什么”。通常一到两句,保留会影响决定的条件,不把未知写成确定结果。之后用充分的事实、因果、取舍和行动含义展开。每章不能只剩金句和几张短卡片。 对企业写“客户问题组”而不是“意图簇”,“内容任务说明”而不是 Brief,“先做/配合/后续”而不是 P0/P1/P2。十步的正式名称保留对应关系,首次配一句大白话;后文优先用普通话。金句、表格标题、图注都适用,不只修改正文。第六部分金句放在十步图之前,不改变后面五块的顺序与完整内容。 **信息完整性。** 内容自然延长,不以页数、屏数、卡片等高或装饰性留白为目标;不能删去关键依据、数字口径、反向情况、选项比较、成立条件、操作步骤、负责人、完成标准与来源。段落按意思分组,表格保留全部行列,关键正文不能折叠隐藏、定高裁切或缩小字号。 这些表达是示范,替换为本企业的具体内容。一个子标题必须能在不读正文时让负责人知道要解释什么。“开场”“找到战场”等工作标签或隐喻不能替代内容概括。必要术语首次用一句普通话解释。 ## 六部分报告 总标题为“【企业名称】GEO第一性原理分析”,替换后不保留方括号。标题下用简短背景交代企业、目标与已有进展,再给一段有依据的核心判断,不重复企业百科或另设开场章节。首次简要解释:GEO(生成式引擎优化)关注内容在生成式 AI 回答中的可见性;本报告进一步判断,这能否帮助客户发现、理解和核验企业的真实价值,影响其选择并带来经营价值。 ### 一、【行业】的第一性原理:客户需求与竞争格局 解释谁使用、付款和决定,因为什么需求愿意付钱,为什么不用现有办法或替代方案。把影响选择的价格、时间、学习、迁移与失败代价连起来;展开一组具体购买取舍及条件变化后的不同选择,不能从“买效果”“缺信任”直接跳到做法。 讲清企业如何创造价值、怎样获得可持续收益。流量依赖解释需要多少、什么样的新客户;信任验证解释付款前要确认什么;决策复杂度解释哪些角色共同完成判断。三者可以并存,不将企业分成互斥类型,也不由高客单、长链路直接推出 GEO 适合。 比较对手的真实适配与交付差异,解释相关行业变化如何影响需求、选择和利润。用必要段落及一张简明竞争表写清对手为何可比、公开营销动作、来源日期及对企业的含义;相关信息可合并列,具体方案取舍已讲清就不另铺大型参数表。榜单与批量软文是研究证据的一部分,不能代替行业分析。本节归结生意靠什么增长、客户凭什么选择。 ### 二、【企业】的获客与成交漏斗 先解释漏斗是把客户从了解到购买分层,看每一步为何继续或停下。沿已确认渠道呈现路径;能实际渲染时画短阶段名的漏斗,图外解释判断,否则用阶段表。没有同客群、时期和阶段口径的数据,只标结构示意,不编宽度、人数或转化率。HTML 中可嵌入 SVG 等图表,交付时应呈现图表或可打开的文件。 使用“购买阶段|客户要完成的判断|现有渠道如何帮助|AI 可能参与及成立条件”连接业务。只保留一套完整阶段说明,正文重点解释关键退出原因、多角色确认、复购或转介绍的作用,不逐行复述表格。 结合企业目标判断当前值得改善或扩大的机会:合适客户不足、购买理由难以理解或核验、决策需要协调,还是产品、价格、服务与容量受限?区分有能力但客户难确认,与能力本身不适合;有多个合理解释则保留差异。给出当前优先项、依据和最有价值的核对点,不能先宣布唯一瓶颈再补免责声明。 ### 三、【企业】做 GEO 的价值与适用性 用前文一项具体客户需求贯穿推导:客户原来怎样判断,若借助 AI 哪项信息工作可能变化,企业的真实差异怎样影响下一步,以及这项改变是否值得投入。关键时补一项反向情形,不再拆成多组内容相同的假设、逐项解释与案例。 必须讲清四项关系:真实客户判断 → AI 参与的行为依据或成立条件 → 企业真实适配可能改变的行动 → 承接能力、收益与新增成本。回答:“假设 AI 明天已经准确介绍你的企业,能改变谁的什么决定,对生意有什么价值?”只说更多曝光或信息准确,尚未完成论证。也考虑替代品更易发现、比价加剧或差异被简化的可能。 将提及引用、客户选择变化和咨询成交等经营结果区分。企业能改善信息、体验与承接,不能靠表达创造产品能力。转介绍、招投标或平台内交易不构成行业硬排除;逐段判断实际作用。 与企业真实可选的资源去向比较,明确开始、扩大、改善、维持、有限确认机会或暂缓,并附范围、理由和改变决定的条件。新增贡献要区别自然 AI 来客、其他渠道共同作用与渠道迁移;收入不等于利润。有限确认应指向客户行为或经营条件,不能等同于问完五题。 ### 四、【企业】的 GEO 重点场景与目标 先选择值得支持的具体客户情境:谁在什么情况下、购买进行到哪里、围绕哪项产品服务解决什么,希望帮助其完成什么动作。按真实业务起简短名称,后文直接使用;模拟细节明示为假设。 内部综合业务价值、真实需求、AI 可影响、企业真实差异、转化承接五方面,以及现有可用基础与补齐代价。对外做一次候选比较,说明优先哪项、相对其他候选为什么值得、还缺什么条件即可;不要求将五维表、资源表、主次说明各写一遍,不打无依据分数。 已确认不适配或不能承接且本轮无法补齐,可暂缓;未知保留为候选或优先核对,不等于没有需求。资料丰富不等于业务价值高,资料少不强制先建官网。选择须承接第三部分,暂缓时可以没有当前主攻。 区分业务场景与五类客户问题,并用本企业语言说明主次: | 问题类型 | 客户在判断什么 | |---|---| | 品牌验证类 | 听说这家企业后,确认是否可靠、是否适合 | | 品类需求类 | 有需求,寻找适合的办法或企业 | | 竞品对比类 | 比较已有候选的差异与适配 | | 交付使用与售后类 | 怎样购买、使用、交付,问题如何处理 | | 行业认知与科普类 | 理解问题,形成需求或选择标准 | 在优先情境中给出相应问题与理由;五类不必同等投入,售后也会影响首次购买,科普也会影响是否购买。第四部分说明问题方向,第五部分才列完整实测题,避免重复整套提问。 结尾用企业语言说清:帮助哪类客户完成什么判断,推动哪项业务行动,通过已有的什么记录观察变化。缺少相关字段时说明待补,不编现有 CRM,不要求先建系统,也不把有记录写成有因果归因。 ### 五、到 AI 中实测这五个问题,了解客户目前会看到什么 先直接邀请企业亲自测试,说明用途。可采用: > 建议把下面五个问题分别复制到准备关注的 AI 产品中,看看客户现在可能得到什么回答。优先使用你们已指定或客户正在使用的平台;暂时不清楚,可以先选一个平台开始。 先给操作,再给问题。操作必须能让新用户照着完成: 1. 打开选定的 AI 产品,记下日期、产品名称、界面显示的模式,以及是否开启联网搜索;没有显示的写“未显示”,不要猜测。 2. 每题新建一段对话,只复制该题,不提前上传本报告或企业介绍;如保留了会影响回答的历史背景,另行记下。 3. 保存完整回答或截图,以及可见的来源链接;没有链接如实注明,保留实际出现的文字、图片、视频或商品入口。 4. 将五次记录放在同一份文档中,按产品、日期和设置分组,便于后续核对。换产品或设置时另存一组,不覆盖原记录。 保留企业指定产品,不强制多模型;未知时可举豆包、DeepSeek、元宝、千问作为候选,不断言哪家最常用。不要编各应用的按钮路径。专业用户通过 API 留记录时,与实际用户界面记录分开。 给恰好五道可复制题,按第四部分主次分配,不必五类各一题。优先采用实际客户语言,无原话则统一说明为模拟问法。每题一项主要疑问,保留必要专业词、地区、预算或规格;不把整套审核清单塞进一道题,不为凑场景编条件。发现题不预置品牌,核验与已有候选对比可带品牌。 题头用“问题1|客户容易理解的疑问短名”,下面放完整问题引用块,再用短行说明问题类型;只有涉及不同情境时补具体客户名称。问题名称应表达业务含义,例README.md14 KBea76a82b456dupstream ↗
# GEO第一性原理 **先讲清客户为什么买,再判断 GEO 是否值得做、值在哪里。** 作者:allenlion · 版本:1.1 · 许可证:[MIT](LICENSE) 面向企业负责人、营销负责人和企业服务团队的经营分析 Skill。从行业竞争、客户购买与企业增长出发,判断 AI 能改变哪项选择、带来什么业务价值,以及当前最值得的投入方式。 GEO(Generative Engine Optimization,生成式引擎优化)关注内容在生成式 AI 回答中的可见性,概念可参见 [GEO 原始论文](https://arxiv.org/abs/2311.09735)。本 Skill 从经营角度进一步分析:这种呈现能否帮助客户发现、理解和核验企业的真实价值,影响选择并带来业务改善。 这里的“第一性原理”,是从客户任务、交易条件与企业收益出发推导投入必要性。分析不预设每家企业都适合 GEO,结论可以是开始、扩大、改善、维持、小范围确认机会或暂缓。 本 Skill 是 **GEO 十环开源体系的第 0 环**。十环是从事实本体出发、以效果归因收口、再回流本体的一条闭环:事实本体 → 业务目标 → 用户意图 → 基线检测 → 策略形成 → 内容制作 → 信源管理发布 → 持续监测 → 效果归因 → 回流本体。本 Skill 负责判断值不值得做、从哪一环开始;报告的最后一部分会把决定落成一条按环推进的路线,写明每环的动作、负责人、产出与过关标准,并标注哪些企业自己能完成、哪些对应后续开源的工具或模板。工具清单与状态见 `references/ten-ring-handoff.md`,随各环工具发布逐步更新。 ## 你会得到什么 默认得到一份带左侧分级导航、可直接打开的单页 HTML:六部分完整分析、醒目的章节金句、五个可复制问题、十步路线与行动安排,以及最终结论和数据来源。页面连续滚动,正文全部展开;用户明确指定其他格式时按其要求。 1. **行业的第一性原理:客户需求与竞争格局**:客户为何付钱、企业靠什么增长、竞争优势在什么条件下成立。 2. **企业的获客与成交漏斗**:客户怎样了解、比较与购买,现有渠道怎样帮助,当前最值得改善什么。 3. **企业做 GEO 的价值与适用性**:AI 可能改变谁的什么决定,企业能否接住,这项改变是否值得投入。 4. **企业的 GEO 重点场景与目标**:比较现实机会,选择优先帮助的客户、关键判断与业务行动。 5. **到 AI 中实测这五个问题,了解客户目前会看到什么**:提供五个可复制问题、具体操作与简短记录表。 6. **企业的 GEO 布局与投入建议**:按 GEO 十环把决定落成有先后的路线。范围随决定取舍——暂缓只做事实一页纸,有限确认走到基线检测,开始走到信源发布并定下监测、归因与回流的节奏;范围内每环写清动作、负责人、产出、过关标准,以及自己做、开源工具或付费能力。附一张三十天路线表,每条都是企业不采购任何东西就能完成的事。 结尾按**最终判断、生意本质、GEO 的价值、最值得的做法、投入取舍、下一步**形成独立可读的决定;“下一步”是三十天内的前三件事、从第几环开始、什么时候回来重看。 正文和结论都不设最低字数。深度来自解释购买条件、竞争取舍和经营后果;每个判断在合适的位置讲透一次,保留必要依据,减少重复。标题使用能直接理解的业务语言,场景使用客户或需求名称。 流量依赖、信任验证和决策复杂度可以同时存在。需要信任不等于企业缺乏信任,流程复杂也不自动证明适合 GEO。分析会追问:假设 AI 已准确介绍你的企业,能改变哪类客户的什么决定,对生意有什么价值? 首次尝试分析机会;已有 AI 获客则判断怎样延续和扩大;稳定运行则比较维持、改善和新机会。公开资料少不会自动被认定为没有需求,资料多也不代表 GEO 已有效。暂缓时会说明资源优先去向和重新考虑条件。 ## 1.1 的阅读与速度升级 - 每个主模块都有核心金句,先点明该章对企业的价值,展开的步骤也有通俗要点。 - 六部分分析、五题、十步完整介绍、本企业路线、负责人、完成标准与来源均保留;不为等高卡片、屏数或美观删掉信息。 - 暖白正文、米色左侧导航和柔和重点块,连续滚动;章节与十步可直接跳转,手机目录可展开,五题支持复制,宽表保留全部列。 - 通过客户路径、并列卡片、数字口径和操作步骤图帮助阅读,完整正文与来源全部展开。没有数据不画比例,不为可视化删减关键内容。 - HTML 模板预先准备,模型不用每次重写样式。随包的可选 `scripts/render_report.py` 只读本地正文并生成 HTML,使用 Python 3.9+ 标准库,无联网、无安装依赖;不会执行模型诊断。没有代码执行能力的应用直接复用模板。 - 网页不依赖外部字体、在线脚本或图片生成;关闭脚本仍可阅读全文。速度优化针对排版工作,完整研究和写作时间仍由模型与检索情况决定。 安装时使用完整技能目录;需要固定本版时,下载下方的 1.1 安装包。 ## 快速安装 把下面这句话发给具备联网、文件读写和技能安装能力的 Agent: > 帮我安装 GEO第一性原理: https://github.com/ALLENLION35/geo-first-principles 。请阅读仓库 README,按照当前应用支持的方式安装完整技能目录,安装后确认能找到 geo-first-principles。 首次安装建议附上仓库地址。只说“帮我安装 GEO第一性原理”是否能找到本项目,取决于应用的搜索与索引;仅能聊天的应用请使用下方的文件加载方式。 - [下载 1.1 技能安装包](https://github.com/ALLENLION35/geo-first-principles/releases/download/v1.1/geo-first-principles-1.1.zip) - [查看 1.1 发布页](https://github.com/ALLENLION35/geo-first-principles/releases/tag/v1.1) ## 开始使用 加载后直接输入: > 使用 GEO第一性原理。企业名称:……;主要业务:……;客户与地区:……;这次最想解决的问题:……;已有 GEO 尝试和结果:……。 官网、产品资料、客户反馈和已有记录,有就附上。无需先准备完整报表,只补问真正影响判断的信息。可以指定关注的 AI 产品,也可以要求只分析某一业务或提供更详细的说明。 ## 五题怎样实测 报告会先告诉你怎样操作:打开选定的 AI 产品,每题新建对话、只复制该问题;记录日期、产品、模式和联网设置;保存完整回答或截图及可见来源,并按平台与日期归在同一文档中。 五题从优先业务需要中选出,涉及品牌验证、品类需求、竞品对比、交付使用与售后、行业认知与科普,不要求每类各一题。每题聚焦一项主要疑问。 Skill 提供问题与操作,不自动运行测试或分析实测回答效果。记录用于了解当时客户可能看到什么;五题表现不能直接证明获客效果、需求规模或投资回报。后续布局可参考实际来源和呈现形式,投入仍要结合客户行为、贡献、成本与承接能力判断。 五题在十环路线里有明确位置:问题进入第 3 环的客户问题清单(标注来源),回答作为第 4 环的首次小样本观察。要报“提到的比例”一类数字,同一套问题需要在同一产品上反复抽样,这是监测类工具的事,报告会如实说明,不用五次结果冒充比例。 ## 安装与跨平台使用 本项目按 [Agent Skills 格式](https://agentskills.io/specification)组织。发布包的技能目录为 `geo-first-principles`,核心指令文件为 `SKILL.md`;指令采用 Markdown 不代表报告只能输出 Markdown。 | 使用环境 | 操作方式 | |---|---| | Codex | 将上方安装指令与仓库地址发给 Codex,或使用下方命令行安装并选择 Codex | | Claude Code | 将上方安装指令与仓库地址发给 Claude Code,或使用下方命令行安装并选择 Claude Code | | Claude 聊天版 | 在 Customize → Skills → + Create skill → Upload a skill 上传完整 ZIP;需开启代码执行与文件创建,组织账号还受管理员设置影响。参见 [Claude 官方说明](https://support.claude.com/en/articles/12512180-use-skills-in-claude) | | WorkBuddy | 在“技能”中点击“添加技能”,导入本地技能包;以当前客户端接受的文件类型为准,也可把仓库地址交给 Agent 安装。参见 [WorkBuddy 官方说明](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Skills-Market) | | 豆包 | 普通聊天中先上传 `SKILL.md` 与所需 `references` 文件,并明确要求按照附件执行;如所用版本提供 Skills 管理,则按该版本说明导入,不把普通聊天的附件加载称作原生安装 | | 只能输入文本的聊天应用 | 粘贴 `SKILL.md` 中 YAML 头部之后的正文,再提供企业信息;需要参考资料时继续提供对应文件内容 | 上传或粘贴属于在对话中加载指令,不等于原生安装;跨对话保留取决于应用。格式兼容不等于所有客户端均已验证,检索、文件生成和呈现效果也取决于应用能力。核心流程不要求指定模型的 API 密钥、付费接口或插件。 使用 [skills CLI](https://github.com/vercel-labs/skills) 从 GitHub 安装: ```bash npx skills add ALLENLION35/geo-first-principles --skill geo-first-principles ``` 需要先查看安装器是否识别到技能,可以只列出技能而不安装: ```bash npx skills add ALLENLION35/geo-first-principles --list ``` 也可以解压安装包,在 `geo-first-principles` 的上一级执行: ```bash npx skills add ./geo-first-principles --skill geo-first-principles ``` 按提示选择目标 Agent。命令默认安装到当前项目;需要跨项目使用时添加 `--global`。此方式需要 Node.js、npm 和安装器所需网络,也可以使用应用自带的导入方式。 明确安装到 Codex 或 Claude Code 的个人技能目录时,可分别执行: ```bash npx skills add ALLENLION35/geo-first-principles --skill geo-first-principles --agent codex --global npx skills add ALLENLION35/geo-first-principles --skill geo-first-principles --agent claude-code --global ``` 这些命令的参数以 [skills CLI 官方说明](https://github.com/vercel-labs/skills)为依据。只执行自己需要的平台对应命令;安装完成后,重新打开会话并请求使用 GEO第一性原理。 ## 文件与运行方式 | 文件 | 用途 | |---|---| | `SKILL.md` | 核心推导、六部分报告、企业表达与交付边界 | | `references/first-principles-analysis.md` | 行业经济关系、购买取舍与适用性分析 | | `references/competition-research.md` | 客户研究、真实竞品与营销痕迹核对 | | `references/funnel-and-scenarios.md` | 客户路径、业务场景与五类问题 | | `references/planning-and-handoff.md` | 场景选择、实测操作、记录与模型条件 | | `references/ten-ring-handoff.md` | 十环路线:决定与路线范围、每环的过关标准、三十天表、开源生态工具清单 | | `references/html-report.md` | 单页 HTML、章节金句、完整性和快速生成规则 | | `assets/report-template.html` | 可复用的单页模板与内嵌样式 | | `scripts/render_report.py` | 可选本地渲染器;不联网,不安装依赖 | | `tests/test_render_report.py` | 标准库回归测试:示例结构、分级目录、可视化、代码块、链接与输入校验 | | `references/ten-step-playbook.md` | 十步的详细动作与成品形态 | | `assets/ten-steps.svg`、`assets/feedback-wechat-qr.jpg` | 备用路线图和交流图片 | | `references/report-example.md` | 基于虚构材料的完整企业报告示例 | | `agents/openai.yaml`、`assets/icon.svg` | 支持元数据的应用中的入口与图标 | | `LICENSE` | MIT 许可全文 | | `RELEASE_NOTES.md` | 1.1 发布说明 | 参考文件按需读取,主文件包含完整核心流程。复用已核对的研究,只对影响判断的未知或变化补查,减少重复搜索、读取和生成。运行时间仍取决于宿主模型、检索和输出,不承诺固定分钟数。 竞争研究需要联网能力;无法联网时基于已有材料分析,并说明待核对的竞争信息。无法绘图时用阶段表。报告默认是单页 HTML;能执行脚本时只生成一次完整正文并复用模板,不能执行时直接生成 HTML;多种版本使用同一套分析,保持事实、引用、五题与结论一致。 Skill 不承诺推荐、排名、收录或成交,不自动公开发布内容或付费。联网检索只使用必要的公开信息,未获授权的非公开企业资料不得提交给外部服务。模型与工具的数据处理遵循所在应用的设置与规则。 维护者可在技能目录中运行本地检查,无需安装第三方依赖: ```bash python3 -B -m unittest discover -s tests -v python3 -B scripts/render_report.py --example -o preview.html ``` ## 版本记录 - **1.1**:默认交付完整单页 HTML,新增章节金句、通俗表达与轻量渲染路径;第六部分按 GEO 十步给出行动路线、负责人、三十天安排和过关标准;最终结论新增“下一步”,五题衔接问题清单与首次观察。新增十步手册、生态工具清单、HTML 规范、模板与本地渲染器;保留六部分分析、五题实测与原有经营判断边界。 - **1.0**:首个公开版本。 ## 开源使用与贡献 采用 [MIT 许可证](LICENSE)。使用、修改和分发时保留版权及许可声明。 欢迎提交能复现问题的反馈:业务目标、必要输入、模型与模式、实际输出和具体偏差。请先去除客户隐私、账号凭据和未获授权的企业资料。改进应形成通用判断方法,避免将单个品牌的情况固定为所有企业的答案。 ## 交流与反馈群 欢迎交流使用心得、提出问题与改进建议。扫码添加微信,申请加入交流与反馈群。 <img src="assets/feedback-wechat-qr.jpg" alt="交流与反馈群:扫码添加微信,申请入群" width="320" /> X 主页:[allenlion · @ALLENLION35](https://x.com/ALLENLION35)scripts/render_report.py16 KB4c0627b1984bupstream ↗
#!/usr/bin/env python3 """Render a GEO report locally. Python standard library; no network or installs. Supported input: headings, paragraphs, lists, tables, links, emphasis, quotes, code fences, and geo-route / geo-funnel / geo-cards / geo-flow blocks. Raw HTML is displayed as text. Analysis and factual validation remain the author's job. """ import argparse import html import json import re import time from pathlib import Path from urllib.parse import urlsplit ROOT = Path(__file__).resolve().parents[1] TEMPLATE = ROOT / "assets" / "report-template.html" STEP_NAMES = ["事实本体", "业务目标", "用户意图", "基线检测", "策略形成", "内容制作", "信源管理发布", "持续监测", "效果归因", "回流本体"] STEP_GISTS = ["把企业资料说清楚", "定下业务结果", "收集客户真正的问题", "记录 AI 当前回答", "据实测选择做法", "把事实写成内容", "发布并登记出处", "定期看回答变化", "核对咨询和成交", "更新企业资料"] TOKEN = re.compile(r"\[([^\]\n]+)\]\(((?:[^()\s]|\([^()]*\))*)\)|`([^`\n]+)`|\*\*(.+?)\*\*|\*([^*\n]+)\*|<br\s*/?>", re.I) HEADING = re.compile(r"^(#{1,6})\s+(.+?)\s*$") LIST = re.compile(r"^(\s*)([-+*]|\d+[.)])\s+(.*)$") def plain(value): return re.sub(r"[*`]+", "", value) def slug(value): value = re.sub(r"[^\w\s-]", "", plain(value).lower()) return re.sub(r"\s+", "-", value.strip()) or "section" def inline(value): result, position = [], 0 for m in TOKEN.finditer(value): result.append(html.escape(value[position:m.start()])) label, url, code, bold, italic = m.groups() if label is not None: try: valid = url.startswith("#") or urlsplit(url).scheme.lower() in ("http", "https", "mailto") except ValueError: valid = False result.append('<a href="' + html.escape(url, quote=True) + '">' + inline(label) + '</a>' if valid else inline(label)) elif code is not None: result.append("<code>" + html.escape(code) + "</code>") elif bold is not None: result.append("<strong>" + inline(bold) + "</strong>") elif italic is not None: result.append("<em>" + inline(italic) + "</em>") else: result.append("<br>") position = m.end() result.append(html.escape(value[position:])) return "".join(result) def cells(line): return [x.strip().replace(r"\|", "|") for x in re.split(r"(?<!\\)\|", line.strip().strip("|"))] def table_start(lines, i): return i + 1 < len(lines) and "|" in lines[i] and all( re.fullmatch(r":?-{3,}:?", x.replace(" ", "")) for x in cells(lines[i + 1])) def diagram(kind, content): data = json.loads(content) if kind in ("geo-cards", "geo-flow"): return visual(kind, data) if kind == "geo-funnel": rows = [] for index, stage in enumerate(data, 1): rows.append('<li><b>' + str(index) + " · " + html.escape(stage["label"]) + '</b><span>' + html.escape(stage.get("note", "")) + '</span></li>') return '<ol class="funnel">' + "".join(rows) + '</ol><p class="route-caption">客户路径示意;图形大小不代表人数或转化率。</p>' states = {} for key in ("active", "conditional", "rhythm"): for number in data.get(key, []): if type(number) is not int or not 1 <= number <= 10 or number in states: raise ValueError("十步路线的步骤必须是 1–10,且每步只设一种状态") states[number] = key start = data.get("start") if start is not None and (type(start) is not int or not 1 <= start <= 10): raise ValueError("路线起点须为 1–10 或 null") labels = {"active": "本轮要做", "conditional": data.get("condition_label", "满足条件后启动"), "rhythm": "本轮只定节奏", "": "本轮暂不安排"} rows = [] for n, (name, gist) in enumerate(zip(STEP_NAMES, STEP_GISTS), 1): state = states.get(n, "") css = state + (" start" if n == start else "") rows.append('<li class="' + css + '"><span class="step-num">第 ' + str(n) + ' 步' + (' · 起点' if n == start else '') + '</span><b>' + name + '</b><small>' + gist + '</small><small>' + html.escape(labels[state]) + '</small></li>') return '<ol class="route" aria-label="GEO 落地十步及本轮安排">' + "".join(rows) + '</ol><p class="route-caption">按编号推进:第 1–5 步准备与测量,第 6–10 步执行与验证;第 10 步更新资料,回到第 1 步。</p>' def visual(kind, data): if not isinstance(data, dict) or not isinstance(data.get("title"), str): raise ValueError("可视化须有文字标题 title") items = data.get("items") if not isinstance(items, list) or not items: raise ValueError("可视化 items 须为非空列表") note = data.get("note", "") if not isinstance(note, str): raise ValueError("可视化 note 须为文字,可注明来源与条件") flow = kind == "geo-flow" tag, item_class = ("li", "visual-stage") if flow else ("article", "visual-tile") rows = [] for item in items: if not isinstance(item, dict) or any(not isinstance(item.get(k), str) for k in ("label", "text")): raise ValueError("每项可视化须保留文字 label 与 text") value = item.get("value", "") if not isinstance(value, str): raise ValueError("可视化 value 须为文字,保留数字单位与口径") metric = '<strong class="visual-value">' + inline(value) + '</strong>' if value else '' rows.append('<' + tag + ' class="' + item_class + '"><span class="visual-label">' + inline(item['label']) + '</span>' + metric + '<p class="visual-body">' + inline(item['text']) + '</p></' + tag + '>') grid = '<ol class="visual-flow-track">' if flow else '<div class="visual-grid">' close = '</ol>' if flow else '</div>' caption = '<p class="visual-note">' + inline(note) + '</p>' if note else '' return '<figure class="visual ' + ('visual-flow' if flow else 'visual-cards') + '"><figcaption>' + inline(data['title']) + '</figcaption>' + grid + ''.join(rows) + close + caption + '</figure>' def blocks(source, heading_id=slug): lines = source.splitlines() out, i, question, gold_count = [], 0, False, 0 while i < len(lines): line = lines[i].strip() if not line: i += 1 continue h = HEADING.match(line) if h: level = len(h[1]) out.append(f'<h{level} id="{html.escape(heading_id(h[2]), quote=True)}">{inline(h[2])}</h{level}>') i += 1 elif line.startswith("```"): kind = line[3:].strip() i += 1 code = [] while i < len(lines) and not lines[i].strip().startswith("```"): code.append(lines[i]) i += 1 if i == len(lines): raise ValueError("代码块缺少结束标记") i += 1 text = "\n".join(code) out.append(diagram(kind, text) if kind in ("geo-route", "geo-funnel", "geo-cards", "geo-flow") else '<pre><code>' + html.escape(text) + '</code></pre>') elif table_start(lines, i): header = cells(lines[i]) i += 2 body = [] while i < len(lines) and "|" in lines[i] and lines[i].strip(): row = cells(lines[i]) if len(row) != len(header): raise ValueError(f"表格第 {i + 1} 行的列数与表头不一致") body.append('<tr>' + ''.join('<td>' + inline(x) + '</td>' for x in row) + '</tr>') i += 1 cls = ' class="wide"' if len(header) > 4 else '' out.append('<div class="table-wrap" tabindex="0" role="region" aria-label="可横向滚动的完整表格"><div class="table-hint">屏幕较窄时,可左右滑动查看全部列</div><table' + cls + '><thead><tr>' + ''.join('<th scope="col">' + inline(x) + '</th>' for x in header) + '</tr></thead><tbody>' + ''.join(body) + '</tbody></table></div>') elif line.startswith(">"): quote = [] while i < len(lines) and lines[i].lstrip().startswith(">"): quote.append(re.sub(r"^\s*> ?", "", lines[i])) i += 1 text = "\n".join(quote).strip() gold = re.match(r"^\*\*(?:本章金句|核心金句|金句|一句话判断)\*\*\s*[::]?\s*(.+)", text, re.S) if gold: compact = " compact" if gold_count else "" gold_count += 1 out.append('<blockquote class="takeaway' + compact + '"><span class="label">核心判断</span><p>' + inline(gold[1]) + '</p></blockquote>') elif question: out.append('<blockquote class="question"><span class="question-label">复制这一题,单独新建对话</span><p class="question-text">' + inline(text) + '</p><button class="copy" type="button">复制问题</button><span class="copy-status" role="status" aria-live="polite"></span></blockquote>') question = False else: out.append('<blockquote>' + blocks(text, heading_id) + '</blockquote>') elif re.fullmatch(r"[-*_]{3,}", line): out.append('<hr>') i += 1 elif LIST.match(lines[i]): first = LIST.match(lines[i]) base = len(first[1]) ordered = first[2][0].isdigit() items = [] while i < len(lines): m = LIST.match(lines[i]) if not m or len(m[1]) != base or m[2][0].isdigit() != ordered: break content = [m[3]] i += 1 while i < len(lines): following = LIST.match(lines[i]) if lines[i].strip() and len(lines[i]) - len(lines[i].lstrip()) > base: content.append(lines[i][base + 2:]) i += 1 elif not lines[i].strip() and i + 1 < len(lines) and LIST.match(lines[i + 1]): i += 1 break else: break items.append('<li>' + blocks("\n".join(content), heading_id) + '</li>') tag = 'ol' if ordered else 'ul' start = ' start="' + str(int(first[2].rstrip('.)'))) + '"' if ordered else '' out.append('<' + tag + start + '>' + ''.join(items) + '</' + tag + '>') else: paragraph = [lines[i].strip()] i += 1 while i < len(lines) and lines[i].strip(): new = lines[i].strip() if HEADING.match(new) or LIST.match(lines[i]) or new.startswith(('>', '```')) or table_start(lines, i) or re.fullmatch(r'[-*_]{3,}', new): break paragraph.append(new) i += 1 text = "\n".join(paragraph) question = bool(re.match(r"\*\*问题\s*[1-5]\s*[||]", text)) out.append('<p>' + inline(text).replace('\n', '<br>') + '</p>') return "\n".join(out) def reading_cards(content, heading_id): chunks, current, fenced = [], [], False for line in content.splitlines(): if line.strip().startswith("```"): fenced = not fenced h = HEADING.match(line) if not fenced and h and len(h[1]) in (3, 4) and current: chunks.append("\n".join(current)) current = [] current.append(line) chunks.append("\n".join(current)) rendered = [] for chunk in chunks: if not chunk.strip(): continue part = blocks(chunk, heading_id) if re.match(r"^#{3,4} ", chunk.lstrip()): part = part.replace('class="takeaway"', 'class="takeaway compact"') rendered.append('<div class="reader-card">' + part + '</div>') return '\n'.join(rendered) def render(source): title_match = re.search(r"^# (.+)$", source, re.M) if not title_match: raise ValueError("报告须有一行 # 总标题") title = title_match[1] body = source[title_match.end():].strip() segments, section_lines, fenced = [], [], False for line in body.splitlines(): if line.strip().startswith("```"): fenced = not fenced if not fenced and line.startswith("## "): segments.extend(["\n".join(section_lines), line[3:]]) section_lines = [] else: section_lines.append(line) segments.append("\n".join(section_lines)) used_ids = {"main", "sidebar", "menu", "closeMenu", "backdrop", "currentTitle", "progressBar"} def heading_id(value): base, count = slug(value), 1 anchor = base while anchor in used_ids: count += 1 anchor = base + '-' + str(count) used_ids.add(anchor) return anchor intro = blocks(segments[0], heading_id) nav, sections = [], [] short_titles = ["行业与竞争", "获客与成交", "GEO 值不值得", "重点客户与目标", "五题实测", "怎么开始做"] for number, i in enumerate(range(1, len(segments), 2), 1): heading, content = segments[i], segments[i + 1] anchor = heading_id(heading) display = re.sub(r"^[一二三四五六]、", "", heading) label = short_titles[number - 1] if number <= 6 else display.split('(')[0] section_html = reading_cards(content, heading_id) child_links = [] for child_id, child_heading in re.findall(r'<h[34] id="([^"]+)">(.*?)</h[34]>', section_html): child_label = html.unescape(re.sub(r'<[^>]+>', '', child_heading)) step = re.match(r'第\s*(\d+)\s*步', child_label) if step and 1 <= int(step[1]) <= 10: child_label = step[1] + ' · ' + STEP_NAMES[int(step[1]) - 1] child_links.append('<a class="toc-child" href="#' + child_id + '">' + html.escape(child_label) + '</a>') children = '<div class="toc-children">' + ''.join(child_links) + '</div>' if child_links else '' nav.append('<div class="toc-group"><a class="toc-chapter" href="#' + html.escape(anchor, quote=True) + '"><span class="nav-number">' + f'{number:02d}' + '</span><span class="nav-label">' + html.escape(label) + '</span></a>' + children + '</div>') extra = ' source-module' if '来源' in heading or '教学材料' in heading else '' sections.append('<section class="module' + extra + '" id="' + html.escape(anchor, quote=True) + '" data-title="' + html.escape(label, quote=True) + '"><header class="section-head"><span class="chapter-no">' + f'{number:02d}' + '</span><h2>' + inline(display) + '</h2></header>' + section_html + '</section>') values = {"TITLE_TEXT": html.escape(plain(title)), "TITLE_HTML": inline(title), "INTRO_HTML": intro, "NAV_HTML": ''.join(nav), "SECTIONS_HTML": '\n'.join(sections)} return re.sub(r"\{\{([A-Z_]+)\}\}", lambda m: values[m[1]], TEMPLATE.read_text(encoding='utf-8')) def example_source(): text = (ROOT / 'references' / 'report-example.md').read_text(encoding='utf-8') marker = '# 示例库存软件公司 GEO第一性原理分析' before, report = text.split(marker, 1) inputs = before[before.index('## 假设输入包'):].strip().removesuffix('---').strip() inputs = inputs.replace('## 假设输入包', '### 假设输入包') return marker + '\n\n**样式预览 · 虚构教学案例。** 以下使用随包示例内容,展示报告阅读形式;企业、数字与材料均为假设,不代表真实研究或模型实测。\n' + report + '\n\n' + inputs def main(): parser = argparse.ArgumentParser(description=__doc__) parser.add_argument('input', nargs='?', help='UTF-8 Markdown report') parser.add_argument('-o', '--output', required=True, help='Output HTML path') parser.add_argument('--example', action='store_true', help='Render the bundled fictional example') args = parser.parse_args() if bool(args.input) == args.example: parser.error('Provide a report path or --example, but not both') start = time.perf_counter() source = example_source() if args.example else Path(args.input).read_text(encoding='utf-8') result = render(source) output = Path(args.output) output.parent.mkdir(parents=True, exist_ok=True) output.write_text(result, encoding='utf-8') print(json.dumps({'path': str(output.resolve()), 'bytes': output.stat().st_size, 'local_render_ms': round((time.perf_counter() - start) * 1000, 2)}, ensure_ascii=False)) if __name__ == '__main__': main()references/competition-research.md5.4 KB3457495cda47upstream ↗
# 行业与竞争研究 用于确定客户购买、真实竞争范围与证据含义。研究须解释成交与收益机制,榜单和官网只是材料的一部分。维护 Skill 时不启动企业调研。 ## 从购买任务划定范围 先确认企业、地区、业务、本轮目标与已有结果,复用已核对资料。主体歧义仍须核对,搜不到不证明没有官网;多业务企业不能因另一业务资料丰富就擅自换重点。 按谁在什么条件下解决什么问题,确定可能进入同一次选择的企业与方案。除直接对手,也考虑人工、自建、租用、延后购买等替代。行业龙头可以解释背景,未争夺同一次购买则不能当直接对手。首次购买与替换、标准与定制、应急与长期改善,可能对应不同标准;不要用行业标签替代任务分析。 ## 按经营命题联网研究 先提出影响判断的问题,再找材料,避免先选卖点再找佐证。重点按需取舍,不逐项填满: - **需求与购买**:什么触发需求,不处理的代价是什么,谁使用、筛选、决定和付款;客户怎样发现、比较、核验、购买与续用,为何继续或退出。 - **价值与收益**:哪些能力产生改善,谁获取订单或溢价;收入、主要成本、获客负担和容量如何关联。性能、价格、交期、兼容性等怎样改变客户总付出,优势何时失效。 - **变化与影响**:需求、供给、技术、渠道、成本或规则发生了什么可确认变化,如何传导到预算、替代方案、选择标准及利润分配。 使用适合命题的材料:采购要求、客户讨论、交易与服务条款、产品文档、公开案例、行业研究、统计和企业披露。官网核对供给,不能独自代表需求;零散评价可发现疑问,不能给全行业的购买标准排序。报告名称、资质或编号不代替内容,面积也不证明可用容量、履约质量或转化率。企业自述可作为注明来源的前提,未经核对不称独立证实。 ## 比较真实方案与营销痕迹 先比较代表性对手提供什么、客户总共付出什么、适合什么条件,以及怎样进入候选。按任务选择必要的价格、学习、迁移、等待、维护与失败后果,不凑完整参数矩阵。交付范围或能力不明就保留未知,宣传形容词不能补齐事实。 必须搜索竞品的排行、推荐、对比与批量营销痕迹。可组合“业务或购买任务+地区+选型/哪家好”“竞品名+排行/十大/评测”,再追查独特句段、完整标题及联系入口。检查重复段落、固定品牌顺序、统一评分、连续主题、相同联系方式和推广标识;相同稿件、镜像与转载去重。 单篇能支持“已见推荐内容”;多篇有重复组织特征时可描述“疑似系统化营销或分发”,保留转载、SEO、公关等解释。多网址说明分发范围,不算多份独立背书。企业或具名服务商自述 GEO 时说明身份;使用 AI 工具不等于开展 GEO。没找到则说明查了什么,不能宣布不存在动作。 营销研究最终应解释对手试图突出哪项选择标准、怎样争取候选资格,再与真实适配比较。文章多不证明竞争力,内容重复不证明 AI 降权;推广痕迹也不证明公司委托、付费、模型采纳或成交。各项结论需要各自证据,不从公开可见程度推断目标 AI 现状。 ## 区分会改变投入的解释 重要线索要推进到原因,而不是直接变成内容建议。只比较有线索、且会改变决定的解释。 例如客户频繁问交期,可能因为停工损失高、供应不稳,或交付说明不清。分别核对采购情境、履约记录、承诺与实际差异、退出原因。能力不足时增加宣传难解决;能力可靠但客户难判断时,信息改善才有具体价值。AI 是否参与筛选仍需行为依据或保留条件。 无法区分时说明最有价值的核对点,以及不同答案会怎样改变投入。匿名假设仅用于展示经营关系,不替真实客户续写购买经历。已有 GEO 成果不能证明新提出的成功机制,竞品发新榜单也不足以要求加预算;未知在优先级和结论中不得变成事实。 ## 核对来源并及时停止 当前竞争优先近期资料,行业结构追溯必要的长期材料。记录直接原文、可确认日期、查阅日期和支持的命题;摘要只是线索,搜索更新时间不是发布日期。引用紧跟论据,不因已收集许多材料就追加长来源清单。 冲突先查主体、型号或套餐、时间及口径。评测、认证和案例要看方法、条件、结果与范围,单项指标不外推整体能力。只有需要解释某个产品当前能力时才查其官方说明;未公开的算法、权重或来源偏好保留未知。 研究过程复用已核对的材料,只补影响决定的冲突、变化和未知;宿主支持时并行独立检索。重要命题已有足够依据、反例和边界,进一步搜索不太可能改变决定时停止。不要凑来源数量、对手数量或每维字段;材料窄就缩小结论范围,材料多也只保留影响判断的事实。 正文先解释行业经营与方案取舍,再用主文件规定的简明竞争表呈现营销证据。长摘录留在研究记录中,行业部分不提前安排发稿或改站,也不因证据不足就将完整分析降成五道问题。references/first-principles-analysis.md7.9 KB5430a2c6b3acupstream ↗
# 从交易条件推导 GEO 经营价值 用于分析停留在“买效果”“缺信任”等行业标签时。下列例子均为匿名假设,只示范因果解释,不代表本轮调研事实。 ## 追到购买成立的条件 客户为什么产生需求,为什么愿意付出资源,为什么采用这种方案,又为什么选择这家企业?继续追问:改善对谁有用,谁承担价格、等待、学习、迁移或失败后果,怎样确认企业能交付,什么替代方案已经足够。只展开真正影响本次选择的条件。 例如软件具备实时库存功能,还不足以解释购买。假设销售、仓库与财务各用一套记录,库存差异同时带来错误承诺、重复采购与对账工作,统一业务事实才可能产生收益。但客户若不能统一编码和责任,或上线负担超过现有损失,功能齐全也未必值得更换。能力、使用条件与收益连起来,才能识别值得争取的客户。 不要先预设“资料少”,再把所有需求解释为信任问题。产品、价格、时间、便利、兼容性和服务都可能改变选择;真正的洞察应能区分原因,并改变比较对象、客户范围或资源去向。 ## 解释企业如何创造价值、获得收益 客户的改善由哪些供给共同完成,谁掌握难以替代的条件,谁因此获得订单或溢价?一项优势至少要讲清:企业有何能力,它怎样减少客户总付出或增加收益,客户为何愿意据此选择,以及何时不成立。 快速交付可能对紧急恢复生产很重要,对尚在设计、需要长期认证的客户却不足以胜出。相同企业的真实对手会随任务变化。客户总付出降低,也不必然形成卖方利润:还要看交付成本、优势能否被识别以及对手是否容易复制。 行业变化同样需要传导解释。例如价格更易比较,可能压缩标准供给的溢价,使企业更需要证明服务减少了哪些其他付出。核对变化是否发生、影响谁、怎样改变购买与利润;不能从市场扩大或 AI 用户增加直接推出本企业应投 GEO。 ## 区分增长来源、信任要求与决策复杂度 增长可能来自更多合适新客、已有需求更容易成交、续用复购,或释放交付容量。同一笔资源投向不同位置,价值不同。新客重要不等于应追求最大曝光,还要看单客贡献、筛选成本和供给能力。 | 观察角度 | 要解释的关系 | 需要避免的跳跃 | |---|---|---| | 流量依赖 | 增长需要多少、什么样的新客,现有渠道能否持续带来 | 新客重要,所以 GEO 应是主要渠道 | | 信任验证 | 付款前须确认什么,真实能力是否难以核验 | 行业重信任,所以本企业因不被信任而失单 | | 决策复杂度 | 谁使用、付款、决定或否决,各需完成什么判断 | 多角色、长周期,所以 AI 必然促进成交 | 三者可以同时存在,不能据此把行业分成互斥类型。结合反馈与业务记录,区分合适需求不足、价值难理解或核验、决策协调困难,以及产品或交付不适合。 例如客户不愿试用,可能看不懂差异,也可能内部无人负责迁移,或现有损失尚不足以支持更换成本。官网资料少不能替这些解释作选择。保留会改变投入的可能原因,指出什么证据可以区分;已有成果则分析哪些成立条件值得延续或复制,不必先找缺口。 ## 用具体任务解释行业内部差异 以下三例展示如何从需求推进到取舍与 AI 作用;不要求每份报告输出多个案例,也不续写真实受访者的经历。 **教育服务:知识不足与执行条件不足,可能需要不同方案。** 假设一位学习者需要补特定知识且能自行安排,另一位理解知识但难以持续执行。前者可能比较录播与自学资料,后者可能比较监督反馈、集训或同伴学习。住宿与名师是否有价值,取决于目标问题、管理方式及家庭安排。AI 若被用于选课,可能先帮助区分需求,改变比较标准;机构仍须有相应交付能力。不能把所有学生概括为缺自律,也不能由外地客户存在推定远程信任是最大瓶颈。 **本地生活:同一个人在不同时机下会采用不同标准。** 假设工作日简餐重等待、距离和价格,家庭聚餐则需兼顾人数、口味、停车与预订确定性,“高消费人群”无法解释两次选择。聚餐收入更高也未必更赚钱,还可能占用高峰容量、增加服务或挤出已有订单。AI 若帮助组织者比较条件,可能减少协调工作;菜单、座位和时段仍需门店确认。建议因此应连接筛选信息、实际体验与可用性确认。 **企业采购:同一订单可能包含几项不同判断。** 假设技术人员排除不兼容方案,生产方关心停机,采购比较交期与总成本。新设计导入可能需要样品、测试和长期支持,应急替换则优先确认现货、尺寸与到货时间。AI 可能帮助理解规格和整理候选,工程沟通、样品与测试仍决定适配。专业资料的作用必须连接实际能力,不能从长周期直接跳到“做品牌信任”。 ## 用客户选择检验 GEO 是否适合 回答:**假设 AI 明天已经准确介绍企业,能改变谁的什么决定,这项改变对生意有什么价值?** “更多人看见”还需解释人群价值和下一步。帮助已有报价的采购理解适配条件,再邀请技术人员确认,是可继续验证的具体作用。 围绕前文一项购买任务,将四项关系连起来:真实客户判断、AI 参与的行为依据或条件、企业真实差异可能改变的行动,以及承接能力与收益能否支持新增成本。客户会不会用 AI,与 AI 能否处理资料是不同问题;产品不适合,也不能靠介绍准确来解决。 对照原有路径和可能借助 AI 的路径,解释客户委托了哪项信息工作、比较顺序如何变化、谁仍需确认。没有实际记录就保留条件,不编客户咨询或模型回答。考虑双向作用:替代方案更易发现可能扩大竞争,比价可能压缩溢价,复杂优势也可能被简化。明确不适用条件有时可减少无效销售,但不能从一次回答推定经营得失。 转介绍、招投标或平台内成交均不构成硬排除,仍要看此前的筛选、核验与内部沟通;存在比较也不证明 AI 已参与。若影响路径缺乏依据,或真正限制在产品、价格与容量,可以优先改善经营条件。公开资料或五题表现不能替代适用性判断;发现缺资料后仍须解释补齐是否值得、补到什么程度。 ## 将解释推进到资源取舍 沿企业本轮目标,与现实替代比较:继续现有获客、改善销售或交付、维护已有 GEO 成果,哪项新增价值更可能支持成本?首次尝试要确认机会条件,已有 AI 来客要区分原有成果、自然流入与新增动作,稳定运行要判断延续或扩大的边际价值。不要每次退回“先问五题”。 若客户担心迁移,先区分真实迁移能力不足、内部未达成一致、收益不抵成本,还是服务范围难确认;它们分别指向产品、协作、客户适配或信息投入。最会改变决定的条件,应成为优先核对项。 资料充分时选择能区分解释的证据,不搬整份年报;资料少时缩小事实结论,仍可讲透不同条件下的购买与投入。容量、资质、公开案例不能代替履约、利润或转化证据。收益与新增成本分开,避免重复计算。 每个重要判断讲透一次,后文用它推进决定。未知在开头、场景优先级和结论中保持未知;不能论证时承认多种解释,收尾却宣告唯一瓶颈。深度的检验是:负责人能解释过去的一类选择、区分混在一起的需求,或知道一项资源为什么该换位置。references/funnel-and-scenarios.md8.0 KBaa2b02952079upstream ↗
# 客户购买路径与 GEO 重点选择 本文件帮助区分客户怎样购买、企业要改善什么,以及客户会向 AI 提出什么问题。例子均为假设。方法用于形成判断,成品中的标题、表格与代称必须直接让企业看懂:用“准备更换旧系统的批发商”等客户短称,不用场景代码、维度编号或“目标句”等工作标签。 ## 先还原购买过程,再判断增长需要什么 漏斗把同类客户从了解到购买分层,解释每一步为何继续或退出。通常四至六层,按业务调整;复杂采购保留多人并行、回退与审批,复购和转介绍另说明回流。以下只演示关系,阶段与渠道按本轮事实填写。 | 购买阶段 | 客户要完成的判断 | 现有渠道如何帮助 | AI 可能参与及成立条件 | |---|---|---|---| | 理解需要 | 问题是否值得解决,有哪些办法 | 同行、内容或咨询解释后果与替代方案 | 若客户用 AI 梳理需要,可辅助区分解决办法 | | 筛选方案 | 谁符合必要限制 | 搜索、平台或销售提供范围、价格和适配信息 | 若客户向 AI 描述限制,相关事实可能帮助筛选 | | 比较与确认 | 使用者与决策者是否接受 | 演示、案例、样品和沟通支持不同角色 | 可辅助整理差异;测试、体验和内部批准仍需相应人员 | | 购买与启动 | 费用、时间与责任能否接受 | 交易、预约或对接人员确认约定 | 若可展示准确条件与入口,可减少查找;排期和履约仍由企业确认 | 表后解释关键继续、退出条件及角色,不逐行复述。发过内容不证明客户看过或因此行动;客户会搜索不证明会问 AI。AI 一栏区分使用依据与待确认条件,无需先取得模型回答。 能渲染时用短阶段名画收窄漏斗,否则使用阶段表。HTML 可嵌入 SVG 等图表;交付可阅读的图表或可打开的文件,不以未渲染源码代替成品。图表承担对应关系,正文解释原因,不输出两套完整表格。没有同一客群、时期与阶段口径的数据,只标结构示意,不拼接渠道人数、全公司营收或跨批咨询量生成转化率。 解释企业需要怎样的客户,再判断更需要扩大新客、增加匹配、推进成交或改善使用复购。流量价值取决于客户需要、利润、容量与承接;高客单和长周期不自动主攻信任,低客单也不自动需要大范围流量。 ## 判断当前最值得改善什么 流量依赖解释增长来源,信任验证解释付款前要确认什么,决策复杂度解释谁参与、怎样决定。三者可以共存。放回实际路径区分以下原因: - **合适客户不足**:企业有能力,但目标客户不知道或未考虑它。区分有效需求、触达与匹配,浏览量不代替客户价值。 - **购买理由难以理解或核验**:客户有需要、企业也适合,但差异或承诺难确认。行业重视信任不证明本企业正因此流失客户。 - **购买推进困难**:价值被认可,仍需技术确认、预算、多方协调或启动安排。要识别具体人员和判断,不能把长周期都归为信任不足。 - **产品或交付限制**:不适配、总付出不被接受、服务不足或容量已满。增加信息通常不能直接解决,应比较改善实际能力的价值。 原因可以并存,不强定最大流失点。记录不足时保留会改变投入的解释,指出用什么客户反馈或业务记录区分。已有 AI 获客的企业分析扩大条件,不重置为从零开始。 例如客户担心设备兼容:实际兼容而难以确认,资料与演示可能有用;本身不兼容,则应处理产品和服务范围。最后说清当前最值得改善哪项客户选择、依据与未知,再进入适用性分析。需要新客、核验或复杂协调,都还需证明 AI 能帮助谁完成什么判断,以及行动后的业务价值是否值得成本。 ## 选择值得支持的客户需求 内部区分三件事:业务场景是客户处境,如批发商准备更换旧系统;阶段是进度,如准备演示;问题类型是询问内容,如迁移是否麻烦属于交付使用问题。视频、官网是载体,不能替代三者。 围绕企业目标比较少量现实候选,解释五个方面: | 评估方面 | 要回答的经营问题 | |---|---| | 业务价值 | 对本轮目标有什么贡献,能否持续交付 | | 真实需求 | 客户为什么需要解决,不解决有什么后果 | | AI 可影响 | 哪项判断可能借助 AI,依据或成立条件是什么 | | 企业真实差异 | 相比替代方案为什么适合,在哪里不占优 | | 转化承接 | 下一步是什么,由谁接住,是否有容量 | 同时说明现有可用基础与补齐代价:可复用哪些客户经验、资料、渠道、人员与服务,还缺什么、谁负责、涉及什么成本。它帮助比较新增投入,不是第六项打分或准入门槛。规模、资料多少、客单价与需求热度均不能独立决定优先级。 比较后明确取舍:条件基本成立时,结合五方面与新增代价定主次;关键依据未知时,保留候选,说明要确认什么、结果怎样改变选择;已有依据显示与目标不符、不适配或本轮无法承接时,解释暂缓及重新考虑的条件。未知不等于无需求,不按资料齐全程度或 AI 使用证据单项排序。 保留企业阶段、业务、地区、目标与有效路径。稳定不等于饱和,现有成功不证明新客群或地区成立。合并比较与理由,不用多套矩阵和解释重复证明同一选择。 ## 五类问题怎样服务购买 | 问题类型 | 客户要完成的判断 | |---|---| | 品牌验证类 | 这家是否可靠,是否适合我 | | 品类需求类 | 什么方案或企业能解决我的问题 | | 竞品对比类 | 几个候选有什么实质差别 | | 交付使用与售后类 | 怎样开始、用起来怎样、问题谁负责 | | 行业认知与科普类 | 怎样理解问题、形成选择标准 | 同一业务场景可涉及多个阶段和问题类型,一类问题也可影响多个阶段。售后成本可能直接决定首次购买,科普可能改变选择标准,不能机械暂缓。通常突出一类、少量辅助;多类共同支持一项决定时,解释各自作用即可。 企业正文用客户或需求短称连接问题、理由和结果,表头统一称“问题类型”。说明帮助客户完成什么判断、采取什么行动,用什么现有记录观察;缺字段时说明待补,不凭空增加系统。 “找得到、看得上、信得过、接得住”只在分析中检查必要条件,与五类问题交叉使用,不建立一一对应关系,也不另输出一套完整清单。 ## 从优先需求中选出五个实测问题 恰好五题,按业务主次分配,不必五类各一题。一题一个主要疑问,优先沿用客户语言,无原话时标明模拟。条件按需要加入,不补造限制,保留客户实际使用的专业术语。 发现题不预置品牌;比较与核验题可以带已知候选,但不用于证明自然被发现。例如“我们有两家门店,库存经常对不上,应该先改流程还是换软件?”聚焦一项真实决策。题目标题可用“问题1|先改流程还是换软件”,再给完整引用问题和一行问题类型说明;不同业务场景时加具体客户短名,无需场景代码或重复映射表。 第五部分按[实测指引](planning-and-handoff.md)先邀请企业到目标产品操作,说明新会话、保存完整回答和可见来源的方法。保留指定产品,一个平台即可开始;原始记录按产品与日期保存,不重复企业背景,不增加自动测试或效果分析。 第六部分无需等待实测。可见模式、来源与呈现形式可支持条件式布局;提及、遗漏、引用不能证明需求、使用行为、瓶颈或回报,多次、多产品观察也不能单独决定投资。开头、排序与结论不得比正文证据更确定。references/html-report.md9.6 KB2ea27618d65eupstream ↗
# HTML 报告:让负责人看懂,保留完整分析,快速成稿 默认交付一份可直接打开、连续滚动的单文件 HTML。桌面左侧为常驻分级目录,正文按章节与小节自然展开;手机用目录按钮打开导航,点击后回到对应正文。用户另有格式要求时按其要求;不能创建文件时说明限制,并先交付同样完整的可读内容,不把源码当成报告。 ## 每个模块先给读者一个明确判断 六个主体章节、最终结论与数据来源各有一句醒目的核心金句。独立展开的十步要点也各有一句,可直接承接标题中的大白话,正文不重复解释一遍。 金句须表达**本企业的关键判断与业务价值**,由该模块正文支持。用具体的客户、问题、选择或行动,讲清为什么重要;不能只是“本章讲竞争格局”,也不能把待验证的机会说成已经发生的效果。通常一到两句读完,条件不可删。 例: - 行业章节:批发商愿意为账货衔接付费,功能多不代表适合他当前的生意。 - 价值章节:AI 若能帮合适客户从了解走到演示,才有扩展价值;当前还不能据此扩大获客预算。 - 行动章节:先把业务和上线责任讲成一份能共用的资料,再按实测安排后续内容。 这些是虚构示例的表达演示。真实报告必须重写,不能固定套这几句话。 阅读顺序为:**结论式金句 → 事实与因果推导 → 取舍、成立条件及行动含义**。这只是阅读顺序,不要求每章重复增加三套小标题或三张卡片。保留六部分原有任务,第六部分金句之后仍按原定五块顺序展开。 ## 完整性优先于版式 逐模块保留:客户为何买与替代方案、可比竞争证据、购买路径与关键停顿、GEO 的价值链和投入取舍、场景与五类问题的主次、五题原文及操作记录、十步完整介绍与本企业适用步骤、动作负责人和完成标准、工具交接、六标签最终结论、数据与来源。 不能为了卡片等高、控制屏数、减少文件大小,删掉依据、关键数字及口径、反向情况、优先级理由、成立条件或来源。长段按意思拆开;同一件事只在最适合的位置写全。允许页面自然变长,不设置总字数上限。 所有关键内容默认展开;不用折叠面板、分页、轮播、弹窗或点击后才加载的正文。不限制正文高度、不截断溢出、不省略表格行列。宽表放可横向滚动的容器,保留可发现的提示;不缩小到无法阅读。来源紧跟判断,文末再集中列目录。 ## 让语言更容易懂 对外写“客户问题组”,不写“意图簇”;写“内容任务说明”,不写 Brief;写“先做/配合/后续”,不写 P0/P1/P2;写“咨询和成交记录”,不凭空引入 CRM。规范中的内部分析用语不直接搬进报告。 十步名称保留与开源体系的对应关系,首次在旁边配大白话。例如“事实本体:整理企业真实资料”“基线检测:记录 AI 现在怎么回答”“效果归因:核对咨询和成交从哪里来”。不要假定负责人了解缩写,也不要用解释术语代替经营分析。 ## 复用模板,内容只写一次 模板为 `assets/report-template.html`:暖白纸感背景、米色左侧栏、细分隔线、橙色导航高亮与绿色核心判断;系统字体,正文 17px,手机正文 16px。桌面正文随侧栏偏移,保持适合长文的阅读宽度。章节不使用厚黑框或重投影;小节通过间距、轻卡片与标题区分。无在线字体、外部脚本、图片素材下载或前端构建依赖。单页正文已经写入 HTML,关闭 JavaScript 仍能读全文、查看来源、手选复制五题;小段脚本增强目录抽屉、当前章节高亮、阅读进度、复制与打印;阅读进度只表示页面滚动位置,不代表理解程度。 **能运行 Python 3.9+:优先让模型只写一次报告正文,直接调用本地渲染器。** 不读取渲染器或整份模板源码来仿写,不先输出一遍对话全文再输出一遍 Markdown 再重写 HTML。无需为渲染安装任何第三方库。 ```bash python3 scripts/render_report.py report.md -o 企业GEO分析.html ``` 上面路径相对本技能目录;宿主实际调用时定位本技能文件,不假定当前工作目录。`report.md` 是本轮完整正文的中间文件,企业默认收到 HTML。本地程序只排版,不联网、不运行模型、不改变分析结论。 正文使用常见 Markdown:一个 `# 总标题`;六部分、最终结论、数据与来源用 `##`;需要的小标题用 `###`、`####`;表格、列表、链接、粗体、引用块正常写。每个主模块开头加: ```markdown > **本章金句**:此处写该企业有依据的核心判断。 ``` 十步要点的小标题后用 `> **金句**:...`,渲染为较轻的橙色提示。五题标题使用 `**问题1|业务疑问短名**`,下方普通引用块放完整问题,程序自动加复制按钮。不要给金句或题目加其他隐藏标记。表格中的换行可用 `<br>`;单元格内竖线写 `\|`。其他原始 HTML 不用于这一路径。 十步图可以用下面的小数据块,由程序生成可随屏幕换行的十步路线。所有状态从第三部分已经作出的决定取得;示例里的范围不是默认答案。没列出的步骤显示“本轮暂不安排”,起点可写 `null`。 ```geo-route {"start":1,"active":[1,2,3,4,5],"conditional":[6,7],"rhythm":[8,9,10],"condition_label":"等第 4 步结果后启动"} ``` 简单客户路径可用 `geo-funnel` 数据块;每个条目含 `label` 和 `note`。例如 `[{"label":"产生需求","note":"人数未记录"},{"label":"咨询","note":"人数未记录"}]`。按实际路径填写,不套示例步骤,不填无依据人数;程序用等宽阶段条,明确标为路径示意。详细原因仍保留在阶段表或正文,不由图代替。 **不能执行脚本但能生成文件:直接复用模板。** 填入总标题、背景与核心判断、目录、各模块的 HTML 正文;保留模板 CSS 和已有小脚本,不从头设计页面。不强制先写 Markdown。把标题用于 `TITLE_TEXT` 时作 HTML 转义;正文使用正常的语义标签。左侧目录由主模块和实际小节组成,每个链接指向唯一的正文锚点;保留移动目录、复制与打印脚本,以及无脚本时的可读回退。十步用有状态文字的编号网格,或现有 SVG 加可读状态说明。渲染器生成的结果与直接 HTML 路径应包含同一套完整内容。 **只有 SKILL.md:** 使用主文件中的轻量单页要求直接生成 HTML,无需补装渲染器。若宿主无法交付 HTML 文件,先交付完整的可读报告并说明能力限制。 ## 用轻量图示减轻阅读负担 优先在六个主模块里,将正文已有的角色关系、客户路径、收入与成本、重点客群、操作顺序和行动路线转成简明图示。选择能帮助理解的关系,不为了数量凑图;主模块金句仍放在图示之前。图示作概览,完整依据、表格与操作正文继续保留。没有同口径数据时用等宽卡片或步骤图,不画暗示比例、权重或效果的柱高、面积与百分比。 可复用两种小数据块,均由标准库渲染器直接生成,无图表库、图片生成或外部资源。`geo-cards` 表示并列卡片,`geo-flow` 表示有顺序的步骤;每项必须含文字 `label` 与 `text`,可选 `value` 仅呈现正文已经支持的数字与单位。`note` 保留范围、假设或来源链接,禁止删掉重要条件以放大数字。数据块中也可用普通 Markdown 链接与强调。 ````markdown ```geo-cards {"title":"选择前要核对的条件","items":[{"label":"产品适配","text":"说明本企业能够服务的需求与边界。"},{"label":"交付准备","text":"说明客户与企业分别要准备什么。"}],"note":"请替换为当前报告正文已有依据的结论,不新增事实。"} ``` ```` 顺序图使用相同字段,将类型改为 `geo-flow`,每项是一项已确定的动作或路径阶段。数字卡片保留单位、时间范围和成本口径;示例中的 8,000 元差额不等于 GEO 净收益,不可改写为收益 KPI。 目录应显示六个主模块、最终结论、数据来源;有小节时生成二级跳转,展开的十步也应能直接定位。小节目录只是入口,不折叠正文。复制五题、来源锚点和完整表格都继续工作。不要照搬版式参考的行业内容、人物、照片、记录笔记功能或无关工具栏。 ## 快速校验,不为装饰反复等待 研究完成后只生成一次正文、排版一次;发现遗漏或错位,只修相应段落和样式,不重复联网研究。常规交付检查:侧栏与小节跳转正确、各锚点唯一、手机目录可开关、六部分齐全、主模块与展开步骤有具体金句、恰好五题可复制、来源可点击、数字与条件完整、宽表可滚动、占位符已替换。工具可用时看一次桌面和手机预览;不为微小装饰反复截图,不生成 PDF、图片版或网页应用,除非用户要求。 速度优化针对重复写作、模板代码和渲染工作,不能减少关键核验与分析。不要把本地排版耗时称作整份报告的生成耗时,也不要承诺固定分钟数。 维护模板时可运行 `python3 scripts/render_report.py --example -o preview.html`,只对随包虚构案例做样式预览;不启动真实企业诊断。示例输入作为可跳转的来源附在预览末尾,不需要每次真实运行都读取该长例。references/planning-and-handoff.md10 KB96dafc4389bfupstream ↗
# GEO 投入建议与五题实测指引 本文件按需用于组织第四部分的场景选择与第五部分的五题实测,并为第六部分提供内容、载体与投入判断的原则。第六部分本身按 GEO 十环写成有先后的路线,写法、路线范围、过关标准与生态工具清单见[十环路线与生态交接](ten-ring-handoff.md);本文件后半部分的“内容安排”“载体与购买入口”“经营变化决定投入”分别对应第 6、7、9 步,在路线内使用,不再单独成章。“找得到、看得上、信得过、接得住”用于检查路线完整性,各对应第 7、6、1、9 步。 ## 让建议承接已经形成的经营判断 沿用前三部分的增长来源、当前机会与限制、AI 参与条件及投入决定。需要新客、需要核验、多人决策可以同时存在;任何一项都不自动证明适合 GEO。信息能否帮助值得争取的客户行动,与企业是否真正具备产品和交付能力,要分开判断。 第四部分用[漏斗与场景](funnel-and-scenarios.md)中的五个方面比较少量现实选择,同时说明现有资料、客户经验、渠道和人员能复用什么,还需补什么、代价是什么。保留已有成果与用户指定的目标、地区和产品;新增客群或业务的成立条件另行分析。未知不等于不适合,资料丰富不等于应该优先投入。 选择后直接告诉企业:帮助哪类客户,在什么处境下完成哪项判断,进而采取什么行动;依据现有哪项业务记录观察变化。不要把“目标句”、场景代码或分类过程写成正文标题。例如: > 帮助准备更换库存软件的批发商确认旧数据能否迁移,推动有条件的客户预约演示。由销售在现有咨询记录中保留需求、顾虑和后续进度。 行动可以是咨询、方案确认、预约、购买或减少重复服务,服从企业原有目标。记录方式要真实可用;有记录不等于已经证明 GEO 的贡献。若暂缓专项投入,说明更值得先解决什么和重新考虑的条件,无需强造主攻或完整实施路线。 ## 第五部分:到 AI 中实测这五个问题,了解客户目前会看到什么 先邀请用户亲自操作,再给五题。建议采用以下开头,并填入用户已经指定的 AI 产品: > 建议你把下面五个问题分别复制到【AI 产品】中,看看客户现在可能得到什么回答。保存这些回答,后续就能结合实际呈现方式,进一步安排内容和购买入口。 未指定产品时,建议优先选择客户已经使用的平台;暂时不清楚,可先选一个开始,不强制多产品。一个产品的结果只代表这次观察的范围。 用简短操作说明帮助企业开始: 1. 打开选定的 AI 产品,记录日期、界面显示的模型或模式,以及是否开启联网。 2. 每题新建一段对话,只复制该题,不先上传这份报告或企业资料;无法消除的个性化设置如实注明。 3. 保存完整回答或截图,以及可见来源链接;没有显示的就记“未显示”。图像、视频、商品或门店卡片也一并保留。 4. 按产品与日期将五次记录放在同一份文档;模式或联网设置不同,分开注明。 恰好提供五道可复制问题,按业务主次分配,不必五类各一题;更多目标产品也不增加题目总数。题目优先沿用真实客户表达,无原话时简短说明为模拟。每题只聚焦一个主要疑问,地域、预算、规格和时间按购买需要加入;保留专业客户确实使用的术语。发现类问题不预置品牌,比较与核验题可以带已知候选,不能将后者当作自然发现的测量。 每题采用“问题1|【客户关心的具体疑问】”、完整问题引用块,以及一行问题类型说明;不同业务场景时加具体客户短名,不再重复客户想了解什么。避免将师资、费用、风险、售后、联系方式等全部塞进一道审查题。 只需提供一个可以复用的记录格式,不再要求企业重填名称、别名、目标、全部场景与题号关系: > 日期与产品:____;显示模型或模式:____;联网:____。 | 问题 | 完整回答或截图 | 可见来源链接 | |---|---|---| | 问题1 | 待记录 | 待记录 | | 问题2 | 待记录 | 待记录 | | 问题3 | 待记录 | 待记录 | | 问题4 | 待记录 | 待记录 | | 问题5 | 待记录 | 待记录 | 正文用一句话说明用途边界:**这一步帮助了解当前回答,五题表现不能直接证明获客效果或投资回报。** 不在此分析回答好坏,不自动运行或模拟答案;企业提供原始记录并授权整理时,可原样保存。运行条件和结果待实际记录,不用报告日期冒充测试日期,也不把搜索或 API 结果当成消费者界面实测。出现顺序不等于推荐名次;企业指出的疑点及所持材料可以原样保留,不能直接判为已证实错误。 第六部分继续依据经营分析给建议,无需等待五题完成。五题在路线里的位置是第 3 步问题清单的种子和第 4 步的首次小样本观察:问题进清单并标注来源,回答只用于看方向。实测记录中的产品模式、可见来源和呈现形式可细化第 7 步的阵地选择;提及、遗漏和引用不能证明客户使用行为、需求规模或当前瓶颈,也不能成为加量、停投的开关。增加次数或产品仍不能替代经营证据;要报比例,需要同一清单在同一模型上按节奏多轮累计(本流程按单平台单日单账号不超过 40 次分批;这不是平台安全阈值,实际遵守当前平台规则),这是工具与节奏的事,路线里如实写明。 ## 将客户疑问、真实依据与内容安排连接起来 优先从销售、客服和成交反馈中找客户为何比较、迟疑或继续行动。公开讨论可以补线索,热度不等于 AI 内需求规模;模拟问题不可写成真实客户原话。 围绕这些疑问说明需要哪些依据:企业和产品是谁、适合什么需要、能力边界、交付条件、案例或数据,以及价格与责任。重要事实保留出处、时间和适用条件;冲突数字先核对对象与口径。从现有资料做起,不强制先建官网、知识库或新系统。 企业确有能力但难以确认时,可以补事实、比较、演示或案例;客户所需能力尚不具备时,应讨论供给与范围选择。案例说明问题、办法、结果及限制,帮助相似客户判断适配;试用、样品、到店体验和专业确认仍有自己的作用。 先解释内容帮助谁完成什么判断,再决定载体和分布。例如差异说明支持候选比较,演示支持适配确认,费用与预约信息支持行动。不预设文章配比、内容数量或每类问题都做一遍。四项检查与五类问题交叉使用;售后成本可影响购前比较,回答使用问题也不证明企业已经具备交付能力。 ## 根据可见来源安排载体与购买入口 以下条件只用于选择可行方式,实际报告只写与企业有关的安排,不必照抄整表。 | 当前可见条件 | 可考虑的安排与边界 | |---|---| | 回答可见网页来源 | 维护可访问、真实且适用的说明与证据;可见图文、视频来源时,再考虑对应演示。能访问不保证被引用。 | | 产品可呈现商品、门店或预约信息 | 核对当前官方接入资格、地区和能力,维护价格、范围、可用状态及入口;一种卡片不证明支持所有平台。 | | 来源不完全可见 | 保留准确公开信息与有效渠道,不猜固定来源偏好,不承诺写入训练或稳定推荐;无引用不证明没有检索。 | 具体平台能力当次查官方说明,保留模式、地区及日期;未知写条件。不同信息途径可能并用,一次来源不证明固定权重,不许诺通用排名、生效期或内容长度。 把上述安排接到现有业务:客户可能直接点击,也可能记住企业后再搜索、到店或联系销售。说清由哪个岗位确认需求、用什么资料或体验支持判断,以及如何确认费用、时间与责任。按购买周期安排,不强推统一成交时限。完整话术与系统设计按需另做。 ## 用经营变化决定后续投入 观察原先选定的客户是否更容易完成目标行动,依据客户来源陈述、合格咨询、成交或服务记录判断。自然经 AI 被发现、既有渠道成果和新增 GEO 动作的贡献分别看,证据支持到哪里就判断到哪里;站内搜索不能倒推此前问过 AI,一次来源反馈也不证明可规模化。 制作、审核、维护、人员时间和承接都计入成本。已有素材可以减少新增工作,但不是零成本。有效路径可维持;确认一项值得改善的购买障碍后集中修正;需求、真实适配与承接条件具备时再考虑扩大。若供给改善或现有获客更直接,应调整资源顺序。 只给最会改变决定的经营条件及合理复核时点,依据实际销售周期和资源,不编通用门槛。“有限验证”需明确待确认的客户行为或业务条件,不能等同于问完五题。 六部分之后以“最终结论”收束,保留以下六项,篇幅以独立可读、说清因果与取舍为准: - **最终判断**:决定及范围,为什么符合本轮目标和阶段。 - **生意本质**:客户为何付款,企业凭什么被选,增长条件是什么。 - **GEO 的价值**:AI 可能帮助谁完成什么判断,怎样接到业务价值;没有值得投入的作用路径时明确说明。 - **最值得的做法**:优先服务哪类客户,抓住哪项关键条件,简要串起必要行动。 - **投入取舍**:先投什么、暂缓什么,以及哪些经营证据会改变决定。 - **下一步**:固定三行——三十天内的前三件事(动作加负责人);从第几步开始、当前用什么做;什么时候回来重看、哪项经营证据会改变决定。 结论不复述全篇,不新增客群、瓶颈或实施方向。推断在开头、场景选择和结论中都保留相同条件,不能越写越确定。面向企业讲它该如何判断自己的生意,不输出写作提醒、自我声明或内部工作标签。格式按用户需求与宿主能力选择,不自动公开发布、开户、付费或把未获授权的非公开企业资料提交给外部服务。references/report-example.md44 KB69e65007ba68upstream ↗
Contents are not inlined in the catalog. Open the upstream file.
references/ten-ring-handoff.md16 KB22bb7daf9d8fupstream ↗
# GEO 十环路线与生态交接 本文件用于写第六部分和最终结论里的"下一步"。十环是本 Skill 所属开源体系(GEO 全流程「事实飞轮」)的工作骨架,本 Skill 是其中的第 0 环:判断值不值得做。对企业,十环统一叫"第 N 步 · 名称";"十环"这个叫法只在第六部分开头出现一次。 HTML 中先放本企业的章节金句,金句之后,第六部分固定按五块写,顺序不变:**① 十步模型图 → ② 固定介绍(原样复制 SKILL.md 中的那段) → ③ 本企业的起点与范围 → ④ 本企业在每一步的要点 → ⑤ 三十天表与唯一一段工具说明。** 前两块是"教",后三块是"用"。读者此前没见过这十步,先教后用是这一部分能被读懂的前提;第六部分过去最常见的失败,一是跳过教直接用,读者不知道"第 1 环"指什么;二是同一件动作在要点、三十天表和结论里写三遍,读者以为是三件事。 ## 模型图怎么用(第一块) HTML 的轻量排版优先用 [HTML 输出规范](html-report.md) 的 `geo-route`:保留全部十步、顺序、起点、各步状态和回到第 1 步的说明,小屏换行,不把十个节点缩成小字。采用 SVG 时,`assets/ten-steps.svg` 是备用的模型图:上排第 1–5 步(准备与测量)从左到右,下排第 6–10 步(执行与验证)从右到左,第 10 步的箭头回到第 1 步。每个方框是一个 `<g class="box" id="rN">`,按本企业的路线设置状态: | class | 含义 | 样式 | |---|---|---| | `in` | 本轮要做 | 米色底、实线 | | `cond` | 等第 4 步结果后启动 | 浅底、虚线 | | 无 | 本轮只定节奏或暂不做 | 灰色 | | 另加 `start` | 起点 | 粗边框;同时把 `id="start-badge"` 的"起点"徽标移到该方框右上角(徽标默认在第 1 步) | 只改 class 与徽标位置,不改文字、坐标和颜色。图的宽度、字体与配色与第二部分漏斗一致,两张图放在一起不违和。不能渲染时用 SKILL.md 里的固定文字图,并在其后一行写明本企业各步的状态。 ## 十环一览 对企业统一写"第 N 步 · 名称";步骤的通俗解释由第二块的固定介绍承担,要点里不再重复。"过关标准"是企业能自行核对的条件,不是内部编号;不用 G1、意图簇、本体 schema、TBox 一类内部代号。 | 环 | 企业要回答的问题 | 典型动作 | 产出物 | 过关标准 | 常见误区 | |---|---|---|---|---|---| | 1 事实本体 | 我们是什么、给谁、和谁比、凭什么?哪些事实会变、谁负责更新? | 写四件事一页纸;列产品、价格、案例、资质、门店、服务条件等事实;每条附证据;标出会变的事实与更新责任人;对照公开网络上关于企业的说法找出缺失与矛盾 | 四件事一页纸;事实与证据清单;缺失与矛盾清单 | 四件事在官网、平台、销售口径上说法一致;每条对外事实有证据;会变的事实有责任人与更新周期 | 把知识库当本体;把资料喂给 AI 直接出稿;写"行业第一"却拿不出证据 | | 2 业务目标 | 这次要 AI 帮我们改善哪一个业务结果? | 在合格咨询、演示、预约、成交、复购、减少重复解释中选一个;确定用哪条现有记录观察 | 一句目标与一条记录口径 | 只有一个主要目标;记录口径能在现有系统或表格里找到字段 | 把"被提到"当目标;同时追四五个目标 | | 3 用户意图 | 客户真的会怎么问 AI?哪些问题值钱? | 从客服与销售记录、评论区、搜索下拉、行业社群收集真实问句;第五部分的五题作为种子;每条标注来源与决策阶段 | 有出处的问题清单 | 高价值问题不少于二十条;每条有来源;AI 自动生成的问法只作候选、经核对才入库 | 用拓词软件的问题当客户问题;只有品牌词没有品类问题 | | 4 基线检测 | AI 现在怎么说我们?说得对吗?说了谁? | 先手工跑五题看方向;正式基线用 BrandChecker 跑问题清单,勾选平台,保存每题完整回答与引用;按本流程单平台单日单账号不超过 40 次分批,当前平台规则更严格时从严;首次基线后,动作开始一周再测,此后每周 1–2 次 | 首次观察记录;基线原文(每模型一份) | 同一清单、同一记录格式、条件齐全;"提到"和"推荐"分开计;单次只看方向,比例靠多轮累计 | 问一两次就下结论;把"提到"算成"推荐";忽视当前平台规则与限流提示 | | 5 策略形成 | 差距在哪、属于哪一类、先补哪个? | 把 AI 的说法与事实清单逐条对照;归入五类卡点:事实缺失、表述漂移、信源错配、品类未被问、竞品占位;排优先级 | 差距清单与优先级 | 每条差距有卡点类型、对应事实、目标渠道与负责人 | 跳过对照直接写内容;所有差距都用"多发内容"解决 | | 6 内容制作 | 用什么形态把事实变成 AI 能引用的内容? | 从事实清单出发编内容:答案先行、有数字与出处、口径与本体一致、每条主张能回到某条事实;按需要做图文、视频文稿、问答、结构化页面 | 内容包与主张溯源表 | 每条主张能指到一条有证据的事实;没有绝对化用语;没有关键词堆砌 | 先写内容再找事实;一稿改标题多发 | | 7 信源管理发布 | 发到哪、AI 能否抓到、被引用了吗? | 按目标 AI 实际引用的来源类型选阵地;每条链接登记;验证能被搜到;复测时记录是否被引用 | 链接登记簿与可达记录 | 每条链接已登记;能在目标 AI 的检索结果中找到;无效渠道被淘汰 | 以"收录好"选平台;发完不登记;铺三十个媒介 | | 8 持续监测 | 变化了吗?出现错误或负面了吗? | 发布一周后用原题复测,此后每周 1–2 次;每轮作为独立批次出新报告;对照两轮比答案层、引用层、口径层 | 复测原文与报告 | 口径与首次基线一致;节奏固定;不可比项已标注 | 换问题换口径导致不可比;把单次前后变化当因果 | | 9 效果归因 | 带来咨询、成交了吗?哪些内容真有用? | 每条已发布内容打三态标记(有效、仅收录、不收录);台账记录内容 × 媒介 × 模型 × 复测结果 × 业务结果;业务结果来自"从哪知道我们"字段与专属入口 | 归因台账 | 每条已发布内容有标记;结果口径接到现有记录;对外数字附口径与周期 | 拿提及率、收录数当效果;AI 来源与其他渠道相加 | | 10 回流本体 | 事实、问题、渠道要更新什么? | 把新案例、新价格、新问法、无效渠道写回事实清单与问题清单;定下次复看时点 | 更新后的事实与问题清单;下轮计划 | 更新有责任人与日期 | 项目做完就结束;本体无人负责 | 完整性自检沿用四关,各对应一步:找得到(第 7 步)、看得上(第 6 步)、信得过(第 1 步)、接得住(第 9 步)。缺一关的路线不完整。 ## 决定与路线范围(第三块) 路线范围由第三部分的决定确定,不为每家企业写满十步。范围之外的步骤各用一句话说明何时进入。 | 第三部分的决定 | 路线范围 | 三十天内必须完成 | 进入下一段的条件 | |---|---|---|---| | 暂缓 | 只做第 1 步最小版:四件事一页纸,放在客户能看到的自有阵地 | 一页事实;写清重新考虑的触发条件 | 出现触发条件(客户开始向 AI 问该品类、有新的差异化能力、有可承接的容量) | | 有限确认机会 | 第 1–4 步 | 四件事;目标与记录口径;二十条有来源的问题(五题为种子);一次首次观察 | 客户行为与经营条件支持继续投入,新增成本与承接可接受;首次观察只用于确定需要核对的内容差距 | | 开始 | 第 1–7 步,并定下第 8–10 步的节奏 | 四件事与会变事实清单;目标;问题清单;首次观察;差距归类;首批内容与链接登记 | 按合格咨询、成交或服务改善、完整成本与容量复核;被找到或引用仅作过程记录 | | 扩大 / 改善 | 先判断卡在哪一步,从那一步补起 | 补齐该环的过关标准 | 该步过关,下一步有可比数据 | | 维持 | 第 8–10 步的节奏 | 一次复测;一次事实更新 | 复测出现错误、负面或竞品变化时回到第 5 步 | 判断"卡在哪一步"的办法:从第 1 步开始逐步核对过关标准,第一个不过关的步骤就是起点。已有 AI 获客的企业通常卡在第 1、3、9 步之一:事实各处说法不一,问题清单没有来源,或者结果记录没有 AI 来源字段。 ## 把五题接进第 3、4 步 第五部分的五题和记录表不是孤立的动作,它们是第 3、4 步的种子: - **进第 3 步**:五题直接进入问题清单,来源按实际标注为"客户原话"或"本报告模拟问法"。补到二十条以上时,优先从客服与销售记录、评论区、搜索下拉、行业社群取,每条写出处。 - **进第 4 步**:五题在一个产品上的回答是一次五问的首次观察,只能看方向:有没有提到、位置、语气、提到了谁、引用了什么。要报"提及率"这类比例,需要用同一套清单在同一模型上多轮累计(每周 1–2 次),单次结果不能代表客户看到的分布,因为 AI 的回答本身是随机的;本流程按单平台、单日、单账号不超过 40 次分批,但这不是平台安全阈值,当前平台规则更严格时从严执行;足量靠节奏安排。这一点在第 4 步的要点里用一句讲清,企业就明白为什么五题不够、为什么后面要用工具按节奏跑。 - **边界不变**:五题表现不能证明获客效果、需求规模或投资回报,不能作为加码、停止或"修官网"的开关。这条边界沿用第五部分。 ## 每一步的要点怎么写(第四块) 按[十步打法手册](ten-step-playbook.md)各步的"读者看到的形态"写。手册里的打法、分类名、规则是写作者的知识,用来组织内容;报告正文只有本企业的事实、判断、要做的事和做成的样子,不出现"固定打法""核心是""两条路并用""目标只有三种""写成……"这类方法说明。判断标准:企业负责人读到任何一句,都应该觉得"这是在说我们该怎么做",而不是"这是在教人写报告"。 维度多的步骤用表(第 1 步五行表、第 3 步客户问题分组表、第 5 步策略表、第 7 步目标 AI 与阵地表),其余用短段;每步小标题带一句大白话,结尾一段"做到什么算完成"加负责人。等第 4 步结果再启动的步骤只写启动条件与启动后要做的事,不预先写死标题、审核人或发布渠道。第 8–10 步在本轮只定节奏时各写一段。 要点里可以出现工具名(意图探索技能、BrandChecker、实测分析技能、某套内容技能),但工具的状态、获取方式与地址全篇只在第五块讲一次。 ## 三十天表与工具(第五块) 三十天表列"动作|负责人|产出|过关标准",是全报告唯一写全动作细节的地方;每条都是企业不采购任何东西就能完成的事。要点、三十天表、最终结论三处涉及同一动作时,只在三十天表写全,另外两处一句带过。表后一句话说九十天内要完成什么、依赖什么。 工具与交接用一段话讲,顺序固定:先说这些步骤当前都能用共享表格或现有系统完成;再按下方生态清单按步骤列配套工具——第 1 步知识库工具(第三方,按规模写一种主选)、第 3 步意图探索技能、第 4 与第 8 步 BrandChecker、第 5 步实测分析技能、第 6 步九套内容技能——每个写名称、状态和一句话省下什么,有地址或获取方式的写出来,待填的写"可向本报告提供方索取";清单里没有的不编,规划中的不写地址、不写能力、不写价格,付费能力只说明它解决手工做不到的问题。最后一句写交接规范:一次任务一个品牌,按"品牌/批次/阶段"归档到 01 品牌资料至 07 一周复测。不加入课程、社群或服务推广。这样写是因为负责人先看到自己就能走的路,才会相信后面的工具。 成本、责任与承接的判断规则沿用原有要求:交代整理、审核、维护与承接成本,无依据时说明要确认什么,不编人天、报价或月份门槛;AI 来源占比、提及或回答表现单独上升不构成扩大投入的理由;若第三部分决定暂缓,说明更值得的资源去向与重新考虑条件,不强行安排完整建设。 ## 生态清单(维护者更新) 十步各步对应的工具、技能与模板。**状态与获取方式以本表为准**,维护者发布或改名后只需改这一张表,报告写法不变。 | 步 | 工具或模板 | 作用 | 状态 | 获取方式或地址 | |---|---|---|---|---| | 0 | GEO第一性原理(本 Skill) | 判断值不值得做、从哪一步开始 | 已开源 | https://github.com/ALLENLION35/geo-first-principles | | 1 | 知识库工具:Obsidian、Notion、ima 知识库、腾讯乐享知识库 | 按团队规模承载五类事实;大型团队另加本体接入 | 第三方产品 | 各产品官网 | | 1 | 事实本体模板(五类事实清单、动态事实与责任人表) | 把事实整理到一处并附证据 | 规划中 | 待发布 | | 1 | 产品与服务实时更新技能 / 本体接入(ERP、CRM) | 大型团队的动态事实与 AI 实时连接 | 规划中 | 待发布 | | 3 | GEO 意图探索技能(`hrgeo-question-discovery`) | 输入品牌与官网,研究后输出五类七列的《品牌GEO问题布局清单》 | 已发布(技能安装包) | 待填 | | 4、8 | BrandChecker(品牌意图模型实测器 / 品牌认知一致性检测工具) | 按清单在豆包、元宝、千问、DeepSeek 等平台批量提问并保存原文与引用 | 已发布(Windows / Mac 桌面版) | 谷歌应用商店搜索 brandchecker;账号由管理员创建 | | 5 | GEO 问题实测分析技能(`hrgeo-test-analysis`) | 逐题逐模型诊断、机会角色、内容项目 Brief、跨模型生产路线 | 已发布(技能安装包) | 待填 | | 6 | GEO 内容生产技能九套:品牌介绍类、百度百科类、评测指南类、标杆案例类、行业白皮书、亲测种草类(小红书)、携程口碑类(本地生活 + 文旅)、短视频从夯到拉 + 评测、短视频避坑指南 | 按载体把 Brief 与知识库事实写成待审稿 | 已发布(技能安装包,需分别安装) | 待填 | | 7 | 信源清单文章(模型 → 生态 → 阵地) | 候选发布位置与核对依据 | 待补 | 待填 | | 7 | 发布记录表 | 链接登记与可访问检查 | 手工表格(字段见打法手册) | — | | 9 | 归因台账 | 三态标记与业务结果对应 | 手工表格(字段见打法手册) | — | | 10 | 变更记录 | 回流与版本 | 手工表格 | — | | 运行环境 | 支持技能的 Agent | 调用意图探索、实测分析与内容技能 | 第三方产品 | 各产品官网 | 写进报告的规则:状态为"已开源"或"已发布"且有获取方式的,写名称、获取方式和一句话说明省下什么;获取方式为"待填"的,写名称并说"可向本报告提供方索取";"第三方产品"只写名称;"规划中""待补"的写"开源路线图中,当前用手工做法",不给地址、不描述尚未存在的能力;付费能力只说明它解决手工做不到的问题,不写价格、不写效果承诺。 ## 最终结论的"下一步" 最终结论在原有五个标签之后增加第六个,固定三行: - 第一行:三十天内的前三件事,各一句,动作加负责人。 - 第二行:从第几步开始,当前用什么做(表格、现有系统,或已开源的工具)。 - 第三行:什么时候回来重看,哪项经营证据会改变决定。 不新增客群、瓶颈或实施方向,只把第六部分已写的路线压成负责人能转发给同事的三行。 ## 示例 完整示例见[企业报告示例](report-example.md)的第六部分与最终结论:一家虚构库存软件公司在"延续并有限扩展"的决定下,五块齐全、从第 1 步起走到第 7 步、并定下第 8–10 步节奏的写法。references/ten-step-playbook.md20 KB1718ac5e0ef4upstream ↗
# HTML 成品表达提醒 本手册说明十步的分析与行动要求;成品默认按 [HTML 输出规范](html-report.md) 呈现。每步用一句具体金句概括对企业的价值,完整保留依据、动作与完成标准。内部的意图簇、Brief、P0/P1/P2 等用语,在成品中改为客户问题组、内容任务说明、先做/配合/后续;十步正式名称配大白话,不把手册中的方法说明直接搬给企业。 # 十步打法手册 本文件回答"每一步到底怎么做",是**写作者的知识**,不是报告的正文。第六部分第四块按各步的打法组织内容,但读者看到的只有本企业的事实、判断、要做的事和做成的样子;手册里的打法、分类名、规则、"两条路""三选一"这类说法,一个字都不能以方法说明的形式出现在报告里。判断标准:企业负责人读到某一句,能不能立刻知道"这是在说我们该怎么做";如果读起来像在教写报告的人怎么写,就是写错了。 每步分三段:打法(写作者用来组织内容)、读者看到的形态(报告里这一步长什么样)、工具与交接(只从生态清单取,报告里工具全篇只在第五块讲一次)。 ## 通用的交接规范 一次任务只处理一个品牌。按"品牌/批次/阶段"归档,一个批次固定七个文件夹:`01品牌资料`、`02问题清单`、`03基线实测`、`04诊断策略`、`05待审内容`、`06发布记录`、`07一周复测`。每个模型的原始回答分别保存;每轮基线、补采和复测分别保存,不覆盖同名文件。 四个角色可以兼任但每项交付都要有人确认:品牌负责人确认事实与业务范围;营销执行负责实测、资料交接和内容生产;专业审核负责专业表述和发布边界;账号负责人发布并登记链接。 ## 第 1 步 · 事实本体 **打法。** 先分类,再落地。企业事实分五类,每类回答"有什么、缺什么、哪里矛盾、谁负责更新": | 事实类别 | 包含什么 | 典型证据 | |---|---|---| | 身份类 | 品牌主名与别名、所属主体、官网与自有域名、成立与沿革、资质、团队与人员 | 营业执照、许可证、官网、人员资料 | | 供给类 | 产品或服务、适用人群与边界、价格与包含项、不支持的情况 | 价目表、合同模板、产品说明 | | 证据类 | 案例、数据、第三方评价、检测报告、获奖 | 授权案例、检测报告、公开报道 | | 交付类 | 购买流程、交付方式、售后与退费、联系与预约入口 | 服务协议、流程页、售后政策 | | 动态类 | 会变的事实:价格、余位、库存、活动、师资名单、门店 | 经营系统、排班表、更新记录 | 落地方式按团队规模选: | 团队规模 | 知识库工具 | 为什么 | |---|---|---| | 个人或小团队(约 1–5 人) | Obsidian(本地 Markdown,免费),或 Notion 个人版 | 一个人维护,文件即事实,改一处全改 | | 中型团队(约 5–30 人) | Notion 团队版,或 ima 知识库 | 多人协作、权限、链接,可与支持技能的 Agent 配合读取 | | 大型团队或集团 | ima 知识库或腾讯乐享知识库,加本体接入 | 协作与审批之外,动态类事实需要从 ERP、CRM、产品与服务系统实时同步到 AI 可读的知识层 | 本体接入只对大型团队建议;其余用"动态事实清单 + 更新责任人 + 更新周期"手工替代。 事实底稿必须有一个对外能打开的落点:官网事实页、FAQ、价格页、资质页属于第 1 步的落地,不算第 6 步的内容制作,不受"等基线结果"约束;它们的过关标准只到"能打开、能搜到"。 **读者看到的形态。** 小标题"第 1 步 · 事实本体:把【企业】的事实理成一份能对外的底稿"。一张五行表:事实类别|现在有什么|缺什么|哪里矛盾|谁负责,矛盾写到具体是哪两处、说法各是什么。一段"放在哪":推荐一种知识库并说明理由(团队规模、谁维护),是否接实时数据只对大型团队写"建议",其余写"暂不接,用清单替代"。一段"做到什么算完成"。不出现"五类""分类法""打法"这些词,表头本身就是分类。 **工具与交接。** 产出进 `01品牌资料`。知识库工具是第三方产品,只写名称。 ## 第 2 步 · 业务目标 **打法。** 目标按成交方式分三种,选一种:线索型(ToB,以及教育、医美、家装这类高客单、需到店或咨询才能成交的 ToC 服务)拿客资与预约;成交型(可在线下单的商品)促成可追踪的购买,是否能在 AI 内下单须核对当前能力,其他路径按实际官网或平台订单记录;品宣型(大型品牌)让 AI 准确介绍品牌并消除幻觉与负面。目标必须承接第三部分(AI 能改变谁的什么决定)和第四部分(优先情境、五类问题的主次),并且说清 GEO 作用在漏斗的哪一环、整条闭环怎么走。 **读者看到的形态。** 小标题"第 2 步 · 业务目标:这次 GEO 要为【企业】拿到什么"。五段,每段一个粗体小题: 1. **业务目标一句话**:一个每月能数出来的结果,写清"合格"指什么样的客户。 2. **GEO 作用在哪一环**:写明漏斗第几步,以及 GEO 不负责的环节(实地、签约、交付由人完成)。 3. **闭环怎么走**:一条链——客户向 AI 提问 → AI 回答里出现企业及可核验事实与真实页面 → 客户进入官网或咨询 → 记录(来源字段)→ 目标动作(预约/下单/留资)→ 成交 → 按月统计(第 9 步)→ 写回事实底稿(第 10 步)。然后指出本企业现在缺链上的哪几环、由第几步补。 4. **用什么看变化**:现有记录加哪几列;目标数值等基线和首月记录后再定。 5. **不追的目标**:不追提及次数、不追总咨询量等。 报告里只写本企业是哪一种目标及为什么,不列三种给读者选,不出现"目标只有三种"。 **工具与交接。** 无需工具。目标与口径写进 `01品牌资料` 的目标页。 ## 第 3 步 · 用户意图 **打法。** 布局的单位是意图簇——同一个决策下的一组问法——不是零散的问题。簇从第四部分的情境和漏斗步骤推出来,通常四到八组,每组归入五类之一(品牌验证、品类需求、竞品对比、交付使用与售后、行业认知与科普)并给优先级。问题的来源有两条:聚合研究——用 GEO 意图探索技能(`hrgeo-question-discovery`),输入品牌主名、官网、地区、重点品项、已确认竞品、排除项,它研究业务、决策场景、竞品与风险后输出《品牌GEO问题布局清单》(五类、七列:优先级、用户会问的问题、提问场景、用户验证点、GEO价值、GEO布局方向、关联业务,题数以场景饱和为准);真实问法——从咨询记录、销售与客服对话、评论区、社群收集原话,去掉个人信息,校正问法与优先级,第五部分的五题并入。清单锁定后只把问句一列交给实测。 **读者看到的形态。** 小标题"第 3 步 · 用户意图:【客群】会怎么问 AI"。先用客户语言说明要解决的几组问题;然后一张表:客户问题组|客户处在漏斗哪一步|典型问法(两三条,用客户口吻)|五类归属|优先级。表后"问题从哪里来"两条:聚合研究(写本企业的输入项、技能产出的清单长什么样、表里的簇是清单骨架)、真实问法(写本企业从哪些记录取、举两三条原话、五题并入)。再一段"产出与用途"(清单同时是第 4 步实测题与第 6 步内容选题),一段"做到什么算完成"。不出现"两条路并用""意图簇的定义"之类的说明句。 **工具与交接。** 意图探索技能在支持技能的 Agent 里调用;清单进 `02问题清单`,运行技能自带的校验后再锁定。 ## 第 4 步 · 基线检测 **打法。** 先手工,再工具,节奏固定。手工:按第五部分跑五题看方向。工具:正式基线用 BrandChecker(品牌意图模型实测器,软件名"品牌认知一致性检测工具",谷歌应用商店搜索 brandchecker),粘贴清单问句(每行一题),勾选平台,保存每题完整回答、正文内引用标记、参考资料标题与直接 URL;每题独立会话,不追问"为什么没推荐我"。本流程分批上限:单平台、单日、单账号不超过 40 次;这不是平台安全阈值,实际须遵守当时平台规则,更严格时从严执行;工具单批有题数上限,按界面分批。频次:首次基线 → 动作开始后一周 → 每周 1–2 次;单次只看方向,比例靠多轮累计。记录:品牌、批次、日期、模型与可见版本、联网模式、账号类型、执行人、计划与成功失败题数、补采时间;失败题单独补采,空白不记为"未提及"。 **读者看到的形态。** 小标题"第 4 步 · 基线检测:测出 AI 现在怎么说【企业】"。六问列表,每问一行粗体小题加一两句:测什么、在哪测(平台与理由)、测多少(题数与按本流程 40 次上限与当前平台规则安排分批)、多久测一次、用什么测、怎么记。然后"做到什么算完成"与负责人。 **工具与交接。** 原始回答进 `03基线实测`,每个模型一份 Markdown;分批结果合并时保持原题原答、保留分批时间。 ## 第 5 步 · 策略形成 **打法。** 核心是内容形态 + 媒介管理:对每组意图簇、每个目标 AI,先看 AI 现在推荐谁、凭什么来源推荐(平台、发布主体、内容类型、证据作用四个维度)、本企业缺什么,再定做什么载体、发到哪里;全部簇定完就是策略表。正式诊断用 GEO 问题实测分析技能(`hrgeo-test-analysis`),输入清单与 1–4 个模型的实测原文,它逐题逐模型判断品牌出现状态(主体回答、明确推荐、候选入池、背景提及、未提及、信息真空)、答案判定(首推谁、推荐层级、竞争结果)、首推核心支撑源、品牌缺口;给每个"问题 × 模型"一个行动角色;合并为内容项目 Brief(推荐载体、内容骨架、必备证据四态、发布与分发、模型分发变体、复测方案、成功判据、失败动作)和跨模型生产路线。 差距类型(固定介绍里的五种通俗说法)与行动角色的对应,写作者用来预判,报告里用通俗说法: | 差距类型(通俗) | 对应的行动角色 | 典型解法 | |---|---|---| | 事实缺失 | 推荐入池、支撑修复 | 先把事实写在自有阵地 | | 说法不一 | 支撑修复、风险纠偏 | 统一口径,先删矛盾 | | 发错地方 | 推荐入池、解释权占位 | 按当前产品能力与实际可见来源核对候选阵地 | | 没人问这个品类 | 解释权占位或劝退 | 建标准与科普,或暂缓 | | 对手占了位 | 追赶首推 | 补对手被采用的比较维度 | 边界:只在引用里出现不等于被推荐;单次实测只证明观察关联;目标品牌不是首推时不写"守位";不给四个模型复制同一套渠道建议。 **读者看到的形态。** 小标题"第 5 步 · 策略形成:看完实测后,每组问题做什么内容、发在哪"。先三四句讲清策略怎么定(对每组意图簇、每个目标 AI 问三件事,再定内容形态与媒介,定完就是策略表),然后一张策略表:客户问题组|目标 AI|AI 现在推荐谁/凭什么(一律写"待实测")|本企业最可能缺什么(用通俗差距类型,注明以实测为准)|候选内容形态|候选媒介|需要的证据。表后一段"实测后怎么把表填完"(把清单与实测原文交给实测分析技能,它判断什么、给什么行动角色、合并成什么项目,上表以它为准修正)。最后"做到什么算完成"(每簇 × 每 AI 一行判断;每项目有载体、媒介、证据、负责人;"待品牌提供"的证据先补齐再进第 6 步)。不出现"核心是""要准备的输入"。 **工具与交接。** 诊断报告进 `04诊断策略`;正式交付前运行技能自带的证据校验。 ## 第 6 步 · 内容制作 **打法。** 核心是多模型:同一内容项目共享一份事实,按模型分发变体制作不同版本,不在每个平台复制同一篇。内容技能接项目 Brief 加知识库事实,输出待审稿;不虚构案例、数据、体验与背书。载体与技能的对应: | 载体 | 内容技能 | 适合的问题类型 | |---|---|---| | 品牌介绍、品牌观察、"某品牌怎么样" | 品牌介绍类 | 品牌验证 | | 百科词条 | 百度百科类 | 品牌验证、实体确认 | | 第三方测评指南、买家指南、对比文章 | 评测指南类 | 品类需求、竞品对比 | | 标杆案例、客户案例 | 标杆案例类 | 品牌验证、竞品对比 | | 行业白皮书、消费者洞察 | 行业白皮书 | 行业认知与科普、解释权占位 | | 亲测种草图文 | 亲测种草类(小红书) | ToC 比较期、使用体验 | | 文旅与本地生活口碑 | 携程口碑类(本地生活 + 文旅) | 本地生活、到店类品牌验证 | | 品牌横评、红黑榜短视频 | 短视频从夯到拉 + 评测 | 竞品对比、品类需求 | | 避坑指南、验真教程短视频 | 短视频避坑指南 | 交付使用与售后、风险回应 | | 官网 FAQ、事实页、价格页、资质页、服务流程页 | 无对应技能,按 Brief 骨架手工制作 | 全部(基础资产) | 技能名称只用上表这九个;"对比类技能""内容技能"这类泛称不写。对比类内容对应"评测指南类"或"短视频从夯到拉 + 评测"。 发布前审核:每个关键事实能回到知识库或可核验来源;不虚构亲身体验、患者故事、前后对比、成功率、专家背书;品牌自有内容不伪装成独立测评;榜单与比较有标准、来源与适用时间;行业合规由专业人员按发布时规则核对。 **读者看到的形态。** 小标题"第 6 步 · 内容制作(等第 5 步策略表定稿后启动):把事实写成 AI 能引用的内容"。一段说按策略表做、说明当前可见来源或官方能力支持的版本差异,未知则写候选;一个编号列表列首批最可能的两三个项目(载体、用哪套内容技能或手工做、写清什么);一段事实来源与审核三道;一段本行业不能写的表述;"做到什么算完成"。不出现"核心是多模型"这类说明句。 **工具与交接。** 九套内容技能按载体选用,不按编号全跑;待审稿进 `05待审内容`。 ## 第 7 步 · 信源管理发布 **打法。** 发布位置先从与目标客户相关的候选渠道中选择,再按目标产品当前官方能力、模式与第 4 步可见来源核对。下表仅供检索,不代表固定抓取偏好或已确认合作关系: | 目标模型 | 待核对的内容方向 | 候选阵地 | |---|---|---| | 豆包 | 视频与图文 | 抖音、今日头条、抖音电商,兼多平台互证 | | 腾讯元宝 | 公众号与图文 | 微信公众号、视频号、腾讯新闻 | | 通义千问 | 商品与事实说明 | 淘宝/天猫、夸克、权威媒体与百科 | | DeepSeek | 行业数据与研究 | 权威媒体、行业站、数据与研究类内容 | | 文心一言 | 百科与问答 | 百家号、百度百科、百度知道 | | Kimi | 长文 | 知乎、公众号长文、白皮书 | 营销痕迹单独不能证明渠道无效;按事实质量、客户适配与实际可见来源核对。发布记录每条一行:链接、对应项目与问题、平台、账号身份、发布日期、状态;状态三级——页面能打开、搜索能找到、模型回答引用了它——第三级仅表示本轮观察到引用,经营效果另按第 9 步判断。 **读者看到的形态。** 小标题"第 7 步 · 信源管理发布(等第 4 步看到 AI 实际引用什么后启动):发到 AI 真正抓取的地方"。一句说明渠道选择依据,然后一张表:目标 AI|已观察来源/待核对候选阵地|本企业已有|待确认缺口(只列本企业的目标 AI,后续加测的合并一行)。一段先补什么、再按实测补什么、不再铺什么;一段发布登记字段与三级状态;"做到什么算完成"。 **工具与交接。** 发布由有权限的人完成;记录进 `06发布记录`。信源清单文章(待补)发布后加入生态清单。 ## 第 8 步 · 持续监测 **打法。** 从实际发布日算起一周后用 BrandChecker 重跑原题(同一清单、同一品牌身份、尽量相同的模型、模式、账号环境与独立会话);此后每周 1–2 次。新题另建增量测试。每轮复测原文作为独立批次交给实测分析技能出新报告,不覆盖基线;对照两轮报告,逐题比答案层、引用层、口径层。模型升级或条件改变时标注可比性限制。 **读者看到的形态。** 小标题"第 8 步 · 持续监测(本轮定节奏)"。一段:多久测、同题同条件、与基线比哪三层(各用一句本企业的例子说明)、归档在哪。 **工具与交接。** 复测原文与新报告进 `07一周复测`。 ## 第 9 步 · 效果归因 **打法。** 把模型推荐的内容和媒介做好记录统计,给每条已发布内容打三态标记: | 标记 | 含义 | 判定依据 | |---|---|---| | 有效 | 被模型引用或推荐,且推动了第 2 步的业务目标 | 复测报告的答案层 / 引用层 + 业务记录的来源字段 | | 仅收录 | 能被搜到或被引用,但没有进入推荐层,或没有带来目标 | 复测报告 | | 不收录 | 发布后未被找到、未被引用 | 可访问检查 + 复测报告 | 台账列:内容或链接、意图簇、载体、平台、目标模型、发布日期、复测轮次、答案层结果、引用层结果、标记、对应业务结果。业务结果来自第 2 步的记录字段;AI 来源与其他渠道分开看,不相加;提及量与互动量不当成交。 **读者看到的形态。** 小标题"第 9 步 · 效果归因(本轮定节奏):哪些内容真的带来了生意"。三态标记各一句,用本企业的目标动作定义"有效";台账列;业务数字来自第 2 步的哪几列;最后一句"这一步把第 2 步的闭环收上:目标有没有达成,只看……的数,不看提及量"。 **工具与交接。** 台账另建表格维护。 ## 第 10 步 · 回流本体 **打法。** 每轮复盘后回流三样:被验证有效的内容结构写回知识库作为模板;被验证有效的实体与口径写回事实底稿并升版本;无效渠道淘汰、新问法进清单。只有品牌业务、用户需求或问题覆盖变化时才重跑意图探索,日常一轮从实测与分析开始。 **读者看到的形态。** 小标题"第 10 步 · 回流本体(本轮定节奏)"。一段:每季度做三件事(用本企业的例子说明什么叫"有效的内容结构")、什么时候才重跑意图探索。 **工具与交接。** 更新后的知识库与清单版本号递增;变更记录留档。 ## 各步与报告章节的对应 | 步 | 承接报告的哪一部分 | 主要产出 | |---|---|---| | 1 | 第一、三、四部分核对过的事实与未知 | 五类事实清单、知识库选择 | | 2 | 第三部分(价值与适用性)、第四部分(情境与问题主次) | 目标类型、大策略、发力层面、口径 | | 3 | 第四部分五类问题主次、第五部分五题 | 问题布局清单 | | 4 | 第五部分实测操作 | 基线原文与记录 | | 5 | 第一部分对手营销动作、第 4 步结果 | 诊断报告与 P 项目 | | 6 | 第 5 步 Brief | 待审内容 | | 7 | 第 4 步实际引用来源 | 发布记录与信源清单 | | 8 | 第 4 步基线 | 复测报告 | | 9 | 第 2 步口径 | 归因台账 | | 10 | 全部 | 知识库与清单新版本 |assets/feedback-wechat-qr.jpg103 KBf2c901750a3fupstream ↗
Contents are not inlined in the catalog. Open the upstream file.
assets/icon.svg420 B2468028d1ed0upstream ↗
<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg"> <path d="M3 13.5C3 12.1193 4.11929 11 5.5 11H9V21H5.5C4.11929 21 3 19.8807 3 18.5V13.5Z" fill="#FFD400"/> <path d="M15 7H18.5C19.8807 7 21 8.11929 21 9.5V18.5C21 19.8807 19.8807 21 18.5 21H15V7Z" fill="#F75858"/> <path d="M9 5.5C9 4.11929 10.1193 3 11.5 3H12.5C13.8807 3 15 4.11929 15 5.5V21H9V5.5Z" fill="#FFA43D"/> </svg>assets/report-template.html23 KBdf7b939fb7c4upstream ↗
Contents are not inlined in the catalog. Open the upstream file.
assets/ten-steps.svg5.4 KB77107c3adc8cupstream ↗
<svg viewBox="-10 0 850 400" width="100%" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="GEO 落地十步:上排准备与测量,下排执行与验证,末步回到第一步"> <style> .lbl{font-family:-apple-system,"PingFang SC","Microsoft YaHei",sans-serif;} .box rect{fill:#f2f2f4;stroke:#d2d3d9;stroke-width:1.2;} .box text{fill:#66686f;} .box.in rect{fill:#f6efe7;stroke:#8a5a2b;} .box.in text{fill:#1b1b1f;} .box.cond rect{fill:#fbf7f1;stroke:#8a5a2b;stroke-dasharray:5 4;} .box.cond text{fill:#43454d;} .box.start rect{stroke-width:2.6;} .num{font-size:12px;font-weight:700;} .name{font-size:14.5px;font-weight:700;} .gist{font-size:11.5px;} .arrow{stroke:#b8a58c;stroke-width:1.6;fill:none;marker-end:url(#ah);} .band{font-size:12.5px;fill:#8a5a2b;font-weight:700;letter-spacing:1px;} .legend{font-size:11.5px;fill:#6b6e78;} .badge rect{fill:#8a5a2b;} .badge text{fill:#ffffff;font-size:11px;font-weight:700;} </style> <defs> <marker id="ah" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"> <path d="M0,0 L10,5 L0,10 z" fill="#b8a58c"/> </marker> </defs> <g class="lbl"> <text class="band" x="40" y="42">准备与测量 · 第 1–5 步</text> <!-- top row: 1 to 5, left to right --> <g class="box in start" id="r1"><rect x="40" y="56" width="136" height="78" rx="6"/> <text class="num" x="52" y="76">第 1 步</text><text class="name" x="52" y="98">事实本体</text><text class="gist" x="52" y="120">先把事实理清</text></g> <g class="box in" id="r2"><rect x="196" y="56" width="136" height="78" rx="6"/> <text class="num" x="208" y="76">第 2 步</text><text class="name" x="208" y="98">业务目标</text><text class="gist" x="208" y="120">只追一个结果</text></g> <g class="box in" id="r3"><rect x="352" y="56" width="136" height="78" rx="6"/> <text class="num" x="364" y="76">第 3 步</text><text class="name" x="364" y="98">用户意图</text><text class="gist" x="364" y="120">客户真会问什么</text></g> <g class="box in" id="r4"><rect x="508" y="56" width="136" height="78" rx="6"/> <text class="num" x="520" y="76">第 4 步</text><text class="name" x="520" y="98">基线检测</text><text class="gist" x="520" y="120">AI 现在怎么说你</text></g> <g class="box in" id="r5"><rect x="664" y="56" width="136" height="78" rx="6"/> <text class="num" x="676" y="76">第 5 步</text><text class="name" x="676" y="98">策略形成</text><text class="gist" x="676" y="120">差距属于哪一类</text></g> <path class="arrow" d="M176,95 L194,95"/> <path class="arrow" d="M332,95 L350,95"/> <path class="arrow" d="M488,95 L506,95"/> <path class="arrow" d="M644,95 L662,95"/> <!-- down from 5 to 6 --> <path class="arrow" d="M732,134 L732,206 L800,206 L800,260"/> <text class="legend" x="742" y="188">进入执行</text> <text class="band" x="40" y="252">执行与验证 · 第 6–10 步</text> <!-- bottom row: 6 to 10, right to left --> <g class="box cond" id="r6"><rect x="664" y="264" width="136" height="78" rx="6"/> <text class="num" x="676" y="284">第 6 步</text><text class="name" x="676" y="306">内容制作</text><text class="gist" x="676" y="328">事实变成可引用</text></g> <g class="box cond" id="r7"><rect x="508" y="264" width="136" height="78" rx="6"/> <text class="num" x="520" y="284">第 7 步</text><text class="name" x="520" y="306">信源管理发布</text><text class="gist" x="520" y="328">发对地方并验证</text></g> <g class="box" id="r8"><rect x="352" y="264" width="136" height="78" rx="6"/> <text class="num" x="364" y="284">第 8 步</text><text class="name" x="364" y="306">持续监测</text><text class="gist" x="364" y="328">同一套题复测</text></g> <g class="box" id="r9"><rect x="196" y="264" width="136" height="78" rx="6"/> <text class="num" x="208" y="284">第 9 步</text><text class="name" x="208" y="306">效果归因</text><text class="gist" x="208" y="328">看有没有生意</text></g> <g class="box" id="r10"><rect x="40" y="264" width="136" height="78" rx="6"/> <text class="num" x="52" y="284">第 10 步</text><text class="name" x="52" y="306">回流本体</text><text class="gist" x="52" y="328">写回第 1 步</text></g> <path class="arrow" d="M664,303 L646,303"/> <path class="arrow" d="M508,303 L490,303"/> <path class="arrow" d="M352,303 L334,303"/> <path class="arrow" d="M196,303 L178,303"/> <!-- loop back from 10 to 1 --> <path class="arrow" d="M40,303 L22,303 L22,95 L38,95"/> <text class="legend" x="6" y="204" transform="rotate(-90 6,204)">回到第 1 步</text> <!-- start badge --> <g class="badge" id="start-badge"><rect x="150" y="48" width="34" height="18" rx="3"/><text x="157" y="61">起点</text></g> <!-- legend --> <rect x="40" y="368" width="14" height="10" fill="#f6efe7" stroke="#8a5a2b" stroke-width="1.2"/><text class="legend" x="60" y="377">本轮要做</text> <rect x="140" y="368" width="14" height="10" fill="#fbf7f1" stroke="#8a5a2b" stroke-width="1.2" stroke-dasharray="4 3"/><text class="legend" x="160" y="377">等第 4 步结果后启动</text> <rect x="300" y="368" width="14" height="10" fill="#f2f2f4" stroke="#d2d3d9" stroke-width="1.2"/><text class="legend" x="320" y="377">本轮只定节奏或暂不做</text> </g> </svg>.gitignore46 Bb2dc0f5d625aupstream ↗
__pycache__/ *.py[cod] .DS_Store preview.htmlagents/openai.yaml764 B433319b4d028upstream ↗
interface: display_name: GEO第一性原理 short_description: 从生意本质判断GEO是否值得投入,交付带左侧导航与图示的完整HTML、五题自测与十步路线 default_prompt: 使用 $geo-first-principles。企业名称:;主要业务:;客户与地区:;本次目标:;已有 GEO 尝试和结果:。请面向企业负责人讲清生意本质、GEO 价值与投入取舍,默认生成带左侧分级导航、核心金句与轻量图示、内容完整且通俗易读的单页HTML,按六部分给出报告和五题实测操作说明,并以十步路线收口。 icon_small: assets/icon.svg icon_large: assets/icon.svg policy: products: - chatgpt - codex - api - atlas allow_implicit_invocation: trueLICENSE1.0 KB536c6e4329fbupstream ↗
MIT License Copyright (c) 2026 allenlion Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.RELEASE_NOTES.md1.5 KB913549bdda5eupstream ↗
# GEO 第一性原理 1.1 面向企业负责人,默认交付一份可直接打开的单页 HTML,把完整经营分析与可执行的十步路线放在一起。 - 新增桌面左侧分级目录、章节与小节定位、手机目录抽屉和阅读位置提示;使用暖色连续阅读版式。 - 新增并列卡片与操作路径图示,已有数据保留单位、来源与适用条件,不用图形代替完整正文。 - 六部分分析、最终结论与数据来源均保留,每个模块有核心金句;五题可直接复制,宽表保留全部内容。 - 第六部分按十步说明起点、范围、负责人、产出与过关标准,并提供三十天行动安排。 - 使用轻量模板与可选 Python 标准库渲染器,减少重复排版,无外部字体或脚本依赖;关闭 JavaScript 仍可阅读全文。 - 统一模型能力、来源选择和投入判断的证据要求:候选渠道须核对,回答表现不能单独证明经营效果;40 次是本流程分批安排,不是平台安全阈值。 - 修复代码块内标题导致分章失败、格式错误的链接导致生成中断的问题,并增加回归测试。 使用方法:安装完整技能包后,提供企业名称、业务、客户与地区、本次目标,以及已有 GEO 尝试和结果。默认生成 HTML;指定其他格式时按需求交付。 本地渲染需要 Python 3.9+,无第三方依赖。不会自动执行模型实测、发布内容或安装其他技能。实际研究质量与运行时间取决于宿主模型、检索条件和企业资料。tests/test_render_report.py4.1 KB3df8d231a1f4upstream ↗
"""Regression checks for the standalone HTML renderer (standard library only).""" import importlib.util import unittest from html.parser import HTMLParser from pathlib import Path ROOT = Path(__file__).resolve().parents[1] SPEC = importlib.util.spec_from_file_location("render_report", ROOT / "scripts/render_report.py") renderer = importlib.util.module_from_spec(SPEC) SPEC.loader.exec_module(renderer) class RenderReportTests(unittest.TestCase): def test_bundled_example_keeps_complete_structure(self): output = renderer.render(renderer.example_source()) self.assertEqual(output.count('<section class="module'), 8) self.assertEqual(output.count('class="copy"'), 5) self.assertEqual(output.count('class="takeaway'), 18) self.assertEqual(output.count('<table'), 9) self.assertEqual(output.count('<div class="toc-group">'), 8) self.assertEqual(output.count('<figure class="visual visual-cards">'), 3) self.assertEqual(output.count('<figure class="visual visual-flow">'), 1) self.assertIn('allenlion · 1.1', output) self.assertNotIn('{{TITLE', output) def test_code_headings_do_not_split_sections(self): source = '# Report\n\n## One\n\n```markdown\n## Literal heading\n```\n\n## Two\n\nText' output = renderer.render(source) self.assertEqual(output.count('<section class="module'), 2) self.assertIn('<pre><code>## Literal heading</code></pre>', output) def test_malformed_link_preserves_label(self): output = renderer.inline('[Source](https://[example)') self.assertEqual(output, 'Source') def test_unsafe_markup_and_links_are_not_executable(self): output = renderer.inline('<script>alert(1)</script> [bad](javascript:alert(1))') self.assertNotIn('<script>', output) self.assertNotIn('href=', output) self.assertIn('<script>', output) def test_route_rejects_conflicting_states(self): with self.assertRaises(ValueError): renderer.diagram('geo-route', '{"active":[1],"conditional":[1]}') def test_table_rejects_lost_columns(self): with self.assertRaises(ValueError): renderer.blocks('| A | B |\n| --- | --- |\n| value |') def test_sidebar_children_have_unique_existing_targets(self): source = '# Report\n\n## One\n\n### Same\n\nFirst detail.\n\n## Two\n\n### Same\n\nSecond detail.' class Anchors(HTMLParser): def __init__(self): super().__init__() self.ids, self.children = [], [] def handle_starttag(self, tag, attrs): attrs = dict(attrs) if 'id' in attrs: self.ids.append(attrs['id']) if 'toc-child' in attrs.get('class', '').split(): self.children.append(attrs['href'][1:]) parsed = Anchors() parsed.feed(renderer.render(source)) self.assertEqual(len(parsed.ids), len(set(parsed.ids))) self.assertEqual(len(parsed.children), 2) self.assertTrue(all(target in parsed.ids for target in parsed.children)) def test_visual_cards_keep_labels_values_conditions_and_escape_html(self): output = renderer.diagram('geo-cards', '{"title":"Costs","items":[{"label":"Income","value":"36000","text":"<script>bad</script>"}],"note":"Not net profit"}') self.assertIn('visual-cards', output) self.assertIn('36000', output) self.assertIn('Not net profit', output) self.assertIn('<script>', output) self.assertNotIn('<script>', output) def test_visual_flow_keeps_all_stages(self): output = renderer.diagram('geo-flow', '{"title":"Steps","items":[{"label":"Ask","text":"One question"},{"label":"Save","text":"Keep sources"}],"note":"Illustration"}') self.assertEqual(output.count('class="visual-stage"'), 2) self.assertIn('Keep sources', output) def test_visual_requires_explicit_item_text(self): with self.assertRaises(ValueError): renderer.diagram('geo-cards', '{"title":"Costs","items":[{"label":"Income"}]}') if __name__ == '__main__': unittest.main()
Plain-text copy, no login: /skill-bundles/allenlion35-geo-first-principles.md