Rankup
Rankup 是独立开发者的项目全生命周期管理 Skill:调研与需求验证 → 立项与定位 → 建站或做原生 App(macOS、iOS、iPad;不做 Android App,Android 商店只作需求参考)→ 上线前 SEO / GEO → 上线与接入 → 外链获客 → 变现与监控迭代。
SEO 与 GEO 是最主要的获客与验证手段,不是适用边界:项目计划、交接文档、功能迭代、上线运维、项目记录整理都归这里。
每个项目的 .rankup/ 记录长远规划与当前进展,负责跨会话接力;本文件只做入口与路由,细节在 references/,一次任务只读需要的那部分。
取不到的数据写「未知 / 不可用」,不写 0;区分「官方要求」「工具建议」「项目经验」;阶段性汇报不等于完成。
node "<rankup-skill-dir>/scripts/maintain/rankup-clean.mjs" --workspace <工作区> --older-than 7d --apply(单项目用 --project-root <项目>,一周可写 1w,脚本默认7d且只预览,--apply才删除,--dry-run始终只预览)按修改时间直接删除过程数据与 research/journal/reports/evidence 里的旧报告、临时脚本,并按同一时限清理历史 trash;Git已跟踪文件不删、列待确认;Git索引无法核实时整项目禁止删除并标明原因;常驻文件、白名单、状态保留,删除链接改行内文字。不回收、不备份。用户只说“清理一下”默认 7 天,直接执行普通清理不先问。报告按时限默认直接删除;证据和备份(路径含 backup/evidence/snapshot/dump,或 SQL、bak、数据库副本等)只列“待确认”,默认按目录/项目聚合为不超过约50行的待确认清单(路径前缀、文件数、总大小、最新时间、是否被引用);--json保留每项的大小、修改时间、任务/项目、文档引用与能否判断无用;未发现引用不等于无用。主线程逐项核实后问用户,同意后才加 --include-backups <路径…> 纳入删除,仍遵守时限及常驻/状态/运行中保护。
强制流程(先读这张表,再做任何事)
项目任务按下表读取相关入口与接力,再选择任务分支,避免依据过期印象执行;纯只读与轻量任务按对应例外执行。
需要登录态的验收先按测试身份与登录通路复用已有身份、自查通路并遵守测试边界。
一句话落到哪
本表是已进入 rankup 项目流程后的路由,不扩大触发范围。
用户不会说「跑一下 seo-audit.mjs」。命中就照入口走,不要现编步骤;越模糊越不盲跑全套:有明确对象先选对应 playbook,已有项目没有明确动作先 rankup check,连项目与方向都没有时只问一句有没有想好的词或方向。
七段生命周期
每段保留适用场景、入口、原则摘要与闸门指针。硬规则全文(含「为什么」)在各段文件,步骤 check 与操作也在那里;lifecycle.md 是总述、旧编号映射与对账。完成验收只在 checklists.md,关键词与立项裁决只在 entry.md。
1 调研 · 全文
- 触发:一批数据、一个词、一个帖子、一个域名,问能不能做;或只有模糊方向问值不值得做(先进
selection.md)。
- 入口:词级先过入口环节 →
research.md(P0 分流:没东西 P1、一个词 P2、一个域名 P4);裁决只见 entry.md,历史经验见 demand-discovery.md;证据覆盖见 research-checklist.md。常用:scripts/demand/suggest.mjs、官方 gefei-keywords / gefei-competitor、backlink/scripts/semrush-keyword.mjs、面板取证 scripts/rankup-cli.mjs(npx @yan-labs/rankup audit similarweb);问法与采样工具见 seo-geo.md。
- 原则与范围:顺序与两路判读只按 入口环节;GT 测量只按 gpts 基线判读,ChatGPT 问法链路只按
seo-geo.md。
- 闸门:
checklists.md 段 1。
2 立项与定位 · 全文
3 建站与开发 · 全文
- 适用:shadcn、TanStack、Cloudflare 与段 4–6 的网页规则只约束 Web 面;macOS 按
build-macos-apps 专项 Skill,iOS/iPad 按对应原生工具,商店分发读 monetization.md 五;只有 App 时网页项标 N/A。
- 入口:
cloudflare-stack.md(用户指定模板 / 未指定时的默认脚手架命令、资源选择);三方库优先见 integrations.md。
- 原则与范围:Web 面复用现有可访问组件;用户指定模板已有的 shadcn 初始化配置视为同等有效,追加组件仍用
shadcn add,保留键盘、焦点与 ARIA 能力;基础控件边界见纪律十六。品牌图标在开发当天做齐,Day-1 清单见段 3。
- 静态优先:新站的内容页一律预渲染,每页都 SSR 需写明原因;见 cloudflare-stack.md §2.0。
- 红线:建站、上线前与每次 review 必查 Cloudflare 循环消耗与账单熔断;不能证明有界的付费后台触发不得启用,预算告警不当消费硬顶。
- 闸门:
checklists.md 段 3。
4 上线前 SEO / GEO · 全文
- 入口:判读
seo-box.md、seo-webcafe.md、seo-ai-search.md。常用:scripts/sitemap-lastmod-check.mjs <域名>、scripts/seo-audit.mjs --sitemap、scripts/pagespeed.mjs collect --strategy both、scripts/is-agentic.mjs scan --save、scripts/ai-crawler-access.mjs --url <正式域名>、scripts/ua-parity.mjs <url>。
- 原则与范围:本段每次改动后按段 4 全套验收重跑,因为 TDK、布局与性能会相互影响;适用范围与全部闸门按原规则执行。图标专项未通过不许上线。
- 上线前与发布后复核入口:复用
checklists.md D1 / D4 / D12 / D13 / P3(索引水合、Schema 语义、网格与键盘、SSR 可达性、分析去重与真实上报);操作见段 4 文件与 analytics-platforms.md。
- 闸门:
checklists.md 段 4。
5 上线与接入 · 全文
- 入口:
search-platforms.md、analytics-platforms.md、域名接入 cloudflare/domain-email.md。常用:scripts/sitemap-lastmod-check.mjs <域名>、scripts/site-onboard.mjs、scripts/gsc-domain-verify.mjs、scripts/bing-import-from-gsc.mjs、scripts/cf-analytics-setup.mjs、scripts/indexnow-submit.mjs、scripts/webmaster-sitemap.mjs、scripts/yandex-setup.mjs、scripts/ahrefs-site-audit.mjs、scripts/analytics-beacon-check.mjs。
- 原则与范围:按段 5完成部署、索引与接入,并以真实线上证据收口,避免用勾选代替生效状态。
- 闸门:
checklists.md 段 5。
6 外链 · 全文
- 入口:
backlink Skill(未装:npx skills add yan-labs/yan-skills --skill backlink -g -y);判据 webcafe-topics.md 五;发布平台 product-launch.md。
- 原则与范围:外链执行、范围圈定与证据台账见段 6,技术可提交不等于本轮已授权投递。
- 闸门:
checklists.md 段 6。
7 变现与监控 · 全文
红线速查
先查脚本清单,禁止现写等价实现或手点界面,脚本坏了修脚本(discipline.md 二);执行、取数、完成标准与事故判据统一查 discipline.md,AI 探针的通道与证据边界查 seo-geo.md。
- 浏览器通道与公开页面例外统一按纪律五执行,以复用登录态与可复现会话;见纪律五。
- 所有 AI 爬虫必须放行并逐 UA 实测,使公开内容具备被发现与读取的资格;见基础安全与
checklists.md 段 5。
- 部署前必须先把代码合并到对应环境的分支并推送,再经团队流水线部署,防止别人发布时冲掉我们、或我们覆盖别人;生产线改动另须先发预发、构建带装配检查、发布后自测,测试线通过不代表生产线通过;见纪律二十二。
- 令牌保护见文末「令牌与项目中立」;密钥不进回复、日志或仓库,防止泄漏与误提交。
主线:维护 checklist,使用 checklist
每段都有一套 checklist,不过 check 不许进下一段;每轮迭代新做的东西,把相关 check 重新过一遍。
- 闸门 check 在
checklists.md,判「这段能不能算完」;步骤 check 在各段文件,判「这一步做对了没有」。
- 状态记在项目
.rankup/checks.md:✅ + 证据位置 + 日期;做不了标 ⏸ 写清卡在哪;开新一轮把标「每轮」的打回 ⬜。
- 判断由你做,不找脚本代劳:
scripts/review.mjs 只给文件层面的缺口。
- 判据只在
checklists.md,操作只在各自文档;缺 check 先补进 checklists.md 再去做。
命令
rankup check
「现在该做什么」「一步步来」时的唯一动作,编排在 playbooks/site-review.md 第二节。读 checklists.md 与 .rankup/checks.md,跑一次 scripts/review.mjs,找到第一个没过闸的段,逐项去真实代码、线上响应、后台读数核对,直接照着做并在 checks.md 记证据。零配额、不派七组 agent;命中升级判据(已上线但 audit.md 缺失、.rankup/ 不存在、动过线上 URL 且超过一轮没体检、用户问的其实是站有什么问题)就明说「这已经不是 check,是 review」并转全站体检。
rankup init
全新项目,或做了很久还没有 .rankup/ 的项目(常态,不得因为缺记忆就重建技术栈):摸清 package.json、路由、部署配置、git log,已上线的再取线上 sitemap.xml、robots.txt、首页;外部系统一律实时查询;按 project-memory.md 建 .rankup/ 全套,取不到的写 待确认;integrations.md 用完整平台表初始化全部 ⬜(discipline.md 十);已运行项目补 baseline.md 与 audit.md,roadmap.md 写阶段目标与放弃条件;绿地项目脚手架跑通即建私有远端仓;建 git 仓库或初始化 .rankup/ 时跑 node "<rankup-skill-dir>/scripts/maintain/rankup-clean.mjs" --project-root . --install-hook --write-gitignore 装好 pre-commit hook 与 .rankup/.gitignore。已有 .rankup/ 时不覆盖,转为补齐并提示用 review 或 doctor。
rankup review
每轮核 Cloudflare 循环消耗红线,含后台 alarm/通知/重试及真实熔断。对站本身做全面体检,编排在 site-review.md 第一节:先摸前提,再把可独立运行的组按可用并发派出(技术 SEO / 速度 / GEO / 关键词长尾 SERP / 哥飞官方 Skill 数据复核 / 市场规模 / 接入与记忆),主 Agent 汇总回写。A 组含 AITDK 全站报告,Issues 与未满分项一律必修(checklists.md「闸门 4c」)。G 组:scripts/review.mjs --project-root . 出五块报告;会话记录 scripts/sessions.mjs --project-root . --days 14 --new-only(水位线在 .rankup/review-state.json,--dump 消化完才 --mark),从中找用户纠正、验证过的结论、坑与根因、已推翻旧记录的事实(修订原条目)。review 发现 Day-1 项缺失,先回流进段 3 / 段 4 清单再修站。
rankup doctor
整理项目记录,是「维护」章节的显式入口:在用了很久、文档很多的项目上,按 maintenance.md「六」 全量扫描、做经验分拣与回流(项目 / 用户全局层 / Skill 源码 / 别的 Skill,判定见「七」)、清理过时 / 重复 / 任务型内容、原地修订被推翻的结论、目录归位、校验根层 portfolio.md 与 projects.json 条目数、输出整理报告。第一步永远是只读诊断 node "<rankup-skill-dir>/scripts/maintain/rankup-doctor.mjs" --project-root . [--portfolio-root <工作区根>];拿不准的只列给用户,不删。与 check(定位下一步)、review(修站)的分工见该节表格。
启动协议
- 常规执行读
skill.json,跑 node "<rankup-skill-dir>/scripts/check-version.mjs" --project-root . --apply;网络失败保留当前版本,不得伪称已更新。doctor 只整理记录,免版本更新与线上三方对账;任务明确禁止联网、Git 或改动时遵守其范围。
- 三方对账门禁:回答「接下来做什么」或宣称执行进度前,核对
git log --oneline -25、真实路由与线上 sitemap.xml 全量 <loc>;按任务适用面核对,记录与现实不一致先回写。只读问答只核对所问事实,不为此制造状态变化。
- 其余读取、接力与收尾只按表首指针执行。沉淀义务与是否调用本 Skill 无关,细则见
project-memory.md。
经验库:规划与迭代之前先翻一遍
references/experiences/ 回答「该怎么判断、别人踩过什么坑」:挖需求读 demand-discovery.md,规划读 zero-to-one.md,上线后改什么读 conversion.md,技术 SEO / 站群 / 多语言 / 索引读 webcafe-experiences.md 与 webcafe-topics.md。经验层不带项目信息;每条有出处与证据等级(【实测】/【经验】/【猜测】,猜测不当结论);采纳前先问「我们的前提一样吗」。
可复用操作必须落成脚本
在授权修改范围内,将确定会重复的链路本轮参数化并跑通,省掉下轮重写;只读或禁止改脚本的任务只列候选。触发条件、落点与验收见 maintenance.md「五」第 1 条。
跨项目资产登记表
各项目的 .rankup/ 互不可见,登记表把可复用脚本索引到一处:node "<rankup-skill-dir>/scripts/registry.mjs" scan --roots <存放项目的目录> 整表重建,list 查看。它是 Skill 目录下的 registry.md,含项目名与绝对路径,因此被 .gitignore 排除,并由 scripts/validate-rankup.mjs 断言绝不能被 git 追踪。扫描根目录来自 --roots、RANKUP_PROJECT_ROOTS 或 ~/.rankup/config.json,绝不写死;只索引不复制。
哥飞官方 Skill
查关键词、竞品、域名、页面、哥飞经验,按 seo-webcafe.md 检查并加载哥飞官方 Skill 包;未安装则按官方页面安装,再主动读取官方 gefei/SKILL.md 与对应专用 SKILL.md。专用 Skill 设了 disable-model-invocation: true,不会自动触发,必须主动加载。工具怎么调听官方,市场证据与闸门仍由 Rankup 判断。单一查询主 Agent 直接调;多个独立问题才分给子 Agent,收回后统一判读。
安装与版本
先装 opencli(npx skills add yan-labs/yan-skills --skill opencli -g -y):OpenCLI 本体装我们自己的构建,不是应用商店版(商店版默认前台抢标签页,失败不报错);opencli doctor 报扩展版本过低时照它说的做。浏览器通道及会话规则见 discipline.md 五。Web 项目的 Cloudflare 工具链:npm i -g cf、npx skills add yan-labs/yan-skills --skill cf-cli -g -y;现有项目继续用项目锁定的 Wrangler。
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;源码检出(仓库根有 .skill-source)或工作区有未提交修改时拒绝更新并报告原因,链接被换成实体目录时在仓库里跑 node scripts/link-skills.mjs 恢复。版本号规则见 maintenance.md「五」第 6 条。
令牌与项目中立
- 第三方工具令牌只有一份,放 Skill 根目录
.env,环境变量优先;细则见 discipline.md 十一。
- 严禁在 Skill、
.rankup/、Git、测试或回复中保存真实密钥、token、密码、私钥、webhook secret、支付敏感数据或个人敏感信息。
- 本 Skill 必须保持项目中立与机器中立:不带本项目私有出处或身份(站点名、域名、流量数字、account/property ID、本机路径与代理、私有凭据位置);公开供应商地址与必要的公开来源可保留。回流经验只带走剥离站点后仍成立的规则。由
scripts/validate-rankup.mjs 断言。
- 不记录未验证猜测;旧经验被证伪时修订原条目,不并列保留冲突结论。