Agent skill

worktree-manager

Git worktreeの作成・管理を行うスキル。複雑なタスクや複数ファイル変更時にworktree作成を提案、タスク完了時にマージ・クリーンアップを案内。checkpoint-managerと連携。

View SKILL.md on GitHub Repository
Stars 1
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/dobachi/AI_Instruction_Kits/tree/main/templates/claude-skills/ja/worktree-manager

SKILL.md

Worktree管理スキル

Git worktreeを活用して、タスクごとに独立した作業環境を提供するスキルです。

自動提案のタイミング

状況 提案内容
複数ファイル変更タスク開始時 「worktreeを作成しますか？」
チェックポイント開始後 「タスク用のworktreeを作成しますか？」
タスク完了時 「worktreeをマージ・クリーンアップしますか？」
孤立worktree検出時 「不要なworktreeをクリーンアップしますか？」

ワークフロー概要

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  create     │    │  作業実施   │    │  complete   │    │  clean      │
│  worktree   │ → │  (worktree  │ → │  マージ     │ → │  クリーン   │
│  作成       │    │   内で)     │    │  削除       │    │  アップ     │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘

コマンド一覧

bash
# 新しいworktreeを作成
scripts/worktree-manager.sh create <task-id> <description>

# アクティブなworktreeを一覧表示
scripts/worktree-manager.sh list

# worktreeのパスを表示（切り替え用）
scripts/worktree-manager.sh switch <task-id>

# worktreeを完了（マージ/削除オプション）
scripts/worktree-manager.sh complete <task-id>

# 孤立したworktreeをクリーンアップ
scripts/worktree-manager.sh clean

使用シナリオ

シナリオ1: 新規タスクでworktree作成

チェックポイント開始後、worktreeを作成して独立環境で作業：

AI: worktreeを作成しますか？
    タスク: [タスク名]
    タスクID: TASK-123456-abc123

# 実行
scripts/worktree-manager.sh create TASK-123456-abc123 "feature-dev"
cd .gitworktrees/ai-TASK-123456-abc123-feature-dev/

シナリオ2: worktree一覧確認

AI: アクティブなworktreeを確認しますか？

# 実行
scripts/worktree-manager.sh list

シナリオ3: タスク完了時のworktree処理

AI: worktreeをマージしてクリーンアップしますか？

# 実行
scripts/worktree-manager.sh complete TASK-123456-abc123
# オプション: 1)マージして削除 2)保持 3)マージせず削除

シナリオ4: クリーンアップ

AI: 孤立したworktreeをクリーンアップしますか？

# 実行
scripts/worktree-manager.sh clean

checkpoint-managerとの連携

推奨ワークフロー：

bash
# 1. タスク開始
scripts/checkpoint.sh start "機能開発" 3
# → TASK-123456-abc123

# 2. worktree作成
scripts/worktree-manager.sh create TASK-123456-abc123 "feature-dev"
cd .gitworktrees/ai-TASK-123456-abc123-feature-dev/

# 3. 作業実施...

# 4. タスク完了
scripts/checkpoint.sh complete TASK-123456-abc123 "完了"

# 5. worktreeマージ・削除
scripts/worktree-manager.sh complete TASK-123456-abc123

判断基準

worktree作成を提案する条件

  • 複数ファイルにまたがる変更が予想される
  • リファクタリングや大規模な機能追加
  • 既存のコードに影響を与える可能性がある変更
  • チェックポイントが開始されている

worktreeを提案しない条件

  • 単一ファイルの小さな修正
  • ドキュメントのみの更新
  • 設定ファイルの変更のみ

注意事項

  • worktreeは .gitworktrees/ ディレクトリに作成される
  • ブランチ名は ai-<task-id>-<description> 形式
  • scripts/worktree-manager.sh はプロジェクトルートから実行
  • worktree内でも scripts/checkpoint.sh は使用可能

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

dobachi/AI_Instruction_Kits

auto-build

プロジェクトタイプを自動検出してビルドを実行するスキル。コード変更後にビルドを提案、エラー発生時は修正案を提示。Node.js、Rust、Python、Go、Makefileプロジェクトに対応。

1 0
Explore
dobachi/AI_Instruction_Kits

checkpoint-manager

タスクの進捗を追跡・管理するスキル。会話開始時に未完了タスクを確認、新規タスク依頼時にタスク開始を提案、作業完了時に完了報告を提案。チェックポイントシステムと連携。

1 0
Explore
dobachi/AI_Instruction_Kits

commit-safe

安全なコミットを支援するスキル。変更内容を確認してから選択的にコミット。大きな変更時にファイル指定コミットを提案、git add -Aの使用を防止。

1 0
Explore
dobachi/AI_Instruction_Kits

auto-build

Skill for auto-detecting project type and executing builds. Suggests builds after code changes, proposes fixes for build errors. Supports Node.js, Rust, Python, Go, and Makefile projects.

1 0
Explore
dobachi/AI_Instruction_Kits

checkpoint-manager

Skill for tracking and managing task progress. Checks pending tasks at conversation start, proposes task creation for new requests, suggests completion reports when work is done. Integrates with checkpoint system.

1 0
Explore
dobachi/AI_Instruction_Kits

commit-safe

Skill for safe commits. Reviews changes before selective commits. Proposes file-specific commits for large changes, prevents use of git add -A.

1 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results