Rankup 3.0

给独立开发者用：做产品，也做关键词流量站、AI 工具、桌面客户端上架商店、付费订阅。 共同点是靠 SEO + GEO 拿免费曝光导到自己的平台；市场是全球，任何语种任何国家，有流量就做。 本文件只做两件事：把一句话落到七段生命周期的哪一段，以及每段的硬规则。怎么干活的纪律在 [references/discipline.md](references/discipline.md)。

一句话落到哪一段

用户不会说「跑一下 seo-audit.mjs」，他会说下面这些话。命中就照入口走，不要自己现编步骤。

越模糊越不要盲跑全套：有明确对象就先跑最便宜的那个脚本；只有方向没对象就先 rankup check；连站都没有只问一个问题（有没有想好的词），不要连问三个。

七段生命周期

旧的 12 阶段编号与七段的映射表在 [lifecycle.md](references/lifecycle.md) 顶部；项目里旧 checks.md 按它对照。每段四块：触发 / 入口 / 硬规则 / 闸门。不写操作步骤。

1 调研

• 触发：给了一批数据、一个词、一个帖子、一个域名，问「能不能做」。
• 入口：[playbooks/research.md](references/playbooks/research.md)（P0 只看输入分流：什么都没有 → P1；一个词 → P2 词根调研；一个域名 → P4）；判读 [demand-discovery.md](references/experiences/demand-discovery.md)；意图核验在 [lifecycle.md](references/lifecycle.md) 段 1 · 1.2；验收单 research-checklist.md（不是入口）。常用脚本：scripts/demand/suggest.mjs（三引擎下拉联想）、scripts/seo-webcafe.mjs kd、backlink/scripts/semrush-keyword.mjs；面板取证 scripts/rankup-cli.mjs（npx @yan-labs/rankup audit similarweb）。

• 闸门：[checklists.md](references/checklists.md) 段 1。

2 立项与定位

• 触发：方向已有，问做不做、做哪个语种、做成什么形态。
• 入口：[lifecycle.md](references/lifecycle.md) 段 2；语种探测 [trends.md](references/trends.md) W1；裁定 [zero-to-one.md](references/experiences/zero-to-one.md)、[webcafe-topics.md](references/experiences/webcafe-topics.md) 七。

• 闸门：[checklists.md](references/checklists.md) 段 2。

3 建站与开发

• 触发：「帮我搭起来」，或开发中把本 Skill 当规范挂着。
• 入口：[lifecycle.md](references/lifecycle.md) 段 3 + [cloudflare-stack.md](references/cloudflare-stack.md)（脚手架命令原文、资源选择、8.6 邮箱）；三方库/服务优先见 [integrations.md](references/integrations.md)。常用：gh repo create --private、wrangler types、对 dev server 跑 scripts/seo-audit.mjs。

• 闸门：[checklists.md](references/checklists.md) 段 3。

4 上线前 SEO / GEO

• 触发：「能不能上线了」「TDK」「密度」「怎么被 AI 引用」「站慢不慢」。
• 入口：[lifecycle.md](references/lifecycle.md) 段 4；判读 [seo-box.md](references/seo-box.md)、[seo-webcafe.md](references/seo-webcafe.md)、[seo-growth.md](references/seo-growth.md) 三-B。常用：scripts/seo-audit.mjs --sitemap、scripts/pagespeed.mjs plan --strategy both、scripts/is-agentic.mjs scan --save、seo-webcafe.mjs audit / chat。写文案的兄弟 Skill：中文 /write（先确认它的五个附属 Skill 都在，缺的用 find-skills 装齐；装不上才退到 /human-writing 起稿 + /shuorenhua 去 AI 味）；被 AI 引用的内容形状读 /ai-seo 的 content-patterns；JSON-LD 模板只读 /seo-geo 的 schema-templates，不跑它的脚本；配图 /imagegen。分工与加载条件见 [skill-ecosystem.md](references/skill-ecosystem.md)。

• 闸门：[checklists.md](references/checklists.md) 段 4。

5 上线与接入

