rankup について
Rankupは個人開発者向けのプロジェクト全ライフサイクル管理スキルです。調査・検証から開発、公開、集客、収益化、監視までを扱い、プロジェクトごとの`.rankup/`記録でセッションをまたいで計画と進捗を引き継ぎます。
主な機能
- 01プロジェクトの7段階をガイド
- 02タスクを該当するプレイブックや参考資料へ振り分け
- 03`.rankup/`で計画と進捗を管理
- 04チェックリストと証拠で完了状況を記録
- 05`rankup check`、`rankup init`、`rankup review`のフロー
活用シーン
- 01製品案や検索需要の検証
- 02ウェブサイトやネイティブアプリの構築と公開準備
- 03SEO、GEO、連携、公開準備状況の確認
- 04プロジェクト記録を使った作業の再開
MCP 対応
エージェントスキルであり、MCPサーバーやクライアントではありません。READMEにMCP接続の説明はありません。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ yan-labs/ yan-skills --skill rankupインストール後、Claude Code で/rankupを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
.gitignoredata/provider-capabilities.jsonword-roots.jsonevals/evals.jsontrigger-evals.jsonreferences/analytics-platforms.mdcapability-map.mdchecklists.mdcloudflare-stack.mddemand-sources.mddesign-references.mddiscipline.mdevolution.mdgame-sites.mdreferences/cloudflare/deploy.mddomain-email.mdreferences/demand-sources/competitors-and-roots.mdrevenue-and-ads.mdusers-and-launches.mdvalidation-chain.mdreferences/discipline/browser-rendering.mdreferences/experiences/conversion.mddemand-discovery-sources.mddemand-discovery.mddemand-judgment.mdINDEX.mdwebcafe-experiences-2.mdwebcafe-experiences.mdwebcafe-topics.mdzero-to-one.md詳細
Rankup
Rankup 是独立开发者的项目全生命周期管理 Skill:调研与需求验证 → 立项与定位 → 建站或做原生 App(macOS、iOS、iPad;不做 Android App,Android 商店只作需求参考)→ 上线前 SEO / GEO → 上线与接入 → 外链获客 → 变现与监控迭代。
SEO 与 GEO 是最主要的获客与验证手段,不是适用边界:项目计划、交接文档、功能迭代、上线运维、项目记录整理都归这里。
每个项目的 .rankup/ 记录长远规划与当前进展,负责跨会话接力;本文件只做入口与路由,细节在 references/,一次任务只读需要的那部分。
取不到的数据写「未知 / 不可用」,不写 0;区分「官方要求」「工具建议」「项目经验」;阶段性汇报不等于完成。
强制流程(先读这张表,再做任何事)
项目任务按下表读取相关入口与接力,再选择任务分支,避免依据过期印象执行;纯只读与轻量任务按对应例外执行。
| 触发条件 | 必须先读 | 必须做 | 完成标志 |
|---|---|---|---|
| 开工:项目任务(含工作区根) | 接力协议、项目接力记录 | 按接力与下文启动协议恢复、对账和记录状态 | 接力可续做 |
| 里程碑:产物、决定或后台任务状态变化 | 同上接力协议 | 覆盖当前接力与产物指针 | 接力反映最新状态 |
| 收尾:完成、放弃、叫停或等用户决定 | 维护「一」「二」 | 按轻量路径或五步维护收口;扫描用 scripts/maintain/ref-scan.mjs | 回复有维护摘要与证据 |
| 有项目记录上下文的「继续」「接着做」「上次做到哪」「我们开始执行这个项目的计划」,或读计划 / 交接 / 进度文档 | 同上「新会话怎么接」 | 定位项目 → 读接力(无 .rankup/ 用 HANDOFF.md)→ 核对后台产物与改动 → 直接执行下一步 | 下一步已有执行证据 |
| 选词、调研、找需求(已有主词) | playbooks/entry.md → research.md | 按入口四步顺序与两路判读执行;方向未落主词先走 selection.md,无方向先走 P1,主词出现后回本行 | 入口卡写进 .rankup/research/<词根>-<日期>.md |
| ChatGPT 问法链路、自然推荐验证 | seo-geo.md 步骤 2–3 | 问法、采样、追问与三清单只按该唯一源;词级编排与裁决回 entry.md | 入口卡②有三清单与原始证据指针 |
| 「谷歌质量」「HCU」「E-E-A-T」「AI 内容会不会被打」「内容 review」「垃圾内容政策」 | seo-helpful-content.md | 区分官方口径与业内推断;按单页或站点级自检表核对并留证据 | 对应自检表通过且无红线 |
| 建站、做功能、写 UI | lifecycle/stage-3-build.md、cloudflare-stack.md | 用用户指定模板,未指定则用默认 shadcn 命令;UI 来自组件库,不手写基础控件;当天过完 Day-1 清单;核建设中红线 | checklists.md 段 3 通过 |
| 写页面内容、写文章、写 blog、model 页面、模型对比、产品对比、补参考视频、封面图 | blog(blog/SKILL.md) | 按其分工与流程执行(X 调研交 Grok、成文交 Gemini、review 交 Sonnet),不自己编内容;站内英文页面内容一律走 /blog | sources、成文、review、评判(哥飞评分、AITDK、ChatGPT 匿名问答)、回读证据齐全 |
| 做内页、「把这个词做成页面」 | lifecycle/stage-4-prelaunch.md「新增内页随手清单」 | 页面映射按 段 2 §2.3;目标词登记到 keywords.md;按段 4 完成页面与体检;核建设中红线 | checks.md 记 ✅ 与证据 |
| 上线前体检、「能不能上线」 | checklists.md 段 4、lifecycle/stage-4-prelaunch.md | 全套体检:AITDK、PageSpeed、图标专项、占位专项;重跑不采信上一轮;核建设中红线 | 段 4 闸门全绿,或写明改不动的理由 |
| 接入、绑域名、提交 sitemap、「怎么不收录」 | lifecycle/stage-5-launch.md、search-platforms.md | 先 site-onboard.mjs --check 再执行;接入一律线上实测 | .rankup/integrations.md 逐行有证据与日期 |
| 外链 | backlink Skill、lifecycle/stage-6-backlinks.md | Rankup 只判时机与数量;提交前把候选清单给用户圈定 | 台账有 submitted → public → indexed 证据 |
| 变现、支付、定价 | monetization.md、lifecycle/stage-7-monetize.md | 按分发方式选主通道与备份,目标环境端到端验证 | 验证记录进 .rankup/integrations.md |
| 维护 Skill 本身:改 rankup 源码,或「把这个经验写进 rankup」 | maintenance.md「五」、evolution.md | 全量扫描后改;拆移文档用 scripts/maintain/split-doc.mjs;scripts/maintain/doc-lint.mjs 断链为 0;validate 与相关测试通过;按规则升版本 | node scripts/validate-rankup.mjs 通过 |
「/rankup doctor」「doctor」(整理项目 .rankup/ 记录)、「整理一下项目记录」「.rankup 太乱了」「整理一下 rankup」「把这个项目的 .rankup 重新整理」 | maintenance.md「六」、project-memory.md 目录规范 | 免版本更新与线上对账;rankup-doctor.mjs 只读诊断 → 经验分拣与回流(按四层归属逐条判去向)→ 分三类出计划 → 执行 A、B → 回读校验;C 类与别的 Skill 的经验只列给用户 | 整理报告:改了、删了(从哪找回)、留了、经验分拣表、待用户决定 |
一句话落到哪
本表是已进入 rankup 项目流程后的路由,不扩大触发范围。
用户不会说「跑一下 seo-audit.mjs」。命中就照入口走,不要现编步骤;越模糊越不盲跑全套:有明确对象先选对应 playbook,已有项目没有明确动作先 rankup check,连项目与方向都没有时只问一句有没有想好的词或方向。
| ユーザーの発言 | 段階 | 入口 |
|---|---|---|
| 「ウェブサイトを作るときに AI 動画/画像生成が必要」「Kie を接続」「Kie の音声は使える?」 | 3 | Kie の任意分岐 → モデルスナップショット、登録。機能に応じてプロバイダーを選択し、Kie は必須ではありません |
| プロジェクトの記録に基づくコンテキストがある「続けて」「前回の続き」「前回どこまでやった?」「この計画を見て」「このプロジェクトの計画を実行しよう」 | 現在の段階 | 「必須フロー」の着手・継続の行を参照 |
| 「ニーズを掘り起こして」「最近何ができそう?」「キーワードをいくつか探して」(具体的な語句なし) | 1 | research/p1-discovery.md |
| 「このキーワードを調査して」「このキーワードでいける?」「キーワードを広げて」「xxx のニーズを探して」 | 1 | entry.md → research/p2-keyword-root.md(どの語句もルートキーワードとして扱い、5 つのデータ取得アクションを自動ですべて実行し、聞き返しません) |
| 「マイナー言語で作る」「このキーワードはドイツ語でどう検索する?」「特定の国の市場でキーワードを探して」 | 1 | P2 フェーズ 0.7 着手カード + 3 つの関門;言語の検出は trends.md W1 |
| 「方向性を探して」「この方向性に取り組む価値はある?」「商品選定」「このアイデアを見て」 | 1 | selection.md で方向性の候補を収集し、主要キーワードが出たら entry.md に従って検証・判定 |
| 「アプリにニーズはある?」「iOS/iPad/macOS 製品を探して」 | 1–2 | research.md のアプリ分岐 → 段階 2 2.2 |
| 「誰が稼いでいる?」「このサイトを逆引きして」「投稿にある月収 X は本当?」 | 1 | research.md P4 + demand-sources/validation-chain.md |
| 「この AITDK レポート群を選別して」「競合の異常だけ見て」 | 1 | seo-box.md:aitdk-triage.mjs でオフライン選別 |
| 「トレンド監視を実行」「種の Rising をスキャン」「米国・日本・韓国のトレンド追跡」 | 1–2 | trends-system.md:3 つの地域を順次スキャンし、重複排除、健全性台帳の記録、追跡確認を実施 |
| 「XX と YY はどちらが人気?」「今日、米国で検索されているのは?」「このキーワードには検索ボリュームがある?」 | 1–2 | trends.md(gpts のベースライン判定)、scripts/gt.py |
| 「AI でこのキーワードのニーズはどのくらい?」「候補は ChatGPT に推薦される?」「競合はなぜ AI に推薦される?」 | 1/4 検証 | キーワード単位のオーケストレーションではまず entry.md を読み、質問の流れは seo-geo.md のみに従います。パネルデータは provider-capabilities.md「三・五」を参照 |
| 「公開済みのサイトは ChatGPT に推薦される?」「ChatGPT に推薦されない理由を聞いて」「推薦枠を改善」「GEO のクローズドループ」「再審査」 | 5/6 公開後 | seo-geo-recommendation-loop.md:質問と 3 つのリストを再利用 → 提案を精査 → 改善・公開 → 再審査。サンプリングルールは seo-geo.md のみ参照 |
| 「作れそうなゲームサイトはある?」「ミニゲームの機会を収集/判断」 | 1–2 | game-sites.md:プラットフォーム監視、sitemap の差分、新しいタイトルの選別。以前の日次判断プロトコルは一部のみ対応 |
| 「作る?」「どの言語で作る?」「多言語対応にする?」「ツールとコンテンツサイトのどちらにする?」 | 2 | lifecycle/stage-2-positioning.md |
| 「ウェブサイトを作ろう」「構築して」 | 2→3 | まず段階 2 で立ち上げを決定し、次に段階 3 でユーザー指定のテンプレートに従ってサイトを立ち上げます。指定がなければデフォルトの shadcn コマンドを使います。キーワードツリーがまだなければ段階 1 に戻ります |
| 「機能を作って」「X を追加して」/開発中に「rankup の規約に従って」 | 3–4 | lifecycle/stage-3-build.md:UI はすべて shadcn コンポーネントライブラリから使用します。多機能ツールサイトのナビゲーションでは、まずサイドバー統一規約を読みます。完了後、段階 4 のチェックをすべて実施します |
| 「見栄えのいいページを作って」「Hero はどうデザインする?」「参考になるコンポーネントを探して」/サイト全体のデザインやリニューアル | 3 | 必ず /design を実行し、受賞基準のプロンプトを一字一句そのまま添えてください(全文は stage-3-build.md のハードルール「デザインは必ず /design を使う」を参照)。そのうえで design-references.md から事例を 2~3 件選んで実装します |
| 「下層ページを作ろう」「キーワードに問題がないので、下層ページにして」 | 4 | 「必須フロー」の下層ページ作成の行を参照 |
| 「SEO/GEO に問題がないか見て」「公開できる?」「TDK」「密度」 | 4 | checklists.md の段階 4 + seo-box.md。サードパーティによる再確認では公式の gefei-page を読み込みます(seo-webcafe.md) |
| 「AI に引用されるには?」「llms.txt」「AI エージェントにとって使いやすい?」 | 4 | seo-ai-search.md。推薦枠の対応方法は seo-geo.md を参照。SEO トピックの索引は seo-growth.md |
| 「ロゴ/画像/og 画像を生成」「ウェブサイトのアイコン一式を作成」 | 3–4 | /imagegen で実際に生成します。アイコンセットは scripts/make-favicons.mjs --src <logo.png> --out <public目录> |
| 「このモデルのページを書いて」「ブログ記事を書いて」「ページのコンテンツを書いて」「比較記事を作って」 | 4(公開前) | /blog:サイト内の英語ページのコンテンツにはこれを使い、自分で作成しません |
| 「このページの文案を書いて」「AI っぽさが強すぎる」 | 4 | サイト内の英語ページのコンテンツには /blog を使い、中国語の原稿には引き続き /write を使います。中国語の /write(起稿、改稿、AI っぽさのチェック機能を備えており、他の Skill に依存しません)。コンテンツの形式は /ai-seo に従います。詳細は skill-ecosystem.md を参照 |
| 「サイトの表示は遅い?」「Core Web Vitals」 | 4 | scripts/pagespeed.mjs collect --strategy both を実行し、seo-box.md の一に従って判定 |
| 「このドメインは使える?」「ドメインの過去の問題」 | 5 | 段階 5 の過去履歴チェックゲート + 公式の gefei-domain |
| 「ドメインを購入した」「ドメインを紐付けて」 | 5 | cloudflare/domain-email.md §8.5 ですべての API 経由の紐付け → cloudflare-stack.md §8.8 の基本セキュリティ → domain-email.md §8.6 のメール → 公開前検収 |
| 「すべてのデータプラットフォームを接続した?」「GSC は接続した?」「sitemap を送信」「いつまでもインデックス登録されない」 | 5 | node scripts/site-onboard.mjs --domain <域名> --repo <仓库> --check;search-platforms.md、analytics-platforms.md |
| 「Ahrefs の検査結果をすべて修正して」 | 5→4 | scripts/ahrefs-site-audit.mjs で一覧を取得 → scripts/ahrefs-issues-recheck.mjs で本番環境を再確認 → 修正後、段階 4 のチェックをすべて再実行 |
| 「被リンクを獲得して」「競合の被リンクはどこから?」「Product Hunt に投稿」 | 6 | backlink Skill + webcafe-topics.md の五。公開プラットフォームは product-launch.md を参照 |
| 「誰も課金しない」「クリックされる文案の書き方」「料金ページの構成」「チャネル」「価格の決め方」「PayPal/Anyway を接続」「AdSense に拒否された」 | 7 | monetization.md、payments-anyway.md、conversion.md。切り口には /marketing-psychology、/marketing-ideas を使います |
| 「トラフィックが落ちた」「順位がなくなった」「ペナルティを受けた?」 | 7 | webcafe-experiences-2.md の十七~十九 |
| 「トラフィックが増えた」「ここ数日でなぜ増えた?」「why is traffic up」 | 7 | まずプロジェクトの .rankup/INDEX.md と .rankup/decisions.md を読み、公開中のページとコードを照合して、廃止済みの機能、リダイレクト、実際の機能を確認します。次に GSC の日付/ページ/クエリと分析ソース別に増加分を分解します。URL 移行は seo-experiences-2026-07-late.md の「[2026-07-30] URL 移行期間のページレポートでは旧 URL と新しい canonical を統合して確認する」に従って判定します。クエリが表示されていない場合と未確定の日付は、それぞれ不明として記録します |
| 「今やるべきことは?」「順番に進めて」「今どの段階?」「トラフィックを少し増やして」「サイトを最適化して」「今日 SEO をやって」 | check | rankup check(後述の「コマンド」)。デフォルトではコンバージョン経路を改善します。詳細は段階 7 の冒頭を参照 |
| 「サイトをレビューして」「抜け漏れを確認」「このプロジェクトは軌道から外れている」 | review | rankup review |
| 「この古いプロジェクトを取り込んで」「rankup init」 | init | rankup init → project-memory.md |
「/rankup doctor」「doctor」(プロジェクトの .rankup/ 記録を整理)、「プロジェクトの記録を整理」「.rankup が散らかっている」「rankup を整理して」 | doctor | rankup doctor → maintenance.md「六」 |
| 「グループチャットでは何と言っていた?」「哥飞は何と言っていた?」 | 経験 | 公式の gefei Skill のナレッジベースワークフロー。公開フォーラムは webcafe-forum.md を参照 |
| 「この知見を rankup に書き込んで」 | メンテナンス | maintenance.md「五」の第 2 項 |
| 「管理画面のデータを取得して」「Semrush でこれを調べられる?」 | データ取得 | 哥飞のツールではまず公式の gefei を読み込みます。他のパネルは provider-capabilities.md を参照 |
| 発言内容がこの表にない、または指定された関連 Skill がローカルにインストールされていない | — | capability-map.md → skill-ecosystem.md → integrations.md。find-skills で検索・インストールします。同等の実装をその場で書かないでください |
七段生命周期
每段保留适用场景、入口、原则摘要与闸门指针。硬规则全文(含「为什么」)在各段文件,步骤 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 立项与定位 · 全文
- 触发:方向已有,问做不做、做哪个语种、做成什么形态;主词出现后先读
entry.md。立项后的经营经验见zero-to-one.md。 - 原则与范围:立项裁决只见
entry.md;市场选择、产品形态及问法簇到页面的移交见 段 2。 - 闸门:
checklists.md段 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。 - 红线:建站、上线前与每次 review 必查 Cloudflare 循环消耗与账单熔断;不能证明有界的付费后台触发不得启用,预算告警不当消费硬顶。
- 闸门:
checklists.md段 3。
4 上线前 SEO / GEO · 全文
- 入口:判读
seo-box.md、seo-webcafe.md、seo-ai-search.md。常用: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.mdD1 / 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/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 外链 · 全文
- 入口:
backlinkSkill(未装:npx skills add yan-labs/yan-skills --skill backlink -g -y);判据webcafe-topics.md五;发布平台product-launch.md。 - 原则与范围:外链执行、范围圈定与证据台账见段 6,技术可提交不等于本轮已授权投递。
- 闸门:
checklists.md段 6。
7 变现与监控 · 全文
- 入口:
monetization.md、conversion.md、evolution.md;掉量排查webcafe-experiences-2.md十七~十九;常用scripts/is-agentic.mjs diff、scripts/review.mjs。 - 原则与范围:支付、变现、监控与回流见段 7,按目标分发方式和真实业务证据判断。
- 闸门:
checklists.md段 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 写阶段目标与放弃条件;绿地项目脚手架跑通即建私有远端仓。已有 .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断言。 - 不记录未验证猜测;旧经验被证伪时修订原条目,不并列保留冲突结论。