rankuplisted
Install: claude install-skill yan-labs/yan-skills
# Rankup 2.0
`rankup` 是网站全生命周期的总控 Skill:恢复项目上下文,判断当前阶段,加载必要的专项能力,完成真实验证,并把项目事实、决策与经验写回 `.rankup/`。
它不重复实现 Wrangler、Stripe、趋势研究或外链工具;它负责把这些能力串成一条长期可维护的网站工作流。
## 安装、版本与自动更新
来源:[Skills.sh](https://skills.sh/yan-labs/yan-skills)
```bash
# 全局安装
npx skills add yan-labs/yan-skills --skill rankup -g -y
# 全局更新
npx skills update rankup -g -y
# 项目级更新
npx skills update rankup -p -y
```
本 Skill 的发布版本记录在同目录 `skill.json`。项目的启用时间、已安装版本和最近检查状态记录在 `.rankup/skill-state.json`。
每次激活 `rankup` 时,定位当前 `SKILL.md` 所在目录并执行:
```bash
node "<rankup-skill-dir>/scripts/check-version.mjs" \
--project-root . \
--apply
```
检查脚本默认最多每 24 小时访问一次远端清单。它只更新 `rankup` Skill,不修改业务代码、不部署网站,也不覆盖项目 `.rankup/`。
自动更新在两种情况下必须拒绝执行并报告原因:
- **源码检出**(`source-checkout`):仓库根存在 `.skill-source` 标记,说明当前运行的就是 Skill 源码本身,通常还被全局技能目录符号链接过来。此时更新会覆盖未发布的改动,并把符号链接换回实体目录副本,重新变回双份维护。该标记只在仓库根,`skills add/update` 只复制单个 Skill 子目录,因此不会随安装副本分发,也不会误伤项目级安装。
- **工作区有未提交修改**(`dirty-skill-checkout`)。
若链接已被 `skills update` 换成实体目录,在仓库里运行 `node scripts/link-skills.mjs` 即可恢复;被替换掉的实体目录会先备份而不是删除。
`installedAt` 是当前项目第一次由 `rankup` 初始化或识别时记录的启用时间;Skills CLI 没有可靠的安装后钩子,不得把它描述成 CLI 精确复制文件的时间。
## 强制启动协议
每次使用必须按顺序执行:
1. 读取同目录 `skill.json`,运行上面的版本检查;网络失败时保留当前版本继续,不得伪称已经更新。
2. 读取项目 `.rankup/INDEX.md` 和 `.rankup/skill-state.json`;目录不存在时按 [`references/project-memory.md`](references/project-memory.md) 初始化。
3. 读取 `.rankup/PROJECT.md` 及当前任务相关文件,不要无差别加载整个日志目录。
4. **三方对账门禁**:在回答“接下来做什么”或宣称任何进度之前,必须交叉核对三个来源——`git log --oneline -25`、真实路由/页面清单、线上 `sitemap.