• 触发：「数据检测平台都接入了吗」「这个域名能不能用」「提交 sitemap」「把 Ahrefs 的检验结果都修了」。
• 入口：[lifecycle.md](references/lifecycle.md) 段 5；[search-platforms.md](references/search-platforms.md)、[analytics-platforms.md](references/analytics-platforms.md)；域名接入 [cloudflare-stack.md](references/cloudflare-stack.md) 8.5。常用：scripts/cf-analytics-setup.mjs、scripts/indexnow-submit.mjs、scripts/webmaster-sitemap.mjs、scripts/ahrefs-site-audit.mjs。

• 闸门：[checklists.md](references/checklists.md) 段 5。

6 外链

• 触发：「帮我搞点外链」「去哪发」「竞品的外链哪来的」「有没有毒」「发个 Product Hunt」。
• 入口：backlink Skill（未装：npx skills add yan-labs/yan-skills --skill backlink -g -y）；判据 [webcafe-topics.md](references/experiences/webcafe-topics.md) 五；发布平台 [product-launch.md](references/product-launch.md)。

• 闸门：[checklists.md](references/checklists.md) 段 6。

7 变现与监控

• 触发：「没人付费」「定价怎么定」「接 PayPal」「AdSense 被拒」「流量掉了」「排名没了」。
• 入口：[monetization.md](references/monetization.md)（Stripe / PayPal / 广告 / 订阅 / 商店上架）、[conversion.md](references/experiences/conversion.md)、[evolution.md](references/evolution.md)；掉量排查 [webcafe-experiences.md](references/experiences/webcafe-experiences.md) 十七～十九。常用：scripts/is-agentic.mjs diff、scripts/review.mjs。转化文案与定价页用 /marketing-psychology（锚定、社会认同、损失厌恶、默认效应），找新渠道用 /marketing-ideas；两者只给角度，采不采纳按 conversion.md 的可采纳分档判，暗黑模式不采。

• 闸门：[checklists.md](references/checklists.md) 段 7。

红线速查

主线：维护 checklist，使用 checklist

每段都有一套 checklist。不过 check 不许进下一段；每轮迭代新做的东西，把相关 check 重新过一遍。这是硬门槛。

• 闸门 check 在 [references/checklists.md](references/checklists.md)：每段一张表，判「这段能不能算完」。
• 步骤 check 在 [lifecycle.md](references/lifecycle.md) 各段「步骤 check」，判「这一步做对了没有」，每做完一步就核。
• 状态记在项目侧 .rankup/checks.md：✅ + 证据在哪个文件哪一段 + 日期；做不了标 ⏸ 写清卡在哪；开新一轮把标「每轮」的打回 ⬜。
• 判断由你做，不找脚本代劳：scripts/review.mjs 只给文件层面的缺口，500 字节的 audit.md 能让脚本变绿，里面是不是全站逐 URL 只有你看得出来。
• 判据在 checklists.md，操作在各自的 md，两处不得各存一份——同一件事写两遍，改了一处另一处就静默过期。
• 缺 check 时先补进 checklists.md 再去做，顺序反了这一条只会存在于那次对话里。

命令

rankup check

用户说「现在该做什么」「一步步来」「我们开始执行这个项目的计划」时的唯一动作。编排在 [playbooks/site-review.md](references/playbooks/site-review.md) 第二节。

1. 读 [references/checklists.md](references/checklists.md) 与项目 .rankup/checks.md；跑一次 scripts/review.mjs 拿文件层线索。
2. 找到第一个没过闸的段，逐项去真实代码、线上响应、后台读数核对。
3. 保持轻量：零配额、不派七组 agent。 命中升级判据（已上线但 audit.md 缺失、.rankup/ 不存在、动过线上 URL 且超过一轮没体检、用户问的其实是「站有什么问题」）时，明说「这已经不是 check，是 review」，然后直接转全站体检，不回来问。
4. 直接照着做，不把清单念给用户；做完逐项在 checks.md 记 ✅ 与证据。

rankup init

适用于全新项目，也适用于做了很久但还没有 .rankup/ 的项目——后者是常态，不得因为缺记忆就重建技术栈。

