메뉴
升级 fastnote 仓库中的 PocketBase 版本，包括后端 Go 宿主依赖与前端 JavaScript SDK，并完成最新版本核验、兼容性检查、构建测试与按需提交。用于用户要求“升级 PocketBase 到最新版本”“同步 Go 和 npm 的 PocketBase 依赖”“核实最新 release 并升级”“提交仅包含 PocketBase 升级改动”时。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
为 fastnote 仓库构建发布产物、确定或补建版本 tag、创建或修复 GitHub Release、上传多平台资产并完成最终验收。用于用户提出“发布一个版本 release”“补发 beta 版本”“重新上传 release 资产”“修复 tag 和 release 不一致”“帮我发预发布版本”这类需求时。
fastnote 项目的中文架构师技能。面向前后端一体仓库的结构设计、重构、代码评审与变更落地。前端按 FSD 分层，后端按 `backend/main.go + internal/server + migrations` 组织，适用于 PocketBase Go 集成、同步链路治理、路由编排、编辑器流程、跨端数据契约和部署结构调整。
按 fastnote 的开发计划文档执行研发任务并交付代码、自动化测试与状态回写。用于用户提出“按任务ID开发/根据开发计划落地实现/补自动化测试/执行并更新任务状态”类需求，输入通常是 `docs/开发计划/迭代计划与任务看板.md`、`docs/开发计划/组件与数据契约清单.md`、`docs/开发计划/测试与发布计划.md`。
基于 fastnote 的代码反推 PRD 与当前仓库代码，产出中文“功能拆分 + 技术方案”文档并落盘到 `docs/功能拆分与技术方案/`，默认按“总览 + 分模块”多文件交付。用于版本规划、迭代评审、重构前设计、开发任务拆解，或当用户提出“功能拆分/技术方案/实施方案/从 PRD 到研发落地”类需求时使用。
将 fastnote 的“功能拆分与技术方案”文档转换为开发执行文档（迭代计划与任务看板、组件与数据契约清单、测试与发布计划）。当用户提出“从方案到开发排期/任务拆解/组件设计/测试发布落地”类需求，或需要把 `docs/功能拆分与技术方案/` 产物转为可执行研发计划时使用。
将一句话、几句话或一段简短业务描述扩展为结构化中文需求文档 / PRD 草案的技能。用于需求澄清、想法成稿、版本规划、功能定义、立项前梳理，或当用户只提供简短目标描述，希望输出范围、用户故事、流程、规则、验收标准、风险与待确认问题时使用。
| name | upgrade-pocketbase |
| description | 升级 fastnote 仓库中的 PocketBase 版本，包括后端 Go 宿主依赖与前端 JavaScript SDK，并完成最新版本核验、兼容性检查、构建测试与按需提交。用于用户要求“升级 PocketBase 到最新版本”“同步 Go 和 npm 的 PocketBase 依赖”“核实最新 release 并升级”“提交仅包含 PocketBase 升级改动”时。 |
按当前仓库的实际集成方式升级 PocketBase，不假设“最新版本”已知，不跳过验证，不把无关改动混入提交。
当前 fastnote 仓库同时存在两类 PocketBase 依赖：
backend/go.mod 中的 github.com/pocketbase/pocketbasefastnote/package.json 中的 pocketbase先确认仓库里哪些位置接入了 PocketBase，并记录当前版本。
backend/go.mod、backend/go.sumfastnote/package.json、fastnote/package-lock.jsonrg -n "pocketbase|PocketBase" -S .backend/main.gobackend/internal/server/bootstrapbackend/internal/server/hooksbackend/migrationsfastnote/src/shared/api/pocketbase不要凭记忆判断“最新版本”，必须先查官方或注册表。
cd backend && go list -m -json github.com/pocketbase/pocketbase@latestgh api repos/pocketbase/pocketbase/releases/latestcd fastnote && npm view pocketbase version在最终汇报中写清：
如果 GitHub 页面、Go 模块源、npm 注册表结果不一致，优先信任模块源和注册表；同时说明差异。
只在仓库实际存在 Go 宿主集成时执行。
cd backend && go get github.com/pocketbase/pocketbase@vX.Y.Zcd backend && go mod tidy注意：
go.mod 中的 go 指令一并提升，但必须在结果里明确说明只在仓库实际依赖 pocketbase npm 包时执行。
cd fastnote && npm install pocketbase@X.Y.Z如果前端没有直接依赖 PocketBase SDK，就不要强行添加。
升级后先判断是否只需要锁文件与依赖版本变更，还是要补代码兼容。
重点检查：
core / migrations APIPocketBase 客户端实例化与错误处理是否仍兼容如果没有代码兼容改动，也要明确说明“本次升级仅涉及依赖和锁文件”。
至少执行以下验证；若某一侧不存在则跳过并说明原因。
cd backend && go build ./...cd backend && go test ./...cd fastnote && npx vitest run tests/unit/pocketbase/*.spec.ts tests/unit/hooks/useSync-user-scope.spec.tscd fastnote && npm run build处理验证结果时遵守以下规则：
如果用户要求提交版本，只提交 PocketBase 升级相关文件，不混入工作区里的无关改动。
典型暂存范围：
backend/go.modbackend/go.sumfastnote/package.jsonfastnote/package-lock.json典型提交命令：
git add backend/go.mod backend/go.sum fastnote/package.json fastnote/package-lock.jsongit commit -m "chore: upgrade pocketbase to latest"提交前先看 git status --short，确认未把用户已有文档或其他功能改动带进去。
最终输出至少包含：
go 指令升级