set-spec-version

分类: 文档与知识管理 | 上传者: farcasterxyz | 下载: 0 | 版本: v1.0（最新）

翻转快照规范默认版本。更新引用当前版本的所有文件 - 常量、文档配置、SKILL.md 文件、模板和 llms.txt。

更新日志: Source: GitHub https://github.com/farcasterxyz/snap

目录结构

当前层级: tree/main/.claude/skills/set-spec-version/

📄 SKILL.md 2.1 KB

SKILL.md

---
name: set-spec-version
description: Flip the snap spec default version. Updates all files that reference the current version — constants, docs config, SKILL.md files, template, and llms.txt.
---

## Overview

This skill upgrades (or downgrades) the snap spec default version across the entire repo.
Use it when the protocol is ready to promote a new version as the default.

## Input

The target version string, e.g. `"2.0"`. Must be one of the values in
`SUPPORTED_SPEC_VERSIONS` in `pkgs/snap/src/constants.ts`.

## Step 1: Update the source of truth

1. In `pkgs/snap/src/constants.ts`, change `SPEC_VERSION` to point to the target version
   constant (e.g. `SPEC_VERSION = SPEC_VERSION_2`).

2. In `apps/docs/src/lib/version-config.ts`, change `DEFAULT_VERSION` to the target
   version string.

## Step 2: Copy the versioned SKILL.md to root

Copy `apps/docs/public/{version}/SKILL.md` to `apps/docs/public/SKILL.md`.

This ensures agents reading the root SKILL.md get the correct version's instructions.

## Step 3: Update the template

In `template/src/index.ts`, change the `version` field in the snap response to match the
new default version string.

## Step 4: Update AGENTS.md files

Check `AGENTS.md` and `template/AGENTS.md` for any version references and update them.

## Step 5: Run sync-protocol-docs

After changing the version, run the `sync-protocol-docs` skill to ensure all downstream
files (docs pages, llms.txt, examples, renderers) are consistent with the new default.

## Step 6: Verify

1. Run `pnpm --filter @farcaster/snap build` — must pass.
2. Run `pnpm --filter @farcaster/snap test` — must pass.
3. Grep for the old default version string in docs and SKILL files to catch any stragglers.

## Checklist

- [ ] `pkgs/snap/src/constants.ts` — `SPEC_VERSION` updated
- [ ] `apps/docs/src/lib/version-config.ts` — `DEFAULT_VERSION` updated
- [ ] `apps/docs/public/SKILL.md` — copied from versioned SKILL
- [ ] `template/src/index.ts` — version field updated
- [ ] `AGENTS.md` / `template/AGENTS.md` — version refs updated
- [ ] `sync-protocol-docs` skill executed
- [ ] Build passes
- [ ] Tests pass

登录后下载/点赞/收藏 ❤ 12 | ★ 0

set-spec-version

目录结构

SKILL.md

举报内容

提示