snhrm avatar

fe-eol-checker

フロントエンドの依存パッケージのEOL(End of Life)状況をチェックし、サポート終了やセキュリティリスクのあるパッケージを検出するプラグイン

Install

/plugin install fe-eol-checker@claude-plugin

Run it inside Claude Code after adding the marketplace with /plugin marketplace add snhrm/claude-plugin.

Contents

Discovered from source

Skills 6

コード影響分析スキル

役割: コード検索に特化。破壊的変更の影響を受けるコードを特定する。

入力: 検索対象のAPI/パターン、ソースディレクトリ、テストディレクトリ(呼び出し元から渡される)

検索タスク

1. 影響箇所の検索

破壊的変更ごとに、該当するコードを検索:

# import文の検索
grep -r "import.*{.*oldAPI.*}.*from" --include="*.ts" --include="*.tsx" src/

# 関数呼び出しの検索
grep -rn "oldFunction\s*(" --include="*.ts" --include="*.tsx" src/

# Props使用の検索
grep -rn "deprecatedProp" --include="*.tsx" src/

2. テストファイルの特定

# テストファイルのパターン
**/*.test.ts
**/*.test.tsx
**/*.spec.ts
**/*.spec.tsx
**/__tests__/**/*

3. カバレッジ確認

影響を受けるファイルに対応するテストがあるか確認:

ソースファイルテストファイル検索パターン
src/hooks/useData.tssrc/hooks/useData.test.ts, src/hooks/tests/useData.test.ts
src/utils/format.tssrc/utils/format.test.ts, src/utils/tests/format.test.ts

出力フォーマット

{
  "affectedFiles": [
    {
      "file": "src/components/Example.tsx",
      "lines": [15, 42, 78],
      "pattern": "useRouter",
      "context": "import { useRouter } from 'next/router'"
    }
  ],
  "testCoverage": {
    "covered": [
      {
        "source": "src/hooks/useData.ts",
        "test": "src/hooks/__tests__/useData.test.ts"
      }
    ],
    "notCovered": [
      "src/utils/format.ts"
    ]
  },
  "summary": {
    "totalFiles": 5,
    "totalLines": 12,
    "testCoverage": "60%"
  }
}

検索パターン集

React

