Communitygithub.com

MarketingOS 网站规划师

在构建任何内容之前规划一个小型企业网站:一份有来源依据的网站简报、一份搜索意图地图以及一个包含每个页面规范的网站地图(URL、标题、H1、章节、行动号召、证据),所有这些都基于活跃的 MarketingOS 大脑、一次仅针对差距的访谈以及标记为“已测量”、“已观察”或“已假设”的研究。规划在已获批准的方案保存到网站项目后即停止。用于网站规划、网站地图、网站方案、信息架构、搜索意图地图、页面规划或第 2.1 课“规划网站”。不用于构建页面、设计系统 (mos-atomic-design-system)、文案撰写或执行迁移。

MarketingOS 网站规划师 是什么?

MarketingOS 网站规划师技能旨在彻底改变为小型企业规划网站的方式,它利用现有的业务知识(称为“大脑”)以及有针对性的研究和访谈,生成一个可立即执行的结构化网站规划。该技能会系统地生成三个核心交付物:一份有来源依据的网站简报、一份搜索意图地图以及一份包含每个页面完整规范(URL、标题、H1、章节、行动号召和证据)的详细网站地图。其关键区别在于严格的“差距规划”方法:它首先整理已知信息,然后只询问未知信息(差距),最后使用清晰标记为“已测量”、“已观察”或“已假设”的证据开展有针对性的研究。整个过程在获得用户对完整规划的批准后结束,确保规划阶段和后续的构建阶段完全分离,从而消除了基于不完整假设便进行构建的猜测工作。该技能专为 Claude Code 和 Codex 等 AI 代理平台设计,支持逐步工作流程,即使跨会话也能保存进度,交互顺畅且可审计。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/the-vibe-marketing-lab/mos-design-skills/tree/HEAD/mos-design-site-planner

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

MarketingOS 网站规划师 是做什么的?

将业务大脑已掌握的信息,加上一次简短访谈和真实研究,转化为一个可供他人构建的网站规划:一份简报、一份意图地图以及每个页面的一份规范。规划本身就是可交付成果。此技能在获得批准的规划后即止:它绝不构建页面、撰写最终文案、设置重定向或选择视觉设计。

MarketingOS 上下文和前提条件

推荐顺序:mos-design-authentication → EmDash 项目设置 → mos-design-site-planner → mos-atomic-design-system。这些步骤均非硬性前提条件;如果之前的步骤尚未运行,请声明一次并继续执行。

从当前会话及其记录中解析出活跃的业务大脑和网站项目。在询问任何问题之前,请先阅读大脑的 BRAIN.md 或代理指令、CONTEXT.md 以及 business/(品牌、声音、受众、产品、策略、证据、竞争对手)。如果 mos CLI 可用,mos context show --json 会列出每个上下文字段对应的文件。保持每个业务的上下文相互独立。如果没有 MarketingOS,则使用用户提供的文件,并将其他所有内容视为差距。

对于捆绑脚本,请使用 Bun;如果缺少 Bun,请引导用户访问 https://bun.com/docs/installation。将 $SKILL 解析为包含此 SKILL.md 的实际目录;不同代理的安装位置可能不同。

调用方式:在 Claude Code 中使用 /mos-design-site-planner,在 Codex 中使用 $mos-design-site-planner。在 Claude Code 中使用 AskUserQuestion 提问,在 Codex 中作为带有字母选项编号的问题提问。一个初始提示驱动整个工作流程;将所有审批保留在同一对话中。

证据标签

每个研究发现和每个意图声明都带有一个标签:

  • measured (已测量):来自工具或导出的数字(Search Console 点击量、关键词量、抓取计数),并附有具体的数字和带日期的来源 ID。
  • observed (已观察):在某个日期直接看到但未计数(自动补全建议、结果页面、“其他人还问了什么”、竞争对手网站地图、AI 回答),并附有带日期的来源 ID。
  • assumed (已假设):推理或用户陈述,并列明推理原因。

没有来源的发现被视为假设,或者被略去。只有在运行时实际产生了工具访问、关键词量、“其他人还问了什么”问题和业务事实时,才报告它们。

工作流程

在每一步之后将进度保存到 <project>/site-plan/state.json,以便后续会话从停止处继续。文件格式、模板和状态模式:references/output-format.md。

1. 预检

解析大脑、网站项目(其 docs/project.md 或等效的项目笔记)以及任何现有的网站 URL。如果 site-plan/state.json 存在,报告其步骤并在那里继续。检测当前会话中实际可用的研究工具:Search Console 导出或连接的工具、DataForSEO 密钥、爬虫(Scrapling 或简单的 fetch)、网络搜索。测试每个工具;环境中存在的密钥如果测试调用失败,则视为不可用。检测步骤:references/research.md。如果还没有网站项目,询问一次保存位置;大脑的 outputs/YYYY/MM-Mon/YYYY-MM-DD-site-plan/ 是后备位置。