1. 摸清现状再写字：package.json、路由清单、部署配置、git log；已上线的再取线上 sitemap.xml、robots.txt、首页响应。
2. 外部系统一律实时查询（域名解析、Cloudflare、GSC、支付），不采信文档。
3. 按 [project-memory.md](references/project-memory.md) 建 .rankup/ 全套；取不到的写 待确认，不猜。integrations.md 用完整平台表初始化全部 ⬜（[discipline.md](references/discipline.md) 十）。
4. 已运行项目补 baseline.md 与 audit.md；roadmap.md 写阶段目标与放弃条件。
5. 绿地项目脚手架跑通后立刻建私有远端仓并推送，.rankup/ 随仓库提交。
6. 汇报：填了什么、哪些 待确认、哪些需要用户提供。凭据只登记名称与位置。已有 .rankup/ 时不覆盖，转为补齐并提示用 review。

rankup review

review 不是「查 .rankup/ 缺哪个文件」，是对这个站本身做一次全面体检。编排在 [playbooks/site-review.md](references/playbooks/site-review.md) 第一节：先摸前提，再一条消息并行派七组 sub agent（技术 SEO / 速度 / GEO / 关键词长尾 SERP / 哥飞二次意见 / 市场规模 / 接入与记忆），最后汇总回写。.rankup/ 不存在、站没上线、拿不到 GSC 三个分支都写死在 playbook 里，不要停下来先 init。

G 组那条线：scripts/review.mjs --project-root . 出五块报告；再挖会话记录 scripts/sessions.mjs --project-root . --days 14 --new-only（--dump 出浓缩稿，消化完才 --mark）。默认加 --new-only，水位线记在 .rankup/review-state.json，不加会把同样的对话重读一遍。浓缩稿里找四类东西：用户的纠正、验证过的结论、踩过的坑与根因、已推翻旧记录的事实（修订原条目，不并列）。 之后：三方对账 → 过全部闸门补缺口 → 接入清单线上实测 → 筛 experience.md → 剥离站点后仍成立的规则回流本 Skill → 补脚本 → 刷新登记表 → 一页结论。能当场修的直接修。

启动协议

1. 读同目录 skill.json，跑 node "<rankup-skill-dir>/scripts/check-version.mjs" --project-root . --apply；网络失败保留当前版本，不得伪称已更新。
2. 读 .rankup/INDEX.md 与 .rankup/skill-state.json；不存在按 [project-memory.md](references/project-memory.md) 初始化，不重建技术栈。只读任务相关文件，不无差别加载日志目录。本轮要碰的每个词、方向、功能、渠道、域名先 grep -i 一遍 .rankup/rejected.md，命中的只有跳过并引用、或写明复活条件已满足两种处置。
3. 三方对账门禁：回答「接下来做什么」或宣称任何进度之前，交叉核对 git log --oneline -25、真实路由清单、线上 sitemap.xml 全量 <loc>。plan.md 的勾选、progress.md、autopilot 状态都是滞后指标；外部状态（Cloudflare、GSC、Stripe、索引、外链）以当前查询为准。不一致先回写 .rankup/ 再继续。
4. 读 [references/checklists.md](references/checklists.md) 与 .rankup/checks.md 定段，不凭印象；需要可复用操作先查跨项目登记表。
5. 做完更新 .rankup/ 事实、决策、计划；把本轮过掉的 check 逐条记进 checks.md，动过线上 URL 的把标「动了 URL」的打回 ⬜。
6. 沉淀义务与是否调用本 Skill 无关：只要项目里有 .rankup/，任何任务完成后都要回写可复用结论，判据是「下次能否少走一遍」。

经验库：规划与迭代之前先翻一遍

[references/experiences/](references/experiences/INDEX.md) 是经验层，回答「该怎么判断、别人踩过什么坑」；方法层回答「怎么操作」。挖需求读 [demand-discovery.md](references/experiences/demand-discovery.md)；规划排优先级读 [zero-to-one.md](references/experiences/zero-to-one.md)；上线后决定改什么读 [conversion.md](references/experiences/conversion.md)；技术 SEO / 站群 / 多语言 / 索引读 [webcafe-experiences.md](references/experiences/webcafe-experiences.md) 与 [webcafe-topics.md](references/experiences/webcafe-topics.md)；往里加东西看 [INDEX.md](references/experiences/INDEX.md) 收录规则。 三条硬约束：经验层不带任何项目信息；每条必须有出处与证据等级（【实测】/【经验】/【猜测】，猜测不得当结论执行）；这些是从业者单点实践，采纳前先问「我们的前提一样吗」，小步验证后写回项目侧。

