migration-guidance

Agent Skills › krl-gr/upcomputer › migration-guidance

migration-guidance

GitHub

用于处理 v3 到 v4 API 迁移时的公共模块或 API 变更，包括更新迁移指导、编辑迁移注解及重新生成迁移文档。

.repos/effect-smol/.agents/skills/migration-guidance/SKILL.md krl-gr/upcomputer

触发场景

v3 公共 API 映射到 v4 的变更编辑迁移注解 YAML 重新生成 migration/v3-to-v4.md

安装

npx skills add krl-gr/upcomputer --skill migration-guidance -g -y

更多选项

非标准路径

npx skills add https://github.com/krl-gr/upcomputer/tree/main/.repos/effect-smol/.agents/skills/migration-guidance -g -y

不安装直接使用

npx skills use krl-gr/upcomputer@migration-guidance

指定 Agent (Claude Code)

npx skills add krl-gr/upcomputer --skill migration-guidance -a claude-code -g -y

安装 repo 全部 skill

npx skills add krl-gr/upcomputer --all -g -y

预览 repo 内 skill

npx skills add krl-gr/upcomputer --list

SKILL.md

Frontmatter

{
    "name": "migration-guidance",
    "description": "Use when changing how a v3 public API maps to v4, editing migration annotations, or regenerating migration\/v3-to-v4.md."
}

Update guidance when a v3 public module or API is renamed, moved, removed, replaced, or gains a materially different v4 contract. A v4-only API without a v3 counterpart does not automatically need an annotation.

Account for every affected v3 symbol.
Read annotations.md before adding or changing annotation YAML. Verify every suggested replacement against implementation and tests.
When checking or regenerating the reference, or when the API change exists in a committed ref, read generation.md. Otherwise report that generation is deferred.
When output was generated, inspect it for unrelated movement and stale refs.

The task is complete when every affected v3 symbol is accounted for, annotation replacements are verified, checks and generation succeed when the change is in a committed ref, and every generated difference is explained. Report deferred checks explicitly for uncommitted API changes.