migration

juliusbrussee/caveman/migration

该技能指导如何实施可逆且兼容性安全的迁移。它强调在编辑前映射当前的读取者、写入者、数据形状、兼容窗口和所有权，并定义前进路径和回滚路径。它要求保留现有数据，使破坏性步骤明确且单独授权，确保在滚动部署期间混合版本操作的安全，并按照扩展、迁移、验证、收缩的顺序进行。重试必须是幂等的，部分失败必须可观察，并且在所需的过渡阶段验证新旧路径。该技能还强调在请求的阶段通过后停止，不要隐式执行后续的破坏性收缩。

安装量 · 964查看来源

Installation

npx skills add https://github.com/juliusbrussee/caveman --skill migration

技能文件

SKILL.md

最近同步 · 2026年8月29日

agents/openai.yaml›

interface:
  display_name: "Migration"
  short_description: "Plan reversible data-safe transitions"
  default_prompt: "Use $migration to implement this transition with compatibility and rollback proof."

SKILL.md›

---
name: migration
description: Implement reversible compatibility-safe transitions. Use for schema, data, API, protocol, configuration, or dependency migrations requiring rollback and preservation proof.
---

# Migration

Map current readers, writers, data shape, compatibility window, and ownership before editing.

- Define forward path and rollback path.
- Preserve existing data; make destructive steps explicit and separately authorized.
- Keep mixed-version operation safe where rollout can overlap.
- Sequence expand, migrate, verify, then contract when applicable.
- Make retries idempotent and partial failure observable.
- Verify old and new paths at required transition stages.

Stop after requested stage passes; do not perform later destructive contraction implicitly.