athena-migrate

Athena 版本迁移工具. v9.6.4 重写: 含 v9.6.2 → v9.6.4 破坏式重构 (sprints/ + compound/ + 4 新 ai_state 文件 + lessons.md 三选项交互).

Repositório: WenJunDuan/Rlues
Última atividade na origem: 28 de maio de 2026 às 01:38
Idioma detectado do SKILL.md: chinês
Estrelas: 184
Forks: 22

Opções de instalação

Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.

npx skills add https://github.com/WenJunDuan/Rlues --skill athena-migrate

O comando permanece em uma só linha. Role horizontalmente para revisá-lo antes de copiar.

Prefere uma cópia local? Baixe os arquivos disponíveis atualmente no SkillsMP.

Revise os arquivos de origem

Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.

SKILL.md

Instruções da origem · Visualização somente leitura

Voltar à pesquisa Voltar à instalação

# v9.6.2 details/ → v9.6.4 sprints/legacy-{date}-v962-merge/
if [ -d .ai_state/details ]; then
  legacy_slug="$(date +%Y-%m-%d)-legacy-v962-merge"
  mkdir -p ".ai_state/sprints/${legacy_slug}/reviews"
  
  # 文件搬迁 (保留全部历史)
  [ -f .ai_state/details/design.md ] && mv .ai_state/details/design.md ".ai_state/sprints/${legacy_slug}/"
  
  # reviews/sprint-N.md → reviews/passN.md (改名)
  for f in .ai_state/details/reviews/sprint-*.md; do
    [ -f "$f" ] || continue
    N=$(basename "$f" | sed 's/sprint-\(.*\)\.md/\1/')
    mv "$f" ".ai_state/sprints/${legacy_slug}/reviews/pass${N}.md"
  done
  
  # cleanup-pass-N.md → cleanup-pass.md (合并若多个)
  cleanup_files=(.ai_state/details/cleanup-pass-*.md)
  if [ ${#cleanup_files[@]} -gt 0 ]; then
    cat .ai_state/details/cleanup-pass-*.md > ".ai_state/sprints/${legacy_slug}/cleanup-pass.md" 2>/dev/null
  fi
  
  # 其他文件 (runtime-events.md / proposals.md 等) 整体搬
  mv .ai_state/details/* ".ai_state/sprints/${legacy_slug}/" 2>/dev/null
  rmdir .ai_state/details
  echo "✓ details/ → sprints/${legacy_slug}/"
fi

检测到 v9.6.2 → v9.6.4 迁移. lessons.md ($(wc -l < .ai_state/lessons.md) 行) 处理选项:

[1] 整体保留为单文件:
    → compound/$(date +%Y-%m-%d)-learning-legacy-v962-migration.md
    (推荐: 保留全部历史, 但不分类 doc_type)

[2] 手工逐段拆分:
    → 我引导你, 每段你分类为 learning/trick/decision/explore
    (推荐: 分类后好搜, 但花时间)

[3] 全部丢弃:
    → 删除 lessons.md, compound/ 从空开始
    (注意: 历史经验丢失. 仅当 lessons.md 全是过时垃圾时选)

选 [1/2/3]:

today=$(date +%Y-%m-%d)
mv .ai_state/lessons.md ".ai_state/compound/${today}-learning-legacy-v962-migration.md"
# 在文件头加 frontmatter (没有则补)

段落 1: "useEffect 依赖项漏掉导致无限循环..."
  分类: [1=learning, 2=trick, 3=decision, 4=explore, s=skip, q=quit]
> 1
  slug (kebab-case): useeffect-deps-infinite-loop
  
✓ 写入 compound/{date}-learning-useeffect-deps-infinite-loop.md (从 templates/learning.md)

echo "⚠️ 确认删除 lessons.md? 备份在 ${backup_dir}/lessons.md 仍可恢复. (y/N)"
read confirm
[ "$confirm" = "y" ] && rm .ai_state/lessons.md

# 用 python 脚本 (或 yq) 升级 frontmatter
# 新增字段: current_sprint_slug / current_roadmap_slug / counts.compound / next_action / 等
# 详见 ~/.claude/skills/pace/templates/_index.md

rm -f .ai_state/lessons.md      # 已迁移
# details/ 已在 Step 3 移除
echo "✓ 旧文件清理"

# 跑 index-updater 重新扫一遍
node ~/.claude/hooks/index-updater.cjs

# 检查新结构
ls .ai_state/sprints/
ls .ai_state/compound/

echo "✓ 迁移完成. 版本: 9.6.4"
echo "  备份: ${backup_dir}"
echo "  如需回滚: rm -rf .ai_state && mv ${backup_dir} .ai_state"

改动	影响
`details/` → `sprints/{date}-{slug}/`	旧路径全失效
`lessons.md` → `compound/{date}-{type}-{slug}.md`	旧引用全失效
`_index.md.current_sprint = N` (数字) → `current_sprint_slug = "..."` (字符串)	hook + skill 全改
`_index.md.lessons_count` → `counts.compound.{type}`	4 个分类计数
`_index.md` 新增 8 字段 (current_roadmap_slug / next_action / last_subagent / 等)	老 frontmatter 不全, 需补
铁律 12 内容变 (subagent 始终用 + worktree 大功能强制)	用户使用习惯需调整

# 备份目录就是回滚点
rm -rf .ai_state
mv .ai_state.backup-{timestamp} .ai_state
echo "✓ 已回滚到 v9.6.2"

athena-migrate

Opções de instalação

Revise os arquivos de origem

/athena-migrate — Athena 版本迁移 (v9.6.4)

当前支持迁移

工作流 (v9.6.2 → v9.6.4)

Step 1: 检测与备份

Step 2: 建新目录骨架

/athena-migrate — Athena 版本迁移 (v9.6.4)

当前支持迁移

工作流 (v9.6.2 → v9.6.4)

Step 1: 检测与备份

Step 2: 建新目录骨架

Step 3: 旧 details/ 迁移

Step 4: lessons.md 破坏式重构 (用户三选项交互)

选项 1: 整体保留

选项 2: 手工拆分

选项 3: 全部丢弃

Step 5: _index.md frontmatter 升级

Step 6: 删除旧模板文件

Step 7: 验证

不向后兼容的破坏式改动

回滚

注意

name	athena-migrate
description	Athena 版本迁移工具. v9.6.4 重写: 含 v9.6.2 → v9.6.4 破坏式重构 (sprints/ + compound/ + 4 新 ai_state 文件 + lessons.md 三选项交互).
effort	medium

athena-migrate

Informações da origem

Opções de instalação

Revise os arquivos de origem

Mais deste repositório

Mais deste repositório

/athena-migrate — Athena 版本迁移 (v9.6.4)

当前支持迁移

工作流 (v9.6.2 → v9.6.4)

Step 1: 检测与备份

Step 2: 建新目录骨架

/athena-migrate — Athena 版本迁移 (v9.6.4)

当前支持迁移

工作流 (v9.6.2 → v9.6.4)

Step 1: 检测与备份

Step 2: 建新目录骨架

Step 3: 旧 details/ 迁移

Step 4: lessons.md 破坏式重构 (用户三选项交互)

选项 1: 整体保留

选项 2: 手工拆分

选项 3: 全部丢弃

Step 5: _index.md frontmatter 升级

Step 6: 删除旧模板文件

Step 7: 验证

不向后兼容的破坏式改动

回滚

注意