mcpField
U
upgrade-assessment

upgrade-assessment

github.com/yonatangrossAgent 工作流299134 次安装今天更新
代码仓库

关于 upgrade-assessment

upgrade-assessment 面向评估 Claude 模型、Claude Code 或 OrchestKit 升级的团队。它检测环境并扫描代码库、研究版本变化，生成包含准备度评分和优先行动项的结构化 JSON 报告。

主要功能

  1. 01定义升级范围
  2. 02检测环境与版本
  3. 03研究变化及不兼容项
  4. 04扫描代码库中的受影响模式
  5. 05按六个维度评估准备度
  6. 06生成优先级建议

适用场景

  1. 01评估 Claude 模型迁移
  2. 02规划 Claude Code 版本升级
  3. 03评估 OrchestKit 大版本升级
  4. 04检查团队的平台变更准备情况

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/yonatangross/orchestkit --skill upgrade-assessment

安装后在 Claude Code 中输入/upgrade-assessment确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

test-cases.json
references/
output-format.md
recommendation-format.md
scoring-rubric.md
rules/
_sections.md
_template.md
codebase-scan-patterns.md
detection-checks.md
knowledge-compatibility.md
knowledge-evaluation.md

详细介绍

升级就绪度评估

评估平台是否已准备好升级 Claude 模型、Claude Code 版本以及 OrchestKit 插件。生成结构化 JSON 评估报告，涵盖 6 个维度，每个维度的就绪度评分为 0–10 分。

使用时机

  • 升级 Claude 模型之前（例如，从 Sonnet 4 升级到 Opus 4.8）
  • 将 Claude Code 升级到新的主版本或次版本之前
  • 将 OrchestKit 升级到新的主版本之前
  • 评估团队环境是否已准备好进行平台变更时
  • 在模型或平台迁移的发布规划中

快速开始

/ork:upgrade-assessment           # Interactive assessment
/ork:upgrade-assessment --json    # Machine-readable output

6 阶段工作流

阶段 0：范围定义

工具： AskUserQuestion

扫描之前先确定评估范围。询问用户：

你要评估哪类升级？

  1. 完整平台 - 模型 + CC 版本 + OrchestKit（全面评估）
  2. 仅模型 - 切换 Claude 模型（例如，从 Sonnet 4.5 切换到 Opus 4.8）
  3. 仅 CC 版本 - Claude Code 版本升级（例如，从 2.1.32 升级到 2.1.33）
  4. 仅 OrchestKit - 插件版本升级（例如，从 5.x 升级到 6.x）

记录评估范围和目标版本。如果用户没有指定目标版本，则在阶段 2 中查询最新的可用版本。

阶段 1：检测

工具： Bash、Read、Grep、Glob

运行前置条件检查和环境检测。加载详细信息：Read("${CLAUDE_SKILL_DIR}/rules/detection-checks.md")，查看验证脚本和预期输出格式。

阶段 2：调研

工具： WebSearch、WebFetch

调研目标版本的新功能和破坏性变更：

  1. 模型变更： 搜索目标模型的能力、破坏性变更和新增工具支持
  2. CC 版本变更： 搜索变更日志、新的钩子类型、技能格式变更和已弃用字段
  3. OrchestKit 变更： 阅读 CHANGELOG.md，识别新增、移除或重命名的技能，以及钩子迁移需求

调研查询：

"Claude {target_model} capabilities release notes"
"Claude Code {target_version} changelog breaking changes"
"Claude {target_model} vs {current_model} differences"
阶段 3：代码库扫描

工具： Grep、Glob、Read

扫描代码库，查找受升级影响的模式。加载详细信息：Read("${CLAUDE_SKILL_DIR}/rules/codebase-scan-patterns.md")，查看 grep 模式和严重性分类。

阶段 4：评分

使用 platform-upgrade-knowledge 中的评分标准，从 6 个维度为就绪度打 0–10 分。加载详细信息：Read("${CLAUDE_SKILL_DIR}/references/scoring-rubric.md")，查看各维度的阈值、权重和分数解读。

阶段 5：建议

根据阶段 3 的发现和阶段 4 的评分，生成按优先级排序的待办事项。加载详细信息：Read("${CLAUDE_SKILL_DIR}/references/recommendation-format.md")，查看优先级分配算法、工作量估算和建议结构。

输出格式

评估会生成结构化 JSON 报告。加载详细信息：Read("${CLAUDE_SKILL_DIR}/references/output-format.md")，查看完整的架构和示例。

执行说明

仅升级模型时

重点关注阶段 1、2 和 3。关键领域：

  • Agent model: 字段
  • 上下文窗口 / 输出 token 假设
  • 依赖特定能力的技能内容（例如，视觉、音频）
升级 CC 版本时

重点关注钩子兼容性和技能格式：

  • 钩子类型注册表变更
  • 技能 frontmatter 字段的新增或移除
  • 权限规则格式变更
  • 新增或移除的内置工具
升级 OrchestKit 时

重点关注插件结构：

  • Manifest 架构变更
  • 构建系统变更
  • 技能 / Agent 重命名或移除
  • 钩子源代码重组

规则速查

按需使用 Read("${CLAUDE_SKILL_DIR}/rules/<file>") 加载：

规则影响涵盖内容
detection-checks.mdHIGH前置条件检查、环境检测脚本
codebase-scan-patterns.mdHIGHGrep 模式、严重性分类
knowledge-evaluation.mdHIGH6 维评分标准、严重性分类
knowledge-compatibility.mdHIGH版本兼容性矩阵、破坏性变更检测

相关技能

  • platform-upgrade-knowledge - 评分标准详情和兼容性矩阵
  • ork:doctor - 升级后的健康状况验证
  • ork:explore - 用于影响分析的代码库探索
  • ork:verify - 迁移后的变更验证
  • ork:devops-deployment - CI/CD 流水线更新

参考资料

按需使用 Read("${CLAUDE_SKILL_DIR}/references/<file>") 加载：

文件内容
scoring-rubric.md详细的维度评分阈值
recommendation-format.md优先级分配和工作量估算
output-format.mdJSON 报告架构和示例
  • 查看 platform-upgrade-knowledge/references/scoring-rubric.md，了解更多评分详情
  • 查看 platform-upgrade-knowledge/references/compatibility-matrix.md，了解版本兼容性跟踪

评论

支持 Markdown