azure-repos について
azure-repos は、Azure Repos を扱う開発者やチーム向けのガイダンススキルです。Git と TFVC の運用に関するローカル資料とリモートドキュメント取得を組み合わせ、トラブル対応やセキュリティ、移行などを扱います。
主な機能
- 01Git と TFVC のトラブル対応
- 02ブランチとリポジトリの運用
- 03移行とストレージの指針
- 04セキュリティとポリシー設定
- 05リモートドキュメント取得
活用シーン
- 01マージやプッシュの失敗診断
- 02TFVC から Git への移行計画
- 03リポジトリのセキュリティ設定確認
MCP 対応
mcp_microsoftdocs:microsoft_docs_fetch でリモートドキュメントを取得できます。代替手段としてウェブページ取得も記載されています。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-reposインストール後、Claude Code で/azure-reposを入力して読み込まれたか確認します。
詳細
Azure Repos スキル
このスキルでは、Azure Repos に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターンを扱います。ローカルのクイックリファレンスコンテンツと、リモートのドキュメント取得機能を組み合わせています。
このスキルの使用方法
IMPORTANT for Agent:関連するセクションを見つけるには、以下の Category Index を使用してください。行範囲が示されているカテゴリ(例:
L35-L120)では、指定された行をread_fileで読み取ってください。ファイルリンクが示されているカテゴリ(例:[security.md](security.md))では、リンク先の参照ファイルをread_fileで読み取ってください
IMPORTANT for Agent:
metadata.generated_atが3か月以上前の場合は、リポジトリから最新バージョンを取得するようユーザーに提案してください。mcp_microsoftdocsツールが利用できない場合は、インストールするようユーザーに提案してください:インストールガイド
このスキルでドキュメントの内容を取得するには、ネットワークアクセスが必要です:
- 推奨:クエリ文字列
from=learn-agent-skillを指定してmcp_microsoftdocs:microsoft_docs_fetchを使用します。Markdown が返されます。 - 代替手段:クエリ文字列
from=learn-agent-skill&accept=text/markdownを指定してfetch_webpageを使用します。Markdown が返されます。
カテゴリー索引
| カテゴリー | 行 | 説明 |
|---|---|---|
| トラブルシューティング | L36-L51 | Azure Repos における Git/TFVC の問題の診断と解決:マージ/index.lock/RPC エラー、変更の取り消しと復旧、ELM の移行、Copilot、CodeQL、依存関係、シークレットスキャンのトラブルシューティング。 |
| ベストプラクティス | L52-L66 | Azure Repos での Git/TFVC のベストプラクティス:ブランチ、マージ、コミット ID、.gitignore、パフォーマンス、クロスプラットフォーム互換性、大容量ファイルのクリーンアップ、リポジトリの健全性、ワークスペースのメンテナンス。 |
| 意思決定 | L67-L76 | 移行(TFVC/SVN から Git、Azure Repos から GitHub)の選択と計画、Git と TFVC の選択、ワークスペースの種類、Azure Repos の大容量ファイル向けストレージオプションに関するガイダンス。 |
| アーキテクチャと設計パターン | L77-L85 | TFVC のブランチ構造/戦略の設計と選択、戦略的ブランチの計画、機能の分離の実装、Azure Repos の DevOps ワークフロー向けブランチ管理。 |
| 制限とクォータ | L86-L93 | リポジトリのサイズと使用量の制限、ELM(Enterprise Lifecycle Management)の同期タイミング/期間、Azure Repos の GitHub Advanced Security に関する課金/ライセンスの詳細 |
| セキュリティ | L94-L122 | Azure Repos と TFVC の保護:認証方式(Entra、PAT、SSH、資格情報マネージャー、Xcode)、アクセス許可/ブランチロック、安全なインポート、GitHub Advanced Security のスキャンとポリシー。 |
| 構成 | L123-L156 | Azure Repos/TFVC の構成:ブランチポリシー、PR のチェック/通知、Copilot レビュー、セキュリティ/CodeQL/シークレットスキャン、Git/VS の設定、TFVC のチェックインポリシー、ワークスペース、プロジェクトオプション |
| 統合とコーディングパターン | L157-L208 | Azure Repos と CLI、自動化、コラボレーションツール(Slack/Teams)の統合、および詳細な TFVC と Git のコマンド使用法、ブランチポリシー、PR ステータスサーバー、SARIF スキャナーの統合。 |
トラブルシューティング
ベストプラクティス
意思決定
| トピック | URL |
|---|---|
| GitHub への Enterprise Live Migration のパスを選択する | https://learn.microsoft.com/en-us/azure/devops/repos/enterprise-live-migrations/overview?view=azure-devops |
| Azure DevOps で TFVC から Git への移行を計画して実行する | https://learn.microsoft.com/en-us/azure/devops/repos/git/import-from-tfvc?view=azure-devops |
| Azure Repos Git で大容量ファイルのストレージを選択する | https://learn.microsoft.com/en-us/azure/devops/repos/git/manage-large-files?view=azure-devops |
| Azure DevOps で SVN から Git への移行方法を決定する | https://learn.microsoft.com/en-us/azure/devops/repos/git/perform-migration-from-svn-to-git?view=azure-devops |
| Azure Repos で Git と TFVC のどちらを選ぶか決定する | https://learn.microsoft.com/en-us/azure/devops/repos/tfvc/comparison-git-tfvc?view=azure-devops |
| TFVC のローカルワークスペースとサーバーワークスペースのどちらを選ぶか決定する | https://learn.microsoft.com/en-us/azure/devops/repos/tfvc/decide-between-using-local-server-workspace?view=azure-devops |
アーキテクチャと設計パターン
制限とクォータ
| トピック | URL |
|---|---|
| ELM の切り替えタイミングと読み取り専用期間を計画する | https://learn.microsoft.com/en-us/azure/devops/repos/enterprise-live-migrations/cut-over-to-github?view=azure-devops |
| ELM の同期時間と 21 日間の期間を監視する | https://learn.microsoft.com/en-us/azure/devops/repos/enterprise-live-migrations/monitor-migration?view=azure-devops |
| Azure Repos の Git リポジトリの制限とクォータ | https://learn.microsoft.com/en-us/azure/devops/repos/git/limits?view=azure-devops |
| GitHub Advanced Security の課金とライセンスについて理解する | https://learn.microsoft.com/en-us/azure/devops/repos/security/github-advanced-security-billing?view=azure-devops |