version-updates

版本更新工作流

适用场景

准备发布或提升项目版本时，使用此技能。 先运行 Skill(sanctum:git-workspace-review)，记录当前更改。

不适用场景

• 仅更新文档——使用 doc-updates
• 准备完整的 PR——使用 pr-prep

必需的进度项

1. version-update:context-collected
2. version-update:target-files
3. version-update:version-set
4. version-update:docs-updated
5. version-update:verification

步骤 1：收集上下文（context-collected）

• 确认要应用的版本（默认：提升修订号）。
• 如果提示词提供了明确的版本，请记录下来。
• 验证 Skill(sanctum:git-workspace-review) 是否已记录仓库状态。

步骤 2：识别目标（target-files）

• 使用递归搜索查找所有存储版本的配置文件：
  • 根目录：Cargo.toml、package.json、pyproject.toml
  • 嵌套目录：使用 glob 查找 */pyproject.toml、*/Cargo.toml、*/package.json
  • 示例：必须包含 plugins/memory-palace/pyproject.toml
  • 使用 grep -v 排除虚拟环境（.venv、node_modules、target/）
• 包含提及版本的变更日志和 README。
• 使用：find plugins -name "pyproject.toml" -o -name "Cargo.toml" | grep -v ".venv"

步骤 3：更新版本（version-set）

• 自动方式：使用 plugins/sanctum/scripts/update_versions.py <version> 更新所有版本文件
  • 支持 pyproject.toml、Cargo.toml、package.json
  • 自动排除虚拟环境
  • 查找嵌套的版本文件（例如 plugins/memory-palace/pyproject.toml）
  • 先使用 --dry-run 标志预览更改
• 手动方式：使用新版本更新每个目标文件
  • 对于语义化版本，请遵循 MAJOR.MINOR.PATCH 或指定格式
  • 如果项目支持多个软件包，请记录每项更新

步骤 4：更新文档（docs-updated）

• 添加或更新变更日志条目，并填写今天的日期。
• 刷新 README 和文档中的引用，注明新版本及任何发行说明。

含版本引用的关键文档文件

这些文件包含版本号，提升版本时必须检查：

文件	内容
docs/api-overview.md	包含所有插件版本的插件清单表
CHANGELOG.md	版本历史和发行说明
book/src/reference/capabilities-reference.md	可能引用特定版本的功能
插件 README	可能提及插件版本

扫描其他版本引用

# Find all docs mentioning the OLD version
grep -r "1\.2\.6" docs/ book/ --include="*.md" | grep -v node_modules

# Common patterns to search:
# - "v1.2.6", "1.2.6", "(v1.2.6)"
# - Version tables in markdown
# - "Added in X.Y.Z" annotations

更新顺序

1. 更新配置文件（pyproject.toml、plugin.json 等）——自动执行
2. 更新 CHANGELOG.md——添加新版本章节
3. 更新 docs/api-overview.md——更新版本表和插件详情
4. 扫描其他版本引用，并按需更新

步骤 5：验证（verification）

• 如果提升版本需要，运行相关构建或测试（例如 cargo test、npm test）。
• 显示 git status -sb 和 git diff 摘录，以确认版本已提升。

输出说明

• 汇总已更改的文件和新版本号。
• 提及后续步骤（如适用），例如发布或打标签。

退出条件

• 修改任何文件前，创建全部 5 个进度项（从 version-update:context-collected 到 version-update:verification），并按顺序标记为已完成
• 先运行 update_versions.py --dry-run <version>，并在写入任何版本文件前审查其 输出
• 在所有找到的配置文件（pyproject.toml、Cargo.toml、package.json、 plugin.json）中一致地更新版本，确保目标文件无一遗漏
• 更新 CHANGELOG.md，添加一个日期为今天的新版本章节
• git diff 输出确认所有已识别的目标文件中的版本均已更改；向用户报告 更改文件的摘要和新版本号