Content last updated 2026-10-15

チームメンバーデータを編集する

ハンドブックのページやツールにデータを提供する、チームメンバーデータのエントリを確認・更新する方法。

このページでは、チームメンバーデータのエントリ（www-gitlab-com プロジェクト内の 自分の YAML ファイル）を確認・更新する方法と、チームのペットページに自分のペットを追加する方法を説明します。

ハンドブックについては、ハンドブックの編集ページを参照してください。

Workday の同期は、チームメンバーデータのエントリを毎日作成・更新します。たとえば、 グループ別の機能ページには、すべてのプロダクトグループと、その Product Manager、 Engineering Manager、およびその他のカウンターパートが表示されます。これらの人はチームメンバーデータを通じて特定されるため、氏名や GitLab ユーザー名が間違っていると、グループに表示されなくなります。自分のエントリと他のデータとのつながりを参照してください。

自分のエントリに依存する Product と Engineering のワークフロー：

  • レビュアールーレットは、gitlab ユーザー名と projects の役割から、レビュアーとメンテナーを提案します。
  • コードオーナーのレビュー： ハンドブックのページは、gitlab ユーザー名を使って CODEOWNERS のユーザーを特定し、 ページのメンテナーの氏名と写真を表示します。
  • DRI の一覧： 固定カウンターパート、ステージとグループの表、テクニカルライティングの 担当などのハンドブックのページは、name、role、reports_to に基づいてチームメンバーを表示します。
  • コミュニティ貢献のラベル： gitlab が仕事で使用する GitLab アカウントと一致しない場合、マージリクエストにコミュニティ貢献のラベルが付きます。

これらのフィールドを最新の状態に保ってください。story、remote_story、ソーシャルメディアのユーザー名などのプロフィール情報は任意です。 チームデータの同期に関する現在の取り組みは、 FY27 チームデータ同期のエピックを参照してください。

自分のエントリを確認・更新する

GitLab への入社 3 日目に、同期によって、基本的なチームメンバーデータのエントリが追加されます。内容を確認し、情報を追加してください。更新が正しく反映されない場合は、Workday の設定が正しいか確認してください。使用できるすべてのフィールドは、チームメンバーデータのスキーマに記載されています。

エントリの氏名や GitLab ユーザー名が間違っている場合は、Workday でチームデータの設定を更新してください。

エントリの更新方法を選ぶ

必要であれば、#mr-buddies や #handbook の Slack チャンネルを含め、社内の誰にでも助けを求めてください。エントリを更新する方法は 4 つあります。

  1. Web IDE を使って GitLab.com で情報を追加する（推奨）
  2. 「ウェブインターフェース」を使って GitLab.com で情報を追加する
  3. ローカルの Git クローンを使って情報を追加する（ターミナルと IDE を使用）
  4. エージェントに支援を求める

以下から使いやすい方法を選び、次の情報を手元に用意してください。

  • オンボーディングを支援している People Operations チームメンバーの氏名。
  • 写真の要件を満たす自分の写真。
  • （任意）自分の経歴や興味に関するストーリー。（他のチームメンバーのエントリを参考にしてください。）
  • （任意）自分の LinkedIn / Twitter / GitLab のユーザー名。これらを追加する際は、LinkedIn: username のように、リンクや先頭の @ を含めず、ユーザー名だけを記載してください。（誤った例：LinkedIn: linkedin.com/in/username、LinkedIn: @username。）
  • 自分の役割への相対リンク。リンクが https://handbook.gitlab.com/job-description-library/engineering/support-engineer/ の場合は、/job-description-library/engineering/support-engineer/ を使用してください。他のエントリを参考にしてください。

写真の要件

  • 画像を正方形に切り抜きます。
  • 最大サイズは縦横 400 ピクセルです。
  • JPEG（.jpg）または PNG（.png）形式を使用します。
  • ファイルサイズは 100k 未満にします。tinyjpg.comなどで圧縮してください。
  • カラーと白黒で画像を確認します（追加するのはカラー版です）。
  • ファイル名は yournameinlowercase とし、適切な拡張子を付けます。

