mcpField
A
add-git-tag

add-git-tag

github.com/a-green-hand-jack開発49 回インストール
リポジトリ

add-git-tag について

add-git-tagは、Gitリポジトリのマイルストーンを計画し、タグを作成するワークフロー型スキルです。注釈付きタグの作成前に内容を提示して確認を求め、リモートへのプッシュは別途許可を得ます。

主な機能

  1. 01入力やリポジトリ履歴から節目の情報を収集
  2. 02注釈付きタグの内容を確認用に提示
  3. 03承認後に注釈付きGitタグを作成
  4. 04タグのプッシュ前に許可を確認
  5. 05タグ作成とプッシュの結果を報告

活用シーン

  1. 01プロジェクトの節目に向けたタグ説明の作成
  2. 02最近のコミットからマイルストーン案を提案
  3. 03確認後にローカルのリリースタグを作成
  4. 04必要に応じてタグをoriginへプッシュ

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/a-green-hand-jack/ml-research-skills --skill add-git-tag

インストール後、Claude Code で/add-git-tagを入力して読み込まれたか確認します。

詳細

Git タグ追加ワークフロー

ユーザーが現在の Git リポジトリのマイルストーンをタグで記録したい場合は、常にこのワークフローを使用します。エージェントは読み取り専用のサイドカーを使って Git 履歴からマイルストーンの内容を提案できますが、タグを作成またはプッシュする前の人による確認は、メインエージェントが必ず行います。

実行契約

  • デフォルトの実行者：メインエージェント。
  • サイドカーの使用対象：可。読み取り専用のマイルストーン提案の生成に限ります。
  • 推奨サイドカーモデル：codex exec --ephemeral 経由の gpt-5.3-codex-spark。
  • サイドカーの権限：read-only。
  • 人による確認：git tag -a の前、および git push origin <tag> の前。
  • 最終操作：タグの作成とプッシュは、メインエージェントのみが行います。
  • サイドカーを使用する場合に必要な成果物：.agent/sidecars/<task-id>/prompt.md、output.md、model.json、decision.md。

手順 1 — マイルストーン情報を収集または提案する

ユーザーが次の 3 項目をすべて提示している場合は、その内容をそのまま使用します。

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

項目が 1 つ以上不足していても、最初からすべてをユーザーに記入させないでください。まずリポジトリの状態を調べ、利用可能であれば sidecar-task-runner を使用して、最近のコミット、タグ、README や変更履歴の抜粋、プロジェクトのメモリから提案を作成します。

読み取り専用コンテキストコマンド：

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

推奨サイドカープロンプト：

Use recent git history and visible project docs to propose an annotated milestone tag.
Do not create a tag, commit, push, or edit production files.

Return:
- suggested tag name
- achievements as concise bullets with commit evidence
- next plans as concise bullets inferred from docs or TODOs
- uncertainty notes where the evidence is weak

サイドカーを実行できない場合は、読み取り専用の Git コンテキストを自分で確認し、不足している項目や不確かな項目のみをユーザーに尋ねます。

手順 2 — タグメッセージを確認する（プレビューを表示）

ユーザーから情報を収集するか、サイドカーから提案を得た後、ユーザーが確認できるよう、注釈付きタグメッセージ全体を作成して表示します。形式は次のとおりです。

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>
...

ユーザーに次のように尋ねます：「この内容でよろしいですか？タグを作成してもよいですか？」

確認を得てから先に進みます。

手順 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 ですべてのタグを表示できることをユーザーに伝える

コメント

Markdown 対応