可复用操作必须落成脚本

任何需要第二次执行的操作，第一次跑通就固化成脚本，不允许下次重新摸索——每次重试都在烧上下文，且结果不可比。判定：「会再做一次」或「换个站换个词就要重跑」。 固化到 <project>/.rankup/scripts/<动词-对象>.mjs，参数化（property、日期、词、国家），在 .rankup/INDEX.md 登记用途、参数、登录态依赖、已验证日期。脚本失败时修脚本，不绕过；失败原因写进脚本头部。登录态、property ID、账号配置属于项目侧，不进本 Skill。

跨项目资产登记表

各项目的 .rankup/ 互不可见，登记表把可复用脚本索引到一处：node "<rankup-skill-dir>/scripts/registry.mjs" scan --roots <存放项目的目录> 整表重建，list 查看。 位置是 Skill 目录下的 registry.md，它必须写出项目名与绝对路径才有用，因此被 .gitignore 排除，并由 scripts/validate-rankup.mjs 断言绝不能被 git 追踪——.gitignore 只是约定，git add -f 就能绕过。扫描根目录来自 --roots、RANKUPPROJECTROOTS 或 ~/.rankup/config.json，绝不写死。启动时查它；只索引不复制；某个脚本被第二个项目用上，考虑把做法回流本 Skill。

安装与版本

先装 opencli（npx skills add yan-labs/yan-skills --skill opencli -g -y）：凡是碰浏览器的动作都落在它那一层，且 OpenCLI 本体要装我们自己的构建，不是应用商店版（商店版默认前台抢标签页，失败不报错）。opencli doctor 报扩展版本过低时照它说的做。

npx skills add yan-labs/yan-skills --skill rankup -g -y   # 全局安装
npx skills update rankup -g -y                            # 全局更新
npx skills update rankup -p -y                            # 项目级更新

发布版本记录在 skill.json；项目的启用时间、已安装版本和最近检查状态记录在 .rankup/skill-state.json。check-version.mjs 最多每 24 小时访问一次远端，只更新本 Skill，不碰业务代码与 .rankup/；遇到源码检出（仓库根有 .skill-source）或工作区有未提交修改时拒绝更新并报告原因，链接被换成实体目录时在仓库里跑 node scripts/link-skills.mjs 恢复。 版本号：patch 文字与小经验；minor 向后兼容的新工作流；major 目录协议或核心行为破坏性变化。发版同时更新 metadata.version、skill.json、验证脚本预期和 README。

经验回流（用户说「把这个经验写进 rankup」「记下来更新到源码里」）：先按 [experiences/INDEX.md](references/experiences/INDEX.md) 收录规则定证据等级与归属层，再按 [evolution.md](references/evolution.md) 晋升门判它进 Skill 还是留项目侧；进 Skill 的写进对应的现有文件（选词进 webcafe-topics.md 一、外链进五、变现进 monetization.md……），不新建文件、不带站名与数字；改完跑 node scripts/validate-rankup.mjs，直接提 main。面板与网页操作口径的修正（Semrush、Similarweb、seo.web.cafe、哥飞论坛、站长工具、任何 OpenCLI 驱动的站）另有一道门：每轮跑完把「对不上」的地方按 [discipline.md](references/discipline.md) 十五分诊，五层全过才改原文档并同步 JSON 与脚本的已验证日期；没过的留在项目 journal/，一次环境故障写成「功能没了」比不回流更糟。

令牌与项目中立

• 第三方工具令牌只有一份，放 Skill 根目录 .env，环境变量优先；细则见 [discipline.md](references/discipline.md) 十一。
• 严禁在 Skill、.rankup/、Git、测试或回复中保存真实密钥、token、密码、私钥、webhook secret、支付敏感数据或个人敏感信息。
• 本 Skill 必须保持项目中立与机器中立：站点名、域名、流量数字、证据出处、account/property ID、本机路径与代理、凭据位置一律不进 Skill；回流一条经验只带走剥离站点后仍成立的规则，证据留在项目侧 experience.md。此约束由 scripts/validate-rankup.mjs 断言，违反即构建失败。
• 不记录未验证猜测；旧经验被证伪时修订原条目，不并列保留冲突结论。