| 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/ ディレクトリを参照
ベストプラクティス
すべきこと
- セマンティックバージョニング（x.y.z）を厳格に適用
- 変更の影響範囲を事前に分析
- 段階的ロールアウト（10% → 25% → 50% → 100%）を実施
- ロールバック手順を事前に準備
- すべての変更を監査可能な形で記録
- ポストモーテムで学習を蓄積
避けるべきこと
- 一度に100%へのロールアウト
- ヘルスチェックなしのデプロイ
- ロールバック計画なしのリリース
- 変更履歴の記録漏れ
- 問題発生時の責任追及（ブレームレス文化を推進）
リソース参照
references/（詳細知識）
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 | 初版: 基本構造とリソース整備 |
