prompt-versioning-management

name	prompt-versioning-management
description	プロンプトのライフサイクル管理を専門とするスキル。バージョン管理、デプロイ戦略、ロールバック、変更追跡により、本番環境で安全かつ効率的なプロンプト運用を実現します。 Anchors: • The Pragmatic Programmer (Andrew Hunt, David Thomas) / 適用: 手順設計と実践的改善 / 目的: 体系的なバージョン管理 • Continuous Delivery (Jez Humble) / 適用: デプロイパイプラインとロールバック戦略 / 目的: 安全なリリースプロセス • Semantic Versioning 2.0.0 / 適用: バージョン番号付けルール / 目的: 変更の影響範囲の明確化 Trigger: Use when managing prompt versions, deploying prompts to production, implementing rollback strategies, tracking prompt changes, or establishing prompt lifecycle management. Keywords: prompt versioning, semantic versioning, deployment strategy, rollback, change tracking, prompt lifecycle, blue-green deployment
allowed-tools	["Read","Write","Edit","Bash","Glob","Grep"]

Prompt Versioning Management

概要

プロンプトのライフサイクル管理を専門とするスキル。セマンティックバージョニングに基づくバージョン管理、Blue-Green/Canaryデプロイ戦略、迅速なロールバック、変更追跡により、本番環境で安全かつ効率的なプロンプト運用を実現します。

ワークフロー

Phase 1: バージョン計画

目的: プロンプト変更を分類し、適切なバージョン番号と影響範囲を決定

Task: agents/version-planning.md

入力:

• 現在のバージョン
• 変更内容の詳細
• 依存関係情報

出力:

• バージョン計画書（新バージョン・変更タイプ）
• 影響分析レポート
• デプロイ計画

実行タイミング: プロンプト変更時、リリース計画策定時

Phase 2: デプロイ実行

目的: 計画に基づき安全にデプロイを実行し、段階的ロールアウトを管理

Task: agents/deployment-execution.md

入力:

• Phase 1 のバージョン計画書
• デプロイ対象環境
• ロールアウト設定

出力:

• デプロイログ
• ヘルスチェック結果
• ロールアウト進捗記録

実行タイミング: バージョン計画完了後、本番デプロイ時

Phase 3: ロールバック・監査

目的: 問題発生時の迅速な復旧と、すべての変更の追跡・監査

Task: agents/rollback-audit.md

入力:

• デプロイログ
• ヘルスチェック結果
• 前バージョン情報

出力:

• ロールバック記録
• インシデントレポート
• 監査ログ
• ポストモーテム

実行タイミング: デプロイ問題発生時、定期監査時

Task仕様

Task	起動タイミング	入力	出力
version-planning	Phase 1開始時	変更内容・現バージョン	バージョン計画・影響分析
deployment-execution	Phase 2開始時	計画書・環境設定	デプロイログ・ヘルスチェック
rollback-audit	Phase 3開始時	デプロイログ・問題詳細	ロールバック記録・監査ログ

詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照

• agents/version-planning.md
• agents/deployment-execution.md
• agents/rollback-audit.md

ベストプラクティス

すべきこと

• セマンティックバージョニング（x.y.z）を厳格に適用
• 変更の影響範囲を事前に分析
• 段階的ロールアウト（10% → 25% → 50% → 100%）を実施
• ロールバック手順を事前に準備
• すべての変更を監査可能な形で記録
• ポストモーテムで学習を蓄積

避けるべきこと

• 一度に100%へのロールアウト
• ヘルスチェックなしのデプロイ
• ロールバック計画なしのリリース
• 変更履歴の記録漏れ
• 問題発生時の責任追及（ブレームレス文化を推進）

リソース参照

references/（詳細知識）

リソース	パス	内容
基礎知識	references/Level1_basics.md	基礎概念と用語
実務パターン	references/Level2_intermediate.md	実務での適用
高度な戦略	references/Level3_advanced.md	高度なデプロイ戦略
専門トラブルシューティング	references/Level4_expert.md	専門的な問題解決
バージョニング戦略	references/versioning-strategies.md	セマンティックバージョニング
デプロイパターン	references/deployment-patterns.md	Blue-Green/Canary
ロールバック手順	references/rollback-procedures.md	復旧手順と監査

scripts/（決定論的処理）

スクリプト	用途	使用例
log_usage.mjs	使用履歴記録	node scripts/log_usage.mjs --result success --phase planning
validate-skill.mjs	構造検証	node scripts/validate-skill.mjs

assets/（テンプレート）

テンプレート	用途
changelog-template.md	チェンジログ作成
deployment-checklist.md	デプロイ前チェックリスト

変更履歴

Version	Date	Changes
3.0.0	2026-01-02	18-skills.md仕様完全準拠: 3 Tasks追加、ワークフロー体系化
1.0.0	2025-12-24	初版: 基本構造とリソース整備