方法 1：Web IDE を使って GitLab.com で情報を追加する

  1. www-gitlab-com プロジェクトの data/team_members/person フォルダーを開きます。

  2. 自分のスラッグの頭文字に対応するフォルダーを開き、自分のチームメンバーファイルを開きます。たとえば、スラッグが mnohr のチームメンバーのファイルは m/mnohr.yml です。ファイルを素早く見つけるには、t を押してファイル検索を開き、自分の名前を入力するか、プロジェクト内を GitLab ユーザー名で検索します。

    • 注記：Workday の Export Name/Location to Team Page? で No を選択した場合、name は役職名に置き換えられ、変更しても同期によって上書きされます。名前でファイルが見つからない場合は、代わりに GitLab ユーザー名で検索してください。これを変更するには、Workday でチームデータの設定を更新してください。

  3. 編集 > Web IDE で開くを選択します。ウェブエディターが開き、チームメンバーデータのエントリが表示されます。

    www-gitlab-com のチームメンバーファイルで、編集ドロップダウンリストの「Web IDE で開く」を表示している画面

  4. 正しいファイルであることを確認するため、gitlab の値が自分の GitLab.com ユーザー名と一致するか確認します。

  5. 更新するフィールドの説明に従って、自分の情報を更新します。

  6. 写真を追加するには、写真の要件に従って準備します。ファイルエクスプローラーで sites/uncategorized/source/images/team/ フォルダーを右クリックし、アップロードを選択して、写真を選びます。続いて、picture: yournameinlowercase.jpg のように、大文字と小文字を一致させて picture にファイル名を設定します。

  7. Web IDE を使ってハンドブックを編集するの説明に従って、変更を新しいブランチにコミットし、マージリクエストを作成します。

  8. マージリクエストの説明で、変更内容とその理由を説明します。たとえば、Update my team member data. と記載します。

  9. People Operations のオンボーディング担当チームメンバーと自分のマネージャーをレビュアーに追加します。変更をレビューした後、その人たちがマージリクエストを承認し、マージします。

方法 2：「ウェブインターフェース」を使って GitLab.com で情報を追加する

  1. GitLab.com / www-gitlab-com プロジェクトに移動します。
  2. 画面上部付近の赤い線の下にある + をクリックします。
  3. New branch をクリックします。
  4. Branch name には、自分のイニシャル-team-data-update-自分の部署-日付のように一意の名前を付け（作業用の一時的な名前なので、厳密な名前はあまり気にする必要はありません）、Create branch をクリックします。例：hk-team-data-update-custsupport-feb06
  5. まず、自分の画像を追加します。左側の Repository をクリックします。
  6. ファイルブラウザーで、sites/uncategorized/source/images/team に移動します。
  7. ページ上部の + をクリックし、Upload file を選択して写真をアップロードします。必ず写真の要件に従ってください。YourFirstName YourLastName の写真を追加という形式のコミットメッセージを追加します。対象ブランチが、先ほど作成したブランチになっていることを確認します。Start a new merge request with these changes の切り替えをオフにします。Upload file をクリックします。
  8. 次に、自分のチームメンバーデータのエントリを編集します。すべての情報はデータファイルに保存されています。data/team_members/person/FIRST_LETTER_OF_YOUR_SLUG/SLUG_REPLACE.yml に移動します（自分の氏名またはスラッグが記載されたファイルを探します）。
  9. 該当する yourslug.yml ファイルに移動します。画面右上の Edit をクリックし、Edit single file を選択します。
  10. 更新するフィールドの説明に従って、自分の情報を更新します。
  11. 情報を追加した後、コミットメッセージを追加し、「変更をコミット」をクリックします。「新しいマージリクエストを作成」オプションにチェックが入っている場合は、マージリクエスト（MR）が作成されます。
  12. 次に、Create merge request ボタンをクリックし、作成したブランチを使ってマージリクエストを作成します。作成先は GitLab.comです。
  13. Create a new merge request ページに移動したら、Description ボックスの Why is this change being made? 見出しの下で、変更内容とその理由を説明します。この MR では、たとえば Adding my information and picture to my team member data as part of onboarding tasks. と入力できます。この MR では、説明文の他の箇所を変更する必要はありません。
  14. Create merge request をクリックします。
  15. 新しいページの右上にある Reviewer の横の edit をクリックします。People Operations のオンボーディング担当チームメンバーと自分のマネージャーを、このマージリクエストのレビュアーに設定します。

方法 3：ローカルの Git クローンを使って情報を追加する（ターミナルと IDE を使用）