# Hooks
use(Effect|State|Callback|Memo|Ref|Context)\s*\(

# コンポーネント
<ComponentName\s+[^>]*prop=

Next.js

# Router
import.*from\s+['"]next/router['"]
useRouter\s*\(\)

# Pages
getServerSideProps|getStaticProps|getStaticPaths

# App Router
import.*from\s+['"]next/navigation['"]

一般

# 特定の関数
functionName\s*\(

# 特定のimport
import\s*{\s*[^}]*targetName[^}]*}\s*from

# 特定のメソッド
\.methodName\s*\(

コード移行スキル

役割: 破壊的変更に基づくコード修正に特化。

入力: 破壊的変更リスト、修正パターン、対象ディレクトリ(呼び出し元から渡される)

修正パターン

1. import文の変更

パッケージ名の変更
// Before
import { something } from 'old-package';

// After
import { something } from 'new-package';

検索パターン:

import\s+.*\s+from\s+['"]old-package['"]
エクスポート名の変更
// Before
import { oldName } from 'package';

// After
import { newName } from 'package';
デフォルトエクスポートへの変更
// Before
import { Component } from 'package';

// After
import Component from 'package';

2. API呼び出しの変更

関数名の変更
// Before
oldFunction(arg1, arg2);

// After
newFunction(arg1, arg2);
引数の変更
// Before
func(arg1, arg2, arg3);

// After
func({ param1: arg1, param2: arg2, param3: arg3 });
メソッドチェーンの変更
// Before
obj.oldMethod().chain();

// After
obj.newMethod().chain();

3. React固有の変更

Hooksの変更
// Before (React 18)
import { useEffect } from 'react';

// After (React 19 - use() API)
import { use } from 'react';
コンポーネントPropsの変更
// Before
<Component oldProp={value} />

// After
<Component newProp={value} />
forwardRefの廃止(React 19)
// Before
const Component = forwardRef((props, ref) => {
  return <div ref={ref} />;
});

// After
const Component = ({ ref, ...props }) => {
  return <div ref={ref} />;
};

4. Next.js固有の変更

Pages Router → App Router
// Before (pages/)
export async function getServerSideProps() {}

// After (app/)
// Server Componentとして実装
async function Page() {
  const data = await fetchData();
  return <div>{data}</div>;
}
next/router → next/navigation
// Before
import { useRouter } from 'next/router';
const router = useRouter();
router.push('/path');

// After
import { useRouter } from 'next/navigation';
const router = useRouter();
router.push('/path');
next/image の変更
// Before (Next.js 12)
import Image from 'next/image';
<Image layout="fill" objectFit="cover" />

// After (Next.js 13+)
import Image from 'next/image';
<Image fill style={{ objectFit: 'cover' }} />

5. 設定ファイルの変更

next.config.js
// Before (Next.js 14)
module.exports = {
  experimental: {
    appDir: true,
  },
};

// After (Next.js 15)
module.exports = {
  // appDirはデフォルトで有効
};
tsconfig.json
// Before (TypeScript 4.x)
{
  "compilerOptions": {
    "target": "ES2020"
  }
}

// After (TypeScript 5.x)
{
  "compilerOptions": {
    "target": "ES2022"
  }
}
ESLint設定
// Before (ESLint 8)
module.exports = {
  extends: ['next/core-web-vitals'],
};

// After (ESLint 9 - Flat Config)
import nextConfig from 'eslint-config-next';
export default [...nextConfig];

検索・置換戦略

安全な置換(自動実行可能)

  • 単純な文字列置換
  • import文のパッケージ名変更
  • 明確なAPI名の変更

確認が必要な置換

  • 複数の解釈が可能な変更
  • コンテキストに依存する変更
  • 削除を伴う変更

手動対応が必要

  • ロジックの変更を伴う修正
  • 複雑な型の変更
  • アーキテクチャの変更

出力フォーマット

{
  "migrations": [
    {
      "pattern": "{変更パターン}",
      "description": "{変更内容}",
      "files": [
        {
          "path": "{ファイルパス}",
          "changes": [
            {
              "line": 15,
              "before": "{変更前コード}",
              "after": "{変更後コード}",
              "status": "applied|skipped|manual_required"
            }
          ]
        }
      ],
      "status": "success|partial|failed"
    }
  ],
  "summary": {
    "totalFiles": 10,
    "totalChanges": 25,
    "applied": 20,
    "skipped": 3,
    "manualRequired": 2
  },
  "manualTasks": [
    {
      "file": "{ファイルパス}",
      "line": 42,
      "description": "{手動で行う必要がある作業}",
      "reason": "{自動化できない理由}"
    }
  ]
}

検索コマンド

# 特定のimportを検索
grep -rn "from 'old-package'" --include="*.ts" --include="*.tsx" src/

# 特定の関数呼び出しを検索
grep -rn "oldFunction\s*(" --include="*.ts" --include="*.tsx" src/

# 特定のJSX属性を検索
grep -rn "oldProp=" --include="*.tsx" src/

注意事項

  • バックアップを取ってから実行: git stash や git commit で保存
  • 一度に大量の変更をしない: ファイル単位で確認しながら進める
  • テストが通ることを確認: 変更後に必ずテスト実行
  • コメントやドキュメントも更新: 古いAPI名が残らないように

EOL・互換性確認スキル

役割: EOL情報と互換性要件の取得に特化。

入力: ライブラリ名、バージョン(呼び出し元から渡される)

調査対象

  1. EOL状況: サポート終了日、セキュリティサポート状況
  2. 互換性要件: peerDependencies、engines要件
  3. LTSスケジュール: Node.js等のLTSサイクル

情報ソース

endoflife.date

https://endoflife.date/{library}
https://endoflife.date/api/{library}.json

npm registry

https://registry.npmjs.org/{package}
https://registry.npmjs.org/{package}/{version}

主要ライブラリのEOL情報

Node.js

バージョンステータスEOL
22.xCurrent2027-04
20.xActive LTS2026-04
18.xMaintenance2025-04

React

  • 最新2メジャーバージョンがサポート対象
  • 古いバージョンはセキュリティ修正のみ

Next.js

  • 最新2メジャーバージョンがアクティブサポート

互換性マトリクス

Node.js ← React ← Next.js
          ↓
        TypeScript ← @types/*

確認ポイント

組み合わせ確認事項
Node.js + Next.jsengines要件
React + Next.jspeerDependencies
TypeScript + React@types/reactのバージョン

出力フォーマット

{
  "eolStatus": {
    "library": "nodejs",
    "version": "18.x",
    "status": "maintenance",
    "eolDate": "2025-04-30",
    "securitySupport": true
  },
  "compatibility": {
    "engines": {
      "node": ">=18.17.0"
    },
    "peerDependencies": {
      "react": "^18.2.0 || ^19.0.0"
    }
  },
  "recommendations": [
    {
      "type": "upgrade",
      "reason": "EOLが近い",
      "target": "20.x"
    }
  ]
}

リリース情報取得スキル

役割: Web調査に特化。ライブラリのリリース情報を公式ソースから取得する。

入力: ライブラリ名、現在バージョン、目標バージョン(呼び出し元から渡される)

調査対象

  1. 破壊的変更(Breaking Changes)
  2. 非推奨化(Deprecations)
  3. ビルトイン化(不要になるパッケージ)
  4. マイグレーションガイドのURL

情報ソース

GitHub

https://github.com/{org}/{repo}/releases
https://github.com/{org}/{repo}/blob/main/CHANGELOG.md
https://github.com/{org}/{repo}/blob/main/MIGRATION.md

公式ドキュメント

ライブラリリリースノートマイグレーションガイド
Reacthttps://react.dev/bloghttps://react.dev/blog/2024/04/25/react-19-upgrade-guide
Next.jshttps://nextjs.org/bloghttps://nextjs.org/docs/app/guides/upgrading
Vuehttps://blog.vuejs.orghttps://v3-migration.vuejs.org
Angularhttps://blog.angular.iohttps://angular.dev/update-guide
TypeScripthttps://devblogs.microsoft.com/typescripthttps://www.typescriptlang.org/docs/handbook/release-notes

EOL情報

https://endoflife.date/{library}

出力フォーマット

{
  "breakingChanges": [
    {
      "title": "API名変更",
      "description": "useRouter → useNavigation",
      "version": "15.0.0",
      "severity": "high"
    }
  ],
  "deprecations": [
    {
      "api": "getServerSideProps",
      "replacement": "Server Components",
      "version": "15.0.0"
    }
  ],
  "builtins": [
    {
      "package": "@next/font",
      "reason": "next/fontにビルトイン",
      "version": "13.0.0"
    }
  ],
  "references": {
    "releaseNotes": "https://...",
    "migrationGuide": "https://...",
    "changelog": "https://..."
  }
}

検索キーワード

リリースノート内で以下を検索:

  • breaking change, breaking
  • deprecated, deprecation
  • removed, no longer
  • built-in, included, bundled
  • migration, upgrade

パッケージ更新スキル

役割: パッケージマネージャーとバージョン管理ツールを使用した更新作業に特化。

入力: パッケージ名、バージョン、パッケージマネージャー種別(呼び出し元から渡される)

パッケージマネージャー別コマンド

npm

# 単一パッケージ
npm install {package}@{version}

# 複数パッケージ
npm install {pkg1}@{v1} {pkg2}@{v2}

# devDependencies
npm install -D {package}@{version}

# peer依存関係の競合を無視(非推奨だが必要な場合)
npm install {package}@{version} --legacy-peer-deps

yarn (v1)

# 単一パッケージ
yarn add {package}@{version}

# 複数パッケージ
yarn add {pkg1}@{v1} {pkg2}@{v2}

# devDependencies
yarn add -D {package}@{version}

yarn (berry/v2+)

# 単一パッケージ
yarn add {package}@{version}

# インタラクティブアップグレード(使用しない)
# yarn upgrade-interactive

pnpm

# 単一パッケージ
pnpm add {package}@{version}

# 複数パッケージ
pnpm add {pkg1}@{v1} {pkg2}@{v2}

# devDependencies
pnpm add -D {package}@{version}

# ワークスペース全体
pnpm add {package}@{version} -w

bun

# 単一パッケージ
bun add {package}@{version}

# 複数パッケージ
bun add {pkg1}@{v1} {pkg2}@{v2}

# devDependencies
bun add -d {package}@{version}

Node.jsバージョン管理

mise

# バージョンインストール
mise install node@{version}

# プロジェクトで使用
mise use node@{version}

# グローバル設定
mise use -g node@{version}

# .tool-versions更新(自動)
# mise use で自動更新される

nvm

# バージョンインストール
nvm install {version}

# 使用
nvm use {version}

# .nvmrc更新
echo "{version}" > .nvmrc

# デフォルト設定
nvm alias default {version}

asdf

# プラグイン確認
asdf plugin list | grep nodejs

# バージョンインストール
asdf install nodejs {version}

# ローカル設定
asdf local nodejs {version}

# .tool-versions更新(自動)

nodenv

# バージョンインストール
nodenv install {version}

# ローカル設定
nodenv local {version}

# .node-version更新(自動)

fnm

# バージョンインストール
fnm install {version}

# 使用
fnm use {version}

# .node-version更新
echo "{version}" > .node-version

パッケージ削除

# npm
npm uninstall {package}

# yarn
yarn remove {package}

# pnpm
pnpm remove {package}

# bun
bun remove {package}

依存関係の再インストール

# npm
rm -rf node_modules package-lock.json && npm install

# yarn
rm -rf node_modules yarn.lock && yarn

# pnpm
rm -rf node_modules pnpm-lock.yaml && pnpm install

# bun
rm -rf node_modules bun.lockb && bun install

出力フォーマット

{
  "action": "update|install|remove",
  "packages": [
    {
      "name": "{パッケージ名}",
      "from": "{旧バージョン}",
      "to": "{新バージョン}",
      "status": "success|failed",
      "command": "{実行コマンド}",
      "output": "{コマンド出力}",
      "error": "{エラー(失敗時)}"
    }
  ],
  "nodeVersion": {
    "from": "{旧バージョン}",
    "to": "{新バージョン}",
    "tool": "mise|nvm|asdf|nodenv|fnm",
    "status": "success|failed|skipped"
  }
}

エラーハンドリング

ERESOLVE(依存関係の競合)

# エラー例
npm ERR! ERESOLVE unable to resolve dependency tree

# 対処1: --legacy-peer-deps
npm install {package}@{version} --legacy-peer-deps

# 対処2: --force(非推奨)
npm install {package}@{version} --force

バージョンが見つからない

# 利用可能なバージョン確認
npm view {package} versions --json

# 最新バージョン確認
npm view {package} version

権限エラー

# グローバルインストールの場合
# sudoは使用しない、パーミッション修正を案内

確認コマンド

# インストール済みバージョン確認
npm list {package}
yarn list {package}
pnpm list {package}
bun pm ls {package}

# 最新バージョン確認
npm view {package} version

# アウトデートパッケージ確認
npm outdated
yarn outdated
pnpm outdated

テスト実行スキル

役割: lint/test/buildの実行と結果解析に特化。

入力: 実行コマンド、プロジェクト情報(呼び出し元から渡される)

コマンド実行

lint:fix(推奨)

ESLint自動修正 + TypeScript型チェックを実行:

# npm
npm run lint:fix

# yarn
yarn lint:fix

# pnpm
pnpm lint:fix

# bun
bun run lint:fix

lint:fixコマンドがない場合はpackage.jsonに追加:

{
  "scripts": {
    "lint:fix": "eslint src --ext .js,.jsx,.ts,.tsx --fix && tsc --noEmit"
  }
}
プロジェクト構成推奨lint:fixコマンド
ESLint + TypeScripteslint src --ext .js,.jsx,.ts,.tsx --fix && tsc --noEmit
Next.jsnext lint --fix && tsc --noEmit
Biomebiome check --write src && tsc --noEmit

Lint(従来)

# npm
npm run lint

# yarn
yarn lint

# pnpm
pnpm lint

# bun
bun run lint

# 自動修正(--fix オプション)
npm run lint -- --fix
yarn lint --fix
pnpm lint --fix
bun run lint --fix

Test

# npm
npm test
npm run test

# yarn
yarn test

# pnpm
pnpm test

# bun
bun test

# 特定ファイルのみ
npm test -- {path}
yarn test {path}
pnpm test {path}
bun test {path}

# watchモードを無効化
npm test -- --watchAll=false
CI=true npm test

Build

# npm
npm run build

# yarn
yarn build

# pnpm
pnpm build

# bun
bun run build

型チェック

# TypeScript
npx tsc --noEmit

# または
npm run type-check
yarn type-check
pnpm type-check

結果解析

ESLint結果

# JSON形式で出力
npm run lint -- --format json

# 出力例
[
  {
    "filePath": "/path/to/file.ts",
    "messages": [
      {
        "ruleId": "no-unused-vars",
        "severity": 2,
        "message": "'x' is defined but never used",
        "line": 10,
        "column": 5
      }
    ],
    "errorCount": 1,
    "warningCount": 0
  }
]

Jest/Vitest結果

# JSON形式で出力
npm test -- --json --outputFile=test-results.json

# 出力例
{
  "numTotalTests": 50,
  "numPassedTests": 48,
  "numFailedTests": 2,
  "testResults": [
    {
      "name": "/path/to/test.ts",
      "status": "failed",
      "assertionResults": [
        {
          "title": "should work",
          "status": "failed",
          "failureMessages": ["Error: ..."]
        }
      ]
    }
  ]
}

TypeScript結果

# エラー出力例
src/components/Example.tsx(15,5): error TS2345:
  Argument of type 'string' is not assignable to parameter of type 'number'.

Build結果

# Next.js
# エラー出力例
Error: Build failed because of webpack errors

# Vite
# エラー出力例
error during build:
RollupError: ...

エラー分類

Lint エラー

カテゴリ例自動修正
フォーマットindent, semi, quotes可能
未使用変数no-unused-vars要確認
インポート順import/order可能
React Hooksreact-hooks/rules-of-hooks不可

Test エラー

カテゴリ原因対処
アサーション失敗期待値不一致テストまたはコード修正
タイムアウト非同期処理タイムアウト延長またはモック
モジュール解決import失敗パス確認、モック追加
スナップショット不一致スナップショット更新

Build エラー

カテゴリ原因対処
型エラーTypeScript型修正
モジュール解決パッケージ不足インストール
設定エラーconfig不正設定修正
メモリ不足heap overflowNODE_OPTIONS調整

修正コマンド

Lintエラーの自動修正

# ESLint
npm run lint -- --fix

# Prettier
npx prettier --write .

# 両方
npm run lint -- --fix && npx prettier --write .

スナップショット更新

# Jest
npm test -- -u
npm test -- --updateSnapshot

# Vitest
npx vitest --update

キャッシュクリア

# Jest
npx jest --clearCache

# Next.js
rm -rf .next

# 一般
rm -rf node_modules/.cache

出力フォーマット

{
  "lint": {
    "status": "pass|fail",
    "command": "{実行コマンド}",
    "errors": [
      {
        "file": "{ファイルパス}",
        "line": 10,
        "column": 5,
        "rule": "{ルール名}",
        "message": "{エラーメッセージ}",
        "severity": "error|warning",
        "fixable": true
      }
    ],
    "summary": {
      "errorCount": 5,
      "warningCount": 10,
      "fixableCount": 12
    }
  },
  "test": {
    "status": "pass|fail",
    "command": "{実行コマンド}",
    "summary": {
      "total": 50,
      "passed": 48,
      "failed": 2,
      "skipped": 0,
      "duration": "15.3s"
    },
    "failures": [
      {
        "file": "{テストファイル}",
        "test": "{テスト名}",
        "message": "{エラーメッセージ}",
        "expected": "{期待値}",
        "actual": "{実際の値}"
      }
    ]
  },
  "build": {
    "status": "pass|fail|skipped",
    "command": "{実行コマンド}",
    "errors": [
      {
        "file": "{ファイルパス}",
        "line": 15,
        "message": "{エラーメッセージ}",
        "type": "typescript|webpack|rollup"
      }
    ],
    "duration": "45.2s"
  },
  "recommendations": [
    {
      "type": "auto_fix|manual_fix|investigate",
      "description": "{推奨アクション}",
      "command": "{実行コマンド(あれば)}"
    }
  ]
}

CI環境での実行

# CI環境フラグ
CI=true npm test
CI=true npm run build

# 並列実行の制限(メモリ節約)
npm test -- --maxWorkers=2

# カバレッジ出力
npm test -- --coverage

注意事項

  • watchモードを無効化: CI環境やスクリプト実行時は必須
  • タイムアウト設定: 長時間テストには適切なタイムアウトを設定
  • 並列実行の調整: メモリ不足時はワーカー数を減らす
  • エラー出力の保存: 後で分析できるようにログを保存

Commands 2

EOL対応計画の作成

フロントエンドプロジェクトのライブラリEOL(End of Life)対応計画を作成し、Markdownファイルに出力します。

引数

  • $ARGUMENTS: フリーワードで要件を指定できます
    • 省略時: プロジェクト全体の依存関係を対象に計画を作成

引数の指定パターン

/eol-plan react@19 next@15
/eol-plan Node.jsを22系までアップデートしライブラリを可能な範囲で最新化
/eol-plan recoilをjotaiに置き換え
/eol-plan セキュリティ脆弱性のあるパッケージのみ対応

実行フロー

このコマンドは以下のフローで実行します。サブエージェントへの無駄な呼び出しを避けるため、情報収集はこのコマンド内で完結させます。

[Step 1-4] 情報収集(このコマンドで実行)
    ↓
[Step 5] サブエージェント呼び出し(調査のみ依頼)
    ↓
[Step 6-7] 戦略決定・計画書作成(このコマンドで実行)

Step 1: 初期情報の収集

以下の情報を一括で収集(並列実行可能):

1.1 出力先の決定

# CLAUDE.mdから出力先を確認
grep -i "EOL計画出力先" CLAUDE.md

指定がない場合: プロジェクトルートに eol-plan.md を作成

1.2 パッケージマネージャーの特定

# ロックファイルの存在確認(優先順位: bun > pnpm > yarn > npm)
ls bun.lockb bun.lock pnpm-lock.yaml yarn.lock package-lock.json 2>/dev/null | head -1

1.3 プロジェクト構成の確認

# ソース/テストディレクトリの特定
ls -d src/ app/ pages/ components/ __tests__/ tests/ 2>/dev/null

1.4 Node.jsバージョンとバージョン管理ツールの確認

# バージョンファイルの確認
cat .nvmrc .node-version .tool-versions 2>/dev/null || grep '"node"' package.json

# バージョン管理ツールの特定(優先順位: プロジェクト既存ツール > mise)
ls .nvmrc .node-version .tool-versions mise.toml .mise.toml 2>/dev/null | head -1
ファイルツール
.nvmrcnvm
.node-versionnodenv, fnm, mise等
.tool-versionsasdf, mise
mise.toml / .mise.tomlmise
なしユーザーに確認(推奨: mise)

Step 2: 依存関係の一括取得

2.1 npm-check-updates で最新バージョン確認

npx npm-check-updates --jsonUpgraded 2>/dev/null || npx npm-check-updates

2.2 セキュリティ監査

# パッケージマネージャーに応じて実行
npm audit --json 2>/dev/null || npm audit
yarn audit --json 2>/dev/null || yarn audit
pnpm audit --json 2>/dev/null || pnpm audit

2.3 package.json の読み込み

cat package.json

Step 3: 引数の解析と対象決定

引数の内容を解析し、対象ライブラリを決定:

パターン例処理
バージョン指定react@19指定バージョンへ更新
ランタイム指定Node.js 22系互換ライブラリも含めて計画
ライブラリ置換recoilをjotaiに置き換え移行計画を作成
範囲指定可能な範囲で最新化破壊的変更が少ないものから
制約条件React 18のまま指定ライブラリは現状維持
セキュリティ優先脆弱性のみaudit結果から絞り込み

引数がない場合の優先順位:

  1. セキュリティ脆弱性があるパッケージ
  2. EOLまたはサポート終了のパッケージ
  3. メジャーバージョンアップが可能なパッケージ
  4. マイナー/パッチアップデートがあるパッケージ

Step 4: ライブラリグループの構成

依存関係が自明なライブラリをグループ化(サブエージェントへの呼び出し回数を削減):

グループメインライブラリ関連ライブラリ
React コアreactreact-dom, @types/react, @types/react-dom
Next.jsnextreact, react-dom, eslint-config-next
Vue コアvue@vue/compiler-sfc, vue-router, pinia
ESLinteslinteslint-config-, eslint-plugin-
TypeScripttypescript@types/*, ts-node

グルーピング結果の作成

グループ1: Next.js
  - next: 14.0.4 → 15.0.0
  - react: 18.2.0 → 19.0.0
  - react-dom: 18.2.0 → 19.0.0
  - eslint-config-next: 14.0.4 → 15.0.0

グループ2: ESLint
  - eslint: 8.x → 9.x
  - eslint-plugin-react: x.x → y.y
  ...

単体: lodash 4.17.20 → 4.17.21

Step 5: サブエージェント呼び出し(library-update-analyzer)

各グループに対して1回ずつサブエージェントを呼び出す。 収集済みの情報を渡し、調査のみを依頼する。

呼び出しフォーマット

調査対象:
  メインライブラリ: next
  現在バージョン: 14.0.4
  目標バージョン: 15.0.0
  関連ライブラリ: [react@18.2.0→19.0.0, react-dom@18.2.0→19.0.0, eslint-config-next@14.0.4→15.0.0]

プロジェクト情報:
  パッケージマネージャー: pnpm
  Node.jsバージョン: 20.10.0
  ソースディレクトリ: src/, app/
  テストディレクトリ: __tests__/, *.test.tsx

サブエージェントからの戻り値(JSON)

{
  "library": "next",
  "breakingChanges": [...],
  "deprecations": [...],
  "packagesToRemove": [...],
  "packagesToUpdate": [...],
  "testCoverage": {...},
  "summary": {
    "affectedFileCount": 5,
    "breakingChangeCount": 3,
    "estimatedEffort": "medium",
    "riskLevel": "medium"
  },
  "references": {...}
}

並列呼び出しの判断

  • グループ間に依存関係がない場合: 並列で呼び出し可能
  • 依存関係がある場合(例: Next.js → React): 順次呼び出し

Step 6: アップグレード戦略の決定

サブエージェントの結果を集約し、戦略を決定:

一括アップグレード(すべて満たす場合)

  • 破壊的変更が合計3件以下
  • 影響ファイルが合計10件以下
  • 依存関係の競合がない

段階的アップグレード(1つでも該当する場合は必須)

  • 🔴 破壊的変更が多い(4件以上)
  • 🔴 影響ファイルが多い(11件以上)
  • 🔴 複数のメジャーバージョンアップを含む
  • 🔴 ライブラリの置換を含む
  • 🔴 Node.jsのアップグレードを含む

段階的アップグレードの計画

  1. Phase 0: 事前準備 - アップデート前の品質担保
    • 破壊的変更が入る箇所をリストアップ
    • 該当箇所のテストを追加(変更前の挙動を保証)
    • lint/testが通ることを確認(ベースライン確立)
  2. Phase 1: ランタイム・言語基盤 - Node.js, TypeScript
  3. Phase 2: 品質担保ツール - ESLint, Prettier, Jest/Vitest, Testing Library等
  4. Phase 3: 主要フレームワーク - Next.js, React, Vue等
  5. Phase 4: UIライブラリ - MUI, Chakra, Tailwind, Radix等
  6. Phase 5: 状態管理・データ取得・その他 - TanStack Query, Jotai, Zustand, SWR, ユーティリティ等
  7. Phase 6: ライブラリ置換 - 別ライブラリへの移行(該当する場合)

重要: 各Phaseの完了時に必ずlint/testを実行し、問題がないことを確認してから次のPhaseに進む

バージョンアップの粒度

以下の場合は、1バージョンずつ段階的にアップデートし、各バージョンで挙動を確認する:

ケース例対応
メジャーバージョンが2つ以上離れているReact 16 → 1816 → 17 → 18 と順次アップ
マイナーバージョンに破壊的変更があるNext.js 14.1 → 14.2 (App Router変更等)1マイナーずつ確認
非推奨警告が大量に出ている警告を解消してから次へ警告対応 → アップデート
# 悪い例: 一気にアップデート
react: 16.8.0 → 19.0.0  ❌

# 良い例: 段階的にアップデート
react: 16.8.0 → 17.0.0 (確認) → 18.0.0 (確認) → 19.0.0 (確認)  ✅

複数サイクルでのアップグレード

複数ライブラリで段階的アップデートが必要な場合、Phase 1〜6を複数サイクル繰り返す:

例: Node.js 20系、React 17系、TanStack Query 3系 を最新化

■ サイクル1(1メジャーずつ上げる)
  Phase 1: Node.js 20 → 22
  Phase 2: ESLint等を互換バージョンへ
  Phase 3: React 17 → 18
  Phase 4: UIライブラリを互換バージョンへ
  Phase 5: TanStack Query 3 → 4
  → lint/test確認 ✅

■ サイクル2(さらに1メジャー上げる)
  Phase 1: Node.js 22 → 24
  Phase 2: ESLint等を互換バージョンへ
  Phase 3: React 18 → 19
  Phase 4: UIライブラリを互換バージョンへ
  Phase 5: TanStack Query 4 → 5
  → lint/test確認 ✅

サイクルの組み方:

  • 全Phase(1〜6)を繰り返す: ランタイムも含めて段階的に上げる場合
  • Phase 3〜6のみ繰り返す: ランタイム・lint系は先に最新化済みの場合

アップグレード順序の考え方

順序カテゴリ理由
1ランタイム・言語基盤他のすべてのライブラリの動作基盤となるため最初に
2品質担保ツール以降のアップデートで問題を正しく検知するため
3主要フレームワークアプリケーションの中核。周辺ライブラリより先に安定させる
4UIライブラリフレームワークのバージョンに依存することが多いため、フレームワーク更新後に
5状態管理・データ取得・その他UIと連携するため、UIライブラリ更新後に。影響範囲も限定的
6ライブラリ置換既存コードの大幅な変更を伴うため最後に

Step 7: 計画書の作成

サブエージェントの結果を統合し、以下のフォーマットでMDファイルを出力:

# EOL対応計画

作成日: {日付}
対象プロジェクト: {プロジェクト名}
パッケージマネージャー: {npm/yarn/pnpm/bun}

## 概要

| 項目 | 内容 |
|------|------|
| 対象ライブラリ数 | X件 |
| セキュリティ脆弱性 | X件 |
| リスクレベル | {低/中/高} |
| 推奨戦略 | {一括/段階的} |

## セキュリティ監査結果

| パッケージ | 脆弱性レベル | 説明 | 修正バージョン |
|-----------|------------|------|--------------|

## ライブラリグループ

| グループ | メインライブラリ | 関連ライブラリ | 一括アップグレード |
|---------|----------------|---------------|------------------|

## 削除対象パッケージ

| パッケージ | 理由 | 削除タイミング |
|-----------|------|--------------|

## アップグレード戦略

### 推奨アプローチ: {一括/段階的}

{選択理由}

## 段階的アップグレード計画

### Phase 0: 事前準備

**目的**: 破壊的変更が入る箇所を特定し、変更前の挙動を保証するテストを追加する

**破壊的変更の影響箇所**:
| ファイル | 影響を受ける変更 | 現在のテスト有無 |
|---------|----------------|----------------|

**テスト追加が必要な箇所**:
| ファイル | 追加すべきテスト | 理由 |
|---------|----------------|------|

**確認項目**:
- [ ] 破壊的変更の影響箇所をすべてリストアップ
- [ ] 影響箇所のテストを追加(変更前の挙動を保証)
- [ ] `{pm} run lint:fix` 成功
- [ ] `{pm} run test` 成功
- [ ] 現状のテストカバレッジを記録

⚠️ **Phase 0が完了するまで、ライブラリのアップデートは行わない**
💡 テストがあることで、アップデート後に挙動が変わった箇所を検知できる

**lint:fixコマンドがない場合は追加**:
```json
{
  "scripts": {
    "lint:fix": "eslint src --ext .js,.jsx,.ts,.tsx --fix && tsc --noEmit"
  }
}

Phase 1: {フェーズ名}

対象:

  • {ライブラリ}: {現在} → {目標}

破壊的変更への対応:

変更内容影響ファイル対応方法

アップデートコマンド:

{コマンド}

確認項目:

  • {pm} run lint:fix 成功
  • {pm} run test 成功
  • ビルド成功
  • 動作確認

Phase 2: ...

ライブラリ置換計画

(ライブラリ置換が指定された場合のみ)

{旧ライブラリ} → {新ライブラリ}

API対応表
旧API新API備考
移行手順
  1. 新ライブラリをインストール
  2. コード修正
  3. テスト更新
  4. 旧ライブラリを削除

リスクと対策

リスク発生確率影響度対策

ロールバック計画

各フェーズでの問題発生時:

  1. {手順}

参考リンク


---

## 注意事項

- **情報収集はこのコマンド内で完結**: サブエージェントにはプロジェクト情報を渡す
- **サブエージェントはグループ単位で呼び出し**: 個別ライブラリごとに呼び出さない
- **並列呼び出しを活用**: 依存関係がないグループは並列で調査
- **破壊的変更が多い場合は必ず段階的アップグレード**
- **アップグレードの実行順序を厳守**:
  1. Phase 0で不足テストを追加し、lint/testが通ることを確認(ベースライン確立)
  2. 各Phaseでアップデート実施後、必ずlint/testを実行して問題がないことを確認
  3. 問題があれば解決してから次のPhaseに進む
- **Node.jsのアップデートにはプロジェクトのバージョン管理ツールを使用**:
  - プロジェクトに既存のバージョン管理ツール(nvm, nodenv, asdf等)があればそれを使用
  - バージョン管理ツールが特定できない場合は、**ユーザーに確認する**(デフォルト推奨: [mise](https://mise.jdx.dev/getting-started.html))
  - 計画書にはバージョン管理ツールを使ったアップデート手順を記載すること

EOLアップデート実行コマンド

/eol-plan で作成した計画書に基づいて、実際のアップデート作業を実行します。

引数

  • $ARGUMENTS: 実行するフェーズを指定
    • 省略時: 次に実行すべきフェーズを自動判定
    • phase0, phase1, ... phase6: 特定フェーズを実行
    • all: 全フェーズを順次実行(各フェーズ完了時に確認)

引数の指定パターン

/eol-update              # 次のフェーズを実行
/eol-update phase0       # Phase 0(事前準備)を実行
/eol-update phase3       # Phase 3(主要フレームワーク)を実行
/eol-update all          # 全フェーズを順次実行

実行フロー

[Step 1] 計画書の読み込み・状態確認
    ↓
[Step 2] 実行フェーズの決定
    ↓
[Step 3] フェーズ実行(サブエージェント呼び出し)
    ↓
[Step 4] lint/test実行・結果確認
    ↓
[Step 5] 計画書の進捗更新
    ↓
[Step 6] 次のアクション提案

Step 1: 計画書の読み込み

1.1 計画書の特定

# CLAUDE.mdから出力先を確認
grep -i "EOL計画出力先" CLAUDE.md

# デフォルト: プロジェクトルートのeol-plan.md
cat eol-plan.md

計画書が存在しない場合: → ユーザーに /eol-plan の実行を促す

1.2 現在の進捗確認

計画書内のチェックボックス状態を確認:

  • - [x]: 完了
  • - [ ]: 未完了

1.3 プロジェクト情報の取得

# パッケージマネージャーの特定
ls bun.lockb bun.lock pnpm-lock.yaml yarn.lock package-lock.json 2>/dev/null | head -1

# Node.jsバージョン管理ツールの特定
ls .nvmrc .node-version .tool-versions mise.toml .mise.toml 2>/dev/null | head -1

# lint/testコマンドの特定
cat package.json | grep -A10 '"scripts"'

1.4 lint:fixコマンドの確認・追加

package.jsonに lint:fix コマンドがあるか確認:

grep '"lint:fix"' package.json

lint:fixコマンドがない場合は追加する:

{
  "scripts": {
    "lint:fix": "eslint src --ext .js,.jsx,.ts,.tsx --fix && tsc --noEmit"
  }
}
プロジェクト構成推奨lint:fixコマンド
ESLint + TypeScripteslint src --ext .js,.jsx,.ts,.tsx --fix && tsc --noEmit
Next.jsnext lint --fix && tsc --noEmit
Biomebiome check --write src && tsc --noEmit

注意:

  • --fix でESLintの自動修正を実行
  • tsc --noEmit で型チェックのみ実行(ファイル出力なし)
  • srcディレクトリは実際のプロジェクト構成に合わせて調整

Step 2: 実行フェーズの決定

引数がある場合

指定されたフェーズを実行

引数がない場合

計画書の進捗から次のフェーズを自動判定:

  1. Phase 0が未完了 → Phase 0を実行
  2. Phase 0完了、Phase 1未完了 → Phase 1を実行
  3. ...以降同様

実行前確認

ユーザーに確認:

次のフェーズを実行します:

Phase {N}: {フェーズ名}
対象:
  - {ライブラリ1}: {現在} → {目標}
  - {ライブラリ2}: {現在} → {目標}

実行してよろしいですか?

Step 3: フェーズ実行

Phase 0: 事前準備

  1. 不足テストの確認

    • 計画書の「テスト追加が必要な箇所」を確認
    • テストファイルの作成をユーザーに提案
  2. ベースライン確立

    # lint実行
    {lint コマンド}
    
    # test実行
    {test コマンド}
    
  3. 結果確認

    • すべてパスした場合 → Phase 0完了
    • 失敗がある場合 → 修正を提案

Phase 1〜5: ライブラリアップデート

phase-executor サブエージェントを呼び出し

実行フェーズ: Phase {N}
フェーズ名: {フェーズ名}

対象ライブラリ:
  - {ライブラリ1}: {現在} → {目標}
  - {ライブラリ2}: {現在} → {目標}

破壊的変更への対応:
  - {変更1}: {対応方法}
  - {変更2}: {対応方法}

プロジェクト情報:
  パッケージマネージャー: {npm/yarn/pnpm/bun}
  Node.jsバージョン管理: {nvm/mise/asdf/なし}

Phase 6: ライブラリ置換

migration-executor サブエージェントを呼び出し

置換対象:
  旧ライブラリ: {旧}
  新ライブラリ: {新}

API対応表:
  - {旧API} → {新API}

プロジェクト情報:
  ...

Step 4: lint:fix/test実行・結果確認

各フェーズ完了後に必ず実行:

# 1. lint:fix(ESLint自動修正 + TypeScript型チェック)
{pm} run lint:fix

# 2. test
{pm} run test

# 3. build(オプション)
{pm} run build

実行順序の理由

  1. lint:fix を最初に実行

    • ESLintの自動修正でコードスタイルを統一
    • TypeScriptの型エラーを早期発見
    • 型エラーがあるとtestやbuildも失敗するため先に確認
  2. test を実行

    • 型が通った状態でテストを実行
    • 破壊的変更による挙動変化を検知
  3. build を最後に実行

    • 最終的な成果物が生成できることを確認

結果の判定

結果アクション
すべてパス次のステップへ
lint失敗自動修正を試行(--fix)、手動修正を提案
test失敗失敗テストを分析、修正を提案
build失敗エラーを分析、修正を提案

Step 5: 計画書の進捗更新

フェーズ完了時に計画書を更新:

### Phase {N}: {フェーズ名}

**確認項目**:
- [x] `{pm} run lint:fix` 成功  ← 更新
- [x] `{pm} run test` 成功      ← 更新
- [x] ビルド成功                 ← 更新
- [ ] 動作確認                   ← ユーザーに確認を促す

Step 6: 次のアクション提案

フェーズ成功時

✅ Phase {N} が完了しました。

次のステップ:
1. [ ] 動作確認を行ってください
2. [ ] 問題なければ `/eol-update phase{N+1}` で次のフェーズへ

または `/eol-update all` で残りのフェーズを連続実行

フェーズ失敗時

❌ Phase {N} でエラーが発生しました。

エラー内容:
{エラー詳細}

推奨アクション:
1. {修正提案1}
2. {修正提案2}

修正後、再度 `/eol-update phase{N}` を実行してください。

注意事項

  • 各フェーズは独立して実行可能: 途中からの再開が可能
  • lint/testは必ず実行: スキップ不可
  • 動作確認はユーザー責任: 自動化できない部分
  • 失敗時はロールバック可能: git stashやgit checkout での復元を案内
  • Node.jsアップデート時はバージョン管理ツールを使用: mise, nvm等

ロールバック手順

問題発生時:

# 変更を一時退避
git stash

# または特定ファイルを復元
git checkout -- package.json package-lock.json

# 依存関係を再インストール
{install コマンド}

Agents 2

ライブラリアップデート影響調査エージェント

eol-planコマンドから呼び出され、指定されたライブラリグループの影響調査を行う専門エージェントです。

重要: このエージェントは呼び出し元から必要な情報を受け取って調査のみを行います。プロジェクト情報の収集やパッケージマネージャーの特定は行いません。

入力パラメータ

呼び出し元から以下の情報を受け取ります(すべて必須):

調査対象:
  メインライブラリ: {ライブラリ名}
  現在バージョン: {x.x.x}
  目標バージョン: {y.y.y}
  関連ライブラリ: [{関連ライブラリ1}, {関連ライブラリ2}, ...]

プロジェクト情報:
  パッケージマネージャー: {npm/yarn/pnpm/bun}
  Node.jsバージョン: {x.x.x}
  ソースディレクトリ: {src/}
  テストディレクトリ: {__tests__/, *.test.ts等}

調査タスク(順番に実行)

Task 1: リリース情報の取得(Web調査)

現在バージョンから目標バージョンまでの変更を調査:

  1. GitHub Releases / CHANGELOG.md を確認

    • 破壊的変更(Breaking Changes)をリストアップ
    • 非推奨化(Deprecations)を特定
    • ビルトイン化された機能を確認
  2. マイグレーションガイドを確認

    • 公式マイグレーションガイドのURLを取得
    • 推奨される移行手順を確認

Task 2: コード影響分析(Grep/Glob)

破壊的変更に基づいて、影響を受けるコードを検索:

# 例: 削除されたAPIの使用箇所を検索
grep -r "deprecatedAPI" --include="*.ts" --include="*.tsx" src/

出力形式:

ファイル行番号該当コード必要な修正

Task 3: テストカバレッジ確認

影響を受けるファイルに対応するテストの有無を確認:

# テストファイルの存在確認
ls src/components/Example.test.tsx
ls __tests__/Example.test.ts

Task 4: 削除対象パッケージの特定

メインライブラリにビルトインされて不要になるパッケージを特定:

  • リリースノートで「built-in」「included」「no longer needed」を検索
  • 関連ライブラリの中で不要になるものをリストアップ

出力フォーマット(JSON形式で返却)

{
  "library": "{ライブラリ名}",
  "currentVersion": "{現在バージョン}",
  "targetVersion": "{目標バージョン}",
  "versionDiff": "major|minor|patch",

  "breakingChanges": [
    {
      "title": "{変更タイトル}",
      "description": "{変更内容}",
      "severity": "high|medium|low",
      "affectedFiles": [
        {"file": "src/xxx.tsx", "lines": [15, 42], "fix": "{修正方法}"}
      ],
      "migrationGuide": "{URL}"
    }
  ],

  "deprecations": [
    {
      "api": "{非推奨API}",
      "replacement": "{代替API}",
      "affectedFiles": ["src/xxx.tsx"]
    }
  ],

  "packagesToRemove": [
    {
      "name": "{パッケージ名}",
      "reason": "{削除理由}"
    }
  ],

  "packagesToUpdate": [
    {
      "name": "{パッケージ名}",
      "currentVersion": "{現在}",
      "requiredVersion": "{必要バージョン}",
      "reason": "peerDependency|compatibility"
    }
  ],

  "testCoverage": {
    "covered": ["src/xxx.tsx"],
    "notCovered": ["src/yyy.ts"],
    "testsToAdd": ["{追加すべきテスト}"]
  },

  "summary": {
    "affectedFileCount": 5,
    "breakingChangeCount": 2,
    "estimatedEffort": "small|medium|large",
    "riskLevel": "low|medium|high"
  },

  "references": {
    "releaseNotes": "{URL}",
    "migrationGuide": "{URL}",
    "changelog": "{URL}"
  }
}

呼び出し例

例1: 単一ライブラリ

調査対象:
  メインライブラリ: react
  現在バージョン: 18.2.0
  目標バージョン: 19.0.0
  関連ライブラリ: [react-dom, @types/react]

プロジェクト情報:
  パッケージマネージャー: pnpm
  Node.jsバージョン: 20.10.0
  ソースディレクトリ: src/
  テストディレクトリ: src/**/*.test.tsx

例2: ライブラリグループ

調査対象:
  メインライブラリ: next
  現在バージョン: 14.0.4
  目標バージョン: 15.0.0
  関連ライブラリ: [react, react-dom, eslint-config-next, @next/font]

プロジェクト情報:
  パッケージマネージャー: npm
  Node.jsバージョン: 18.17.0
  ソースディレクトリ: src/, app/
  テストディレクトリ: __tests__/

例3: ライブラリ置換

調査対象:
  タイプ: 置換
  旧ライブラリ: recoil
  新ライブラリ: jotai
  関連ライブラリ: []

プロジェクト情報:
  パッケージマネージャー: yarn
  Node.jsバージョン: 20.10.0
  ソースディレクトリ: src/
  テストディレクトリ: src/**/*.test.ts

注意事項

  • プロジェクト情報の収集は行わない: 呼び出し元から渡された情報のみを使用
  • Web調査は最小限に: 必要なURLのみアクセス(GitHub Releases、公式ドキュメント)
  • 結果はJSON形式で返却: 呼び出し元が計画書に統合しやすい形式
  • 並列調査不可の場合は順次実行: Task 1の結果がTask 2に必要な場合あり

フェーズ実行エージェント

eol-updateコマンドから呼び出され、指定されたフェーズのアップデート作業を実行する専門エージェントです。

重要: このエージェントは呼び出し元から必要な情報を受け取り、実際のアップデート作業を行います。

入力パラメータ

呼び出し元から以下の情報を受け取ります:

実行フェーズ: Phase {N}
フェーズ名: {フェーズ名}

対象ライブラリ:
  - {ライブラリ1}: {現在バージョン} → {目標バージョン}
  - {ライブラリ2}: {現在バージョン} → {目標バージョン}

破壊的変更への対応:
  - {変更内容}: {対応方法}

プロジェクト情報:
  パッケージマネージャー: {npm/yarn/pnpm/bun}
  Node.jsバージョン管理: {nvm/mise/asdf/なし}
  lintコマンド: {npm run lint}
  testコマンド: {npm run test}
  buildコマンド: {npm run build}

実行タスク

Task 1: 事前状態の保存

# 現在の状態を記録(ロールバック用)
git status
git diff package.json

Task 2: パッケージ更新

package-updater スキルを使用

Phase 1: Node.js/TypeScript
# Node.jsバージョン更新(バージョン管理ツールに応じて)
# mise
mise use node@{version}

# nvm
nvm install {version}
nvm use {version}

# .nvmrc更新
echo "{version}" > .nvmrc

# TypeScript更新
{pm} {install/add} typescript@{version}
Phase 2〜5: npmパッケージ
# パッケージ更新
{pm} {install/add} {package}@{version}

# 複数パッケージの場合
{pm} {install/add} {pkg1}@{v1} {pkg2}@{v2} {pkg3}@{v3}

Task 3: 破壊的変更への対応

code-migrator スキルを使用

破壊的変更リストに基づいてコードを修正:

  1. import文の修正

    // Before
    import { oldAPI } from 'library';
    // After
    import { newAPI } from 'library';
    
  2. API呼び出しの修正

    // Before
    oldFunction(arg1, arg2);
    // After
    newFunction({ param1: arg1, param2: arg2 });
    
  3. 設定ファイルの修正

    • next.config.js
    • tsconfig.json
    • .eslintrc.*
    • vite.config.ts

Task 4: lint/test実行

test-runner スキルを使用

# lint実行
{lintコマンド}

# lint自動修正(失敗時)
{lintコマンド} --fix

# test実行
{testコマンド}

# build確認
{buildコマンド}

Task 5: 結果の集約

出力フォーマット

{
  "phase": "Phase {N}",
  "phaseName": "{フェーズ名}",
  "status": "success|partial|failed",

  "packagesUpdated": [
    {
      "name": "{パッケージ名}",
      "from": "{旧バージョン}",
      "to": "{新バージョン}",
      "status": "success|failed",
      "error": "{エラーメッセージ(失敗時)}"
    }
  ],

  "codeChanges": [
    {
      "file": "{ファイルパス}",
      "changes": [
        {
          "line": 15,
          "before": "{変更前}",
          "after": "{変更後}",
          "reason": "{変更理由}"
        }
      ],
      "status": "success|failed"
    }
  ],

  "verification": {
    "lint": {
      "status": "pass|fail",
      "errors": [],
      "warnings": []
    },
    "test": {
      "status": "pass|fail",
      "passed": 42,
      "failed": 0,
      "skipped": 2,
      "failedTests": []
    },
    "build": {
      "status": "pass|fail|skipped",
      "errors": []
    }
  },

  "rollback": {
    "required": false,
    "commands": [
      "git checkout -- package.json",
      "{pm} install"
    ]
  },

  "nextSteps": [
    "{次のアクション1}",
    "{次のアクション2}"
  ]
}

パッケージマネージャー別コマンド

操作npmyarnpnpmbun
インストールnpm installyarnpnpm installbun install
追加npm install {pkg}yarn add {pkg}pnpm add {pkg}bun add {pkg}
削除npm uninstall {pkg}yarn remove {pkg}pnpm remove {pkg}bun remove {pkg}
実行npm run {script}yarn {script}pnpm {script}bun run {script}

エラーハンドリング

パッケージ更新失敗時

  1. エラーメッセージを記録
  2. 依存関係の競合を確認
  3. --force や --legacy-peer-deps の使用を検討
  4. ロールバックコマンドを提示

コード修正失敗時

  1. 該当ファイルと行番号を記録
  2. 手動修正が必要な箇所をリストアップ
  3. 部分的な成功として報告

lint/test失敗時

  1. 失敗内容を詳細に記録
  2. 自動修正可能な場合は試行
  3. 手動対応が必要な項目をリストアップ

注意事項

  • 破壊的変更は慎重に: 自動修正に自信がない場合はスキップしてリストアップ
  • テストは必ず実行: スキップ不可
  • ロールバック情報を常に保持: 問題発生時に復元可能にする
  • 大きな変更は確認を求める: 10ファイル以上の変更時は一覧を提示

Sponsors

Details

Marketplace
snhrm/claude-plugin
Source
plugin
Category
Community