jpskill.com
🛠️ 開発・MCP コミュニティ

add-git-tag

プロジェクトの節目に、達成事項や次フェーズの計画をまとめた注釈付きGitタグを作成し、記録するSkill。

📜 元の英語説明(参考)

Create an annotated Git tag to mark a project milestone, documenting achievements and next-phase plans. Use when completing a phase, releasing a version, or marking a research checkpoint with a structured summary.

🇯🇵 日本人クリエイター向け解説

一言でいうと

プロジェクトの節目に、達成事項や次フェーズの計画をまとめた注釈付きGitタグを作成し、記録するSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⬇ このSkillをダウンロード(.skill) 元のソースを見る ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-17
取得日時
2026-05-17
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

Gitタグ追加ワークフロー

このワークフローは、現在のGitリポジトリのマイルストーンをタグでマークしたい場合に使用します。エージェントは、コマンドを実行する前に必要な情報をすべてユーザーに尋ねる必要があります。

ステップ1 — 情報の収集（ユーザーに尋ねる）

以下の3つの質問を1つのメッセージでユーザーに尋ねてください（まだコマンドは実行しないでください）：

  1. タグバージョン: タグ名は何にすべきですか？（例: v0.1.3）
  2. 達成事項: このフェーズで何を達成しましたか？（完了した機能/修正の短い箇条書きリストを提供してください）
  3. 次の計画: 次のフェーズで何を計画していますか？（今後の目標の短い箇条書きリストを提供してください）

続行する前に、ユーザーの回答を待ってください。

ステップ2 — タグメッセージの確認（プレビューの表示）

ユーザーの回答を収集した後、ユーザーが確認できるように、完全な注釈付きタグメッセージを作成して表示します。フォーマットは以下の通りです。

Tag: <version>
Date: <current date, YYYY-MM-DD>

## ✅ このフェーズ — 達成されたこと
- <箇条書き1>
- <箇条書き2>
...

## 🚀 次のフェーズ — 計画されていること
- <箇条書き1>
- <箇条書き2>
...

ユーザーに尋ねてください: 「これでよろしいでしょうか？タグを作成してもよろしいですか？」

続行する前に確認を待ってください。

ステップ3 — リポジトリの状態の検証

// turbo 現在のGitプロジェクトルートを検出し、ステータスを確認します。

REPO=$(git rev-parse --show-toplevel 2>/dev/null) && \
git -C "$REPO" log --oneline -5 && \
git -C "$REPO" status --short && \
git -C "$REPO" tag --sort=-version:refname | head -5

これにより、最新の5つのコミット、コミットされていない変更、および最新の5つの既存タグが表示されます。

ステップ4 — 注釈付きタグの作成

// turbo リポジトリのルートを検出し、タグを作成します。

REPO=$(git rev-parse --show-toplevel)
git -C "$REPO" tag -a "<version>" -m "<full_tag_message>"

ここで：

  • <version> はユーザーからのタグ名です（例: v0.1.3）
  • <full_tag_message> はステップ2で作成された完全なフォーマット済みメッセージです

ステップ5 — タグをリモートにプッシュ（最初に尋ねる）

ユーザーに尋ねてください: 「タグ <version> をリモートリポジトリ（origin）にプッシュしますか？」

はいの場合： // turbo

REPO=$(git rev-parse --show-toplevel)
git -C "$REPO" push origin "<version>"

いいえの場合、タグがローカルで作成され、後で以下のコマンドでプッシュできることをユーザーに伝えます。

git push origin <version>

ステップ6 — 成功の確認

REPO=$(git rev-parse --show-toplevel)
git -C "$REPO" tag -n1 <version>

結果をユーザーに報告します。

  • 作成されたタグを表示します
  • リモートにプッシュされたかどうかを確認します
  • git tag -n1 --sort=-version:refname ですべてのタグを表示できることをユーザーに思い出させます
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Add Git Tag Workflow

Use this workflow whenever the user wants to mark a milestone in the current Git repository with a tag. The agent must ask the user for all required information before executing any commands.

Step 1 — Gather Information (Ask the user)

Ask the user the following three questions in a single message (do NOT run any commands yet):

  1. Tag version: What should the tag name be? (e.g. v0.1.3)
  2. Achievements: What was accomplished in this phase? (provide a short bullet-point list of features/fixes completed)
  3. Next plans: What is planned for the next phase? (provide a short bullet-point list of upcoming goals)

Wait for the user's answers before proceeding.

Step 2 — Confirm the tag message (Show a preview)

After collecting the user's answers, compose and display the full annotated tag message for the user to review. The format should be:

Tag: <version>
Date: <current date, YYYY-MM-DD>

## ✅ This Phase — What Was Achieved
- <bullet 1>
- <bullet 2>
...

## 🚀 Next Phase — What's Planned
- <bullet 1>
- <bullet 2>
...

Ask the user: "Does this look good? Should I go ahead and create the tag?"

Wait for confirmation before proceeding.

Step 3 — Verify the repository state

// turbo Detect the current Git project root and check status:

REPO=$(git rev-parse --show-toplevel 2>/dev/null) && \
git -C "$REPO" log --oneline -5 && \
git -C "$REPO" status --short && \
git -C "$REPO" tag --sort=-version:refname | head -5

This gives the last 5 commits, any uncommitted changes, and the 5 most recent existing tags.

Step 4 — Create the annotated tag

// turbo Detect the repo root and create the tag:

REPO=$(git rev-parse --show-toplevel)
git -C "$REPO" tag -a "<version>" -m "<full_tag_message>"

Where:

  • <version> is the tag name from the user (e.g. v0.1.3)
  • <full_tag_message> is the full formatted message from Step 2

Step 5 — Push the tag to remote (ask first)

Ask the user: "Would you like to push the tag <version> to the remote repository (origin)?"

If yes: // turbo

REPO=$(git rev-parse --show-toplevel)
git -C "$REPO" push origin "<version>"

If no, inform the user that the tag was created locally and can be pushed later with:

git push origin <version>

Step 6 — Confirm success

REPO=$(git rev-parse --show-toplevel)
git -C "$REPO" tag -n1 <version>

Report the outcome to the user:

  • Show the tag that was created
  • Confirm whether it was pushed to remote
  • Remind the user they can view all tags with git tag -n1 --sort=-version:refname