注記： この方法では大規模なリポジトリに対する git clone が必要なため、他の方法より時間がかかる場合があります。

  1. Git の利用を開始するためのドキュメントに従い、Git をダウンロードします。
  2. 手順に従って、SSH キーを作成・追加します。
  3. www-gitlab-com プロジェクトを、コマンドラインのコマンドに関するドキュメントに従い、ターミナルからクローンします。
  4. これから行う変更のために、新しいブランチを作成し、チェックアウトします。
  5. sites/uncategorized/source/images/team/ ディレクトリに自分の写真を追加します。必ず写真の要件に従ってください。
  6. 好みのエディターで data/team_members/person/FIRST_LETTER_OF_YOUR_SLUG/SLUG_REPLACE.yml を開き、自分の氏名またはスラッグがあるファイルを探します。
  7. 更新するフィールドの説明に従って、自分の情報を更新します。
  8. 編集した data/team_members/person/FIRST_LETTER_OF_YOUR_SLUG/ 内のファイルの変更を保存します。
  9. 必要に応じて、プッシュする前にローカルで変更を検証します。www-gitlab-com 開発ガイドの データ変更の検証 に従ってください。
    • 注記：変更のレビューで説明しているように、MR のパイプラインがファイルを自動的に検証します。
  10. 準備ができたら、FirstName LastName のチームメンバーデータを更新というコメントを付けて、変更をステージングし、コミットします。
  11. 自分のブランチをプッシュします。
  12. 作成したブランチを使ってマージリクエストを作成します。作成先は GitLab.comとし、自分のマネージャーをレビュアーに割り当てます。

エージェントに支援を求める

GitLab Duo Agentic Chatを www-gitlab-com プロジェクトで開き、 変更したい内容を説明します。例：

Help me update my biography in the team member YAML data. My name is Michael Friedrich.
Here is my updated biography: <text>. Find my existing entry and show me the proposed diff.

氏名と経歴を自分のものに置き換えてください。エージェントに、 YAML の書式のレビュー、フィールドの重複の特定、変更案の整理を依頼することもできます。 チームメンバーデータのスキーマ を参照先として使い、矛盾する値や Workday が管理するフィールドを指摘するよう依頼してください。

ドラフト MR を依頼する前に、差分を確認してください。関係のないプロフィール情報は維持し、 承認を依頼する前に、変更のレビューに従ってください。

更新するフィールド

エントリ内の次のフィールドを確認・更新してください。チームメンバーデータのスキーマには、すべてのフィールドと、 Workday の同期が管理するフィールドが記載されています。

  • 必要に応じて、name を FirstName LastName または PreferredName LastName に更新します

  • locality は空のままにします

  • country は Remote に設定します

  • role を確認します

  • 役職名が間違っているか未入力の場合は、job_families.yml に移動し、command-F（macOS）または ctrl-F（nix）で自分の役職名を検索します。Web IDE では、command-P（macOS）または ctrl-P（nix）でファイルを検索できます。

  • 自分の役割に職務記述へのリンクがあることを確認します。なければ、リンクを追加します。たとえば、<a href="">Solutions Architect</a> を <a href="/job-description-library/sales/solutions-architect/">Solutions Architect</a> に変更します。

  • reports_to に、自分のマネージャーのチームメンバーデータのエントリにある slug の値が記載されていることを確認します。拡張子を除いたファイル名もスラッグです。つまり、aname.yml のスラッグは aname です。

  • 自分がマネージャーの場合は、直属の部下の reports_to が自分の slug を参照しているか確認します。

  • 現在、借り入れリクエストに基づいて別チームで働いている場合は、次のように borrow を追加し、to と end_date のキーを設定します。

    borrow:
  to: ramya-authappan
  end_date: 2023-09-15

  • work_priorities フィールドに、現在の業務の優先事項を次のような配列で設定します。

    work_priorities:
  - Product Analytics
  - ModelOps

  • プロフィール写真のファイル名を、大文字と小文字を一致させて追加します。../gitlab-logo-extra-whitespace.png がある場合は削除します。入力後の行は、picture: yournameinlowercase.jpg のようになります。

  • departments の一覧が正しいか確認します。他のチームメンバーのものを参考にしてください。

  • 自分の specialtyを追加します。

  • 自分の expertiseを追加します。これは HTML 形式にする必要があります。配列では正しく表示されません。

  • 入力済みでも間違っているデータは更新します。

任意のプロフィール情報：

  • 自分の代名詞を追加します。
  • 他の人が氏名を正しく発音できるよう、フルネームの pronunciation の追加を検討します（たとえば、Sid Sijbrandij なら Sid See-brandy）。
  • Twitter と GitLab のユーザー名を、先頭の @ なしで追加します。
  • Mastodon のアカウントを mastodon.instance/@username の形式で追加します。基本的には、プロフィールリンクから https:// を除いたものです。
  • 自分の story を追加します。他のチームメンバーのストーリーを参考にしてください。
  • リモートワークによって人生が大きく変わった場合は、他のチームメンバーのリモートストーリーを参考に、自分の remote_story の追加を検討します

重要： ページの書式を崩さないよう、tab 文字を使用せず、行間の空白を守ってください。参照するファイル名と拡張子は大文字と小文字を区別し、ファイルが見つからない場合はパイプラインが失敗します。ファイルは空の改行で終わる必要があり、そうでない場合はパイプラインが失敗します。