当大脑、项目、保存位置、现有 URL(或“新站点”)以及可用的工具列表都记录在 state.json 中时,此步骤完成。

2. 我已知道的信息

根据大脑构建信息卡片:业务、服务、地点和服务区域、受众、产品、声音、证据和主要行动。每个项目都指明其来源文件,并标记为 confirmed (已确认)(在大脑中明确陈述)、inferred (推断)(字里行间推断出来)或 missing (缺失)。展示信息卡片,并允许用户更正。卡片格式:references/interview.md。

当用户确认或更正了信息卡片时,此步骤完成。

3. 仅针对差距的访谈

仅询问信息卡片标记为“推断”或“缺失”的内容,分批进行,每个问题附带推荐答案及其原因。问题库涵盖目标、收费服务、服务地点、新建站点与替换站点、功能、证据资产、竞争对手和约束:references/interview.md。设计参考资料属于 mos-atomic-design-system 和设计技能;此处不涉及。

当每个简报字段都得到回答或记录为 GAP(差距)时,此步骤完成。

4. 锁定简报

在一个屏幕上回放简报:事实及其来源、差距、研究计划以及任何付费调用及其估算成本。在投入研究时间或金钱之前请求确认。

当用户批准简报时,此步骤完成;并将其记录在 decisions.md 中。

5. 研究

运行预检中发现有效的每种方法:现有站点抓取和 URL 清单、Search Console 查询和着陆页、关键词量(有密钥时使用 DataForSEO,否则使用标记为无量的自动补全)、结果页面和“其他人还问了什么”、竞争对手网站地图,以及可选的 AI 回答检查。缺失的可选来源将添加到研究差距列表,工作继续。方法、后备方案和成本报告:references/research.md。每个来源在 research/sources.md 中都有一个带日期的行。

当每种方法都生成了带标签的发现或一个差距条目时,此步骤完成。

6. 决定页面

将查询聚类为意图,然后应用页面规则:每个意图一个页面,每个收费服务一个服务页面,仅针对具有独特内容的服务区域创建位置页面,进行明确的重复页面检查,并为每个有流量或链接的现有 URL 做出保留、合并、重定向或弃用的决定。使用大脑现有的产品和定位作为框架。规则和测试:references/page-rules.md。

当每个意图都映射到一个页面或带有原因的 none(无),并且每个有流量或链接的现有 URL 都有迁移操作时,此步骤完成。

7. 每个页面的规范

对于每个页面:URL、标题标签、H1、目的、目标意图及其证据、章节大纲、主要行动号召、来自大脑的真实证据(或 GAP: 标记)、内部链接和模式类型。然后编写 site-plan.md 和 sitemap.csv,并以草稿模式运行验证器:

bun $SKILL/scripts/check-site-plan.ts <project>/site-plan --draft

当草稿检查通过时,此步骤完成。

8. 审批循环

显示网站地图树,然后每批显示三或四个页面的规范。对于用户批准、编辑或删除的每个页面:应用编辑,重新运行草稿检查并显示更改内容。将每个决策及其日期记录在 decisions.md 中。重复此过程,直到用户批准整个规划。

当每个页面的最新决策和规划本身都为 approved(已批准)时,此步骤完成。

9. 保存并移交

写入最终文件(site-plan.md、decisions.md、sitemap.csv、research/),将 state.json 设置为已批准,并运行完整检查:

bun $SKILL/scripts/check-site-plan.ts <project>/site-plan

在项目笔记(docs/project.md 或等效文件;在创建之前询问)中添加一条带日期的条目:规划了什么、文件位于何处、检查结果以及下一步操作(通常为 mos-atomic-design-system)。如果网站项目已经是 git 仓库,请通过显式路径暂存规划文件并提交;绝不要暂存密钥、.env 文件或原始工具响应,也绝不要推送。提交规则:references/output-format.md。

最后说明:更改了什么、检查输出、未解决的差距和阻碍,以及确切的下一步行动。仅当检查在当前会话中实际运行并通过时,才报告检查为“已通过”。

参考资料映射表

文件在何时阅读
references/interview.md步骤 2 至 4:信息卡片、问题库、分批处理和简报回放
references/research.md步骤 1 和 5:工具检测、每种研究方法、后备方案和成本
references/page-rules.md步骤 6:意图聚类、位置页面、重复页面、迁移映射
references/output-format.md步骤 7 至 9:验证器强制执行的格式、状态、决策和提交
assets/每个输出文件的起始模板
scripts/check-site-plan.ts--help;在步骤 7 至 9 中运行
scripts/test-check-site-plan.ts证明验证器会拒绝每个有问题的规划

相关技能

来自 MarketingOS GEO 包 (mos-geo-skills) 的可选后续技能,在此列出但需单独安装:mos-geo-topic-clusters 用于在步骤 6 之前聚类大型 Search Console 或 Ahrefs 导出数据,mos-geo-brand-360 用于 AI 回答检查,以及 mos-geo-fan-out-map 用于站点上线后。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能