Version Control For Docs

Version Control for Docs

概要

Gitを活用したドキュメントのバージョン管理と変更履歴管理の専門スキル。4つの専門エージェントによる包括的なドキュメント管理ワークフローを提供します。

エージェント構成

ワークフロー

Phase 1: 戦略策定

目的: ドキュメント管理のブランチ戦略とコミット規約を決定

アクション:

1. branch-strategy でブランチモデルを選択
2. commit-message でコミット規約を策定
3. チーム規模・更新頻度に応じた戦略調整

Phase 2: 実装と運用

目的: 策定した戦略に基づいてドキュメント管理を実施

アクション:

1. ブランチ作成・コミット・マージを実施
2. changelog-generation でChangelog自動生成
3. pr-review でPRテンプレート・チェックリスト適用

Phase 3: 検証と改善

目的: 運用結果を検証し継続的に改善

アクション:

1. scripts/validate-skill.mjs で構造検証
2. scripts/generate-changelog.mjs でChangelog生成
3. scripts/log_usage.mjs で使用記録

Task仕様ナビ

ベストプラクティス

すべきこと

• Conventional Commits形式でコミットメッセージを記述する
• ドキュメント変更は必ずブランチを作成してから実施
• PRには必ずレビューチェックリストを添付
• scripts/generate-changelog.mjs でChangelog自動生成

避けるべきこと

• main/masterブランチへの直接コミット
• コミットメッセージにprefixを付けない
• Changelogを手動で更新する（自動化推奨）
• レビューなしでマージする

リソース参照

エージェント

リファレンス

アセット

スクリプト

変更履歴