変更のレビュー

マージリクエストで変更を検証します。

  1. CI/CD パイプラインと、その中のリンタージョブを確認します。これらは、新規および変更されたファイルが、必須プロパティ、スラッグの一意性、reports_to が既存のチームメンバーのエントリを参照していることなど、必要なデータスキーマに一致するか確認します。
  2. レビューを依頼する前に、最新のパイプラインが成功していることを確認します。
  3. www-gitlab-com の MR がマージされると、ハンドブックのプロジェクトは次回のデプロイジョブで更新されたデータを取得できます。ハンドブックの MR がマージされるまでは、しばらく時間がかかることがあります。

Workday でチームデータの設定を更新する

Workday の同期は、Workday の 2 つの設定からチームメンバーデータのエントリを作成・更新します。

  • GitLab ユーザー名：エントリの gitlab フィールドに入力され、たとえばレビュアールーレットなどで、自分の GitLab アカウントと結び付けられます。@ を付けずに、自分の GitLab.com ユーザー名だけを入力してください。氏名やメールアドレスは入力しないでください。
  • 氏名／所在地をチームページにエクスポート：はいに設定すると、同期によって氏名と所在地がエクスポートされます。それ以外の場合、エントリには氏名の代わりに役職名が表示され、name の手動の変更は同期によって上書きされます。

同期で正しい値が使われるよう、チームメンバーデータのエントリだけでなく、Workday の両方の設定を修正してください。

両方の設定を確認・更新するには：

  1. 自分のプロフィールに移動し、プロフィールの表示 > アクション > 追加データ > 発効日付きカスタムオブジェクトの編集を選択します。

    アクションボタンとメニューがある Workday のプロフィール

    「追加データ」と「発効日付きカスタムオブジェクトの編集」がある Workday のアクションメニュー

  2. 今日の日付を選択し、追加データを編集します。

  3. GitLab ユーザー名フォームで、@ を付けずに GitLab ユーザー名を確認または入力し、送信します。

    Workday の GitLab ユーザー名フォーム

  4. 送信済みダイアログで、もう一度追加データの編集を選択します。

    追加データの編集ボタンがある Workday の送信済みダイアログ

  5. 氏名／所在地をチームページにエクスポートで、はいを選択し、送信します。

    「氏名／所在地をチームページにエクスポート」フィールドを「はい」に設定した Workday の画面

自分のエントリと他のデータとのつながり

自分のエントリは、 www-gitlab-com プロジェクト内にある複数のデータファイルの 1 つです。他のファイルがチームメンバーを参照し、ハンドブックのページがそれらを組み合わせます。

  • sections.yml と stages.yml は、各プロダクトセクション、ステージ、グループのカウンターパートを指定します。
  • categories.yml と features.yml は、各グループのプロダクトカテゴリと機能を記述します。
  • projects.yml は、GitLab プロジェクトの一覧です。エントリの projects フィールドは、たとえばレビュアールーレットなどで、これらを参照します。
flowchart LR
  WD[Workday] --> TM[Your team member data]
  ST[Sections and stages] --> FP[Features by Group page]
  CF[Categories and features] --> FP
  TM --> FP
  PR[Projects] --> RR[Reviewer roulette]
  TM --> RR
  TM --> CO[Code owner avatars]

たとえば、グループ別の機能ページは、セクション、ステージ、 カテゴリ、機能、チームメンバーデータを組み合わせます。どのファイルがどのページやツールにデータを提供するかは、 データフローの概要を参照してください。

チームのペットページに自分のペットを追加する

上記の手順で学んだことを使い、チームのペットページに自分のペットを追加することを検討してください。

主な違いは、各項目の名前と場所です。

  1. 写真は petname.jpg または petname.png とし、同じ写真の要件に従ってください。
  2. 写真を sites/uncategorized/source/images/team/pets にアップロードします。
  3. ペットの情報は、data/pets.yml ファイルの末尾に追加してください。
  4. コミットメッセージは、Adding my dog Gary to the Team Pets Page のようなものにできます。
  5. 自分のマネージャーをレビュアーに割り当てます。
    • マネージャーを追加した後、そのアバターに黄色い三角形の警告記号がある場合、その人は承認できますが、マージはできません。マネージャーの承認後、#mr-buddies Slack チャンネルに投稿し、マージを依頼してください。
最終更新 October 28, 2026: Merge pull request #591 from kyama0/translation/batch-2026-10-28-1 (5d840611)
ページのソースコードを見る - ページの編集 - please contribute. Creative Commons License