用途:当上游 PAI 发布新大版本时,为 Ogmios 分支提供一套可重复的升级方法,解决三件事——采纳匹配需求的新模式/技能/钩子、保留自身定制、记录各部分来源。
主要流程分七个阶段: Phase 0 评估:阅读 PAI 发布说明(GitHub 仓库 danielmiessler/PAI → releases),确定版本差(如 6.0→7.0),并选择范围(小补丁、选择性采纳或完整重移植)。 Phase 1 克隆上游: git clone https://github.com/danielmiessler/PAI.git ~/projekt/pai-upstream-vX.Y cd ~/projekt/pai-upstream-vX.Y git checkout vX.Y.0 无标签时用 main。 Phase 2 对比配置:按系统层、各技能、钩子分别 diff,例如: diff -r ~/projekt/pai-upstream/Algorithm.md ~/.claude/system/Algorithm.md diff -r ~/projekt/pai-upstream/hooks/ ~/.claude/hooks/ 技能用循环逐个 diff,结果保存到 ~/projekt/pai-upgrade-{date}/diffs/。 Phase 3 分类 ISC:ADOPT(原样采纳)、ADOPT-WITH-MERGE(采纳上游行为并保留定制)、REJECT(保留自己的)、CUSTOM-ONLY(仅自己所有)、NEW-FROM-UPSTREAM(全新特性),每项记录理由。 Phase 4 编写 PRD:在 ~/.claude/memory/WORK/{slug}/PRD.md 写入前置元数据、版本上下文、每个 ISC 的二元判据与决策。 Phase 5 分阶段执行:按上述类别分别复制、合并、记录或验证,并逐项测试提交。 Phase 6 审计与留存:冒烟测试(启动会话、演练关键技能、确认无回归),更新 ~/.claude/memory/SYSTEM/ARCHITECTURE.md 版本号与变更,写入升级摘要,提交最终状态。
文档约定:每次升级产出 pai-upgrade-{version}-classification.csv(每个 ISC 一行)、pai-upgrade-{version}.md 摘要报告,并更新 ARCHITECTURE.md 版本字段。
反模式:无 PRD 直接升级、不分类就批量采纳、跳过冒烟测试、不记录 REJECT 决定。
限制:资料未提供该技能的安装方式、运行命令、依赖版本、平台支持、耗时或收费信息;上述路径与命令均为示例流程,需按自身环境调整。