setup-my-iq

My IQ のセットアップ：コンテキストポートフォリオの作成と更新

個人のコンテキストポートフォリオを作成し、維持します。これは、自分がどのような人で、どのように働き、何を大切にしているかを表す、構造化された Markdown ファイルのセットです。ファイルは、ディスク上のどこに置いてもかまいません（OneDrive フォルダー、git リポジトリ、ローカルディレクトリなど）。これらのファイルをエージェントに関連付けるのは、ユーザーのカスタム指示ファイル（AGENTS.md、copilot-instructions.md、CLAUDE.md、またはホストがセッションに読み込む任意の *.instructions.md）に記載された参照先です。

このスキルの動作

呼び出されたら、現在の状態を確認し、適切な対応を行います。

既存のコンテキストを確認する

このスキルが作成するファイルへの参照をセッション内で検索します。ホストは、関連するすべてのカスタム指示ファイルをすでにセッションに統合しています。対象は、AGENTS.md（ワークスペースまたはユーザースコープ）、copilot-instructions.md、CLAUDE.md、任意の *.instructions.md ファイル、およびホスト固有の同等のファイルです。参照先がどのファイルに記載されているかは問いません。次のファイル名を検索してください。

• identity.md
• role-and-responsibilities.md
• team.md
• tools-systems-and-config.md
• communication-style.md
• preferences-and-constraints.md

各ファイルについて、読み込まれた指示テキストのどこかにある @<absolute-path>（または同等のパス参照）を探します。それがファイルの場所です。パスの隣にあるラベルや変数名は当てにしないでください。ユーザーは参照先に異なる名前（identityProfile、me、who-i-am など）を付けていることがあります。パスの末尾にあるファイル名で判断してください。

各ファイルを次のように分類します。

• 未参照 — このファイルへのパスがセッションに読み込まれていません。
• 参照あり・ファイルなし — パスは読み込まれていますが、ディスク上にファイルがありません。
• 存在 — パスが読み込まれており、ファイルも存在します。プレースホルダーがないか確認するため、内容を読みます。

6 つのファイルの状態が混在している場合は、次の優先順位で対応します。まず、未参照のファイルをインタビューを通じて作成し、次に参照あり・ファイルなしの項目を埋め、最後に存在するファイルの未完了項目を修正します。開始前に状態をまとめてユーザーに伝え、どのような対応になるかを知らせます。

具体例を示します。identity.md と team.md は存在して内容も揃っており、tools-systems-and-config.md は存在するものの ADO セクションに TODO プレースホルダーがあります。role-and-responsibilities.md と communication-style.md は参照されていますが、ディスク上にファイルがありません。また、preferences-and-constraints.md はまだ参照されていません。この場合、スキルはユーザーに次のように伝えます。「identity と team の設定は完了しています。tools-config には不足があります。role と communication-style は参照されていますが、ファイルがありません。preferences はまだ設定されていません。まず preferences についてお聞きし、その後 role と communication-style を作成してから、tools-config の不足を補います。よろしいですか？」

1. コンテキストファイルが参照されていない場合

読み込まれた指示のどこにも、対象のファイル名が見つからない場合です。初回セットアップとして扱い、以下の 初回セットアップ を実行します。

2. 参照されているファイルの一部がディスク上にない場合

ユーザーが以前にセットアップを開始して完了していないか、パスだけが存在してファイルがない状態です。前回の続きから再開します。

• 存在するファイルと不足しているファイルを一覧表示します。
• ユーザーに次のように伝えます。「{existing files} はあります。不足しているもの：{missing files}。前回の続きから再開しますか？」
• 次にインタビューするファイルを選ぶ際は、既存のコンテキストを確認する の優先順位に従います。同順位の場合は、次の順序を既定として使用します：identity -> role -> team -> tools -> communication-style -> preferences-and-constraints。

3. ファイルは存在するが、フィールドが未入力です

ファイルは存在しますが、未入力のプレースホルダー値が含まれているものがあります。不足箇所を埋めます：

• 参照されているすべてのファイルをスキャンし、次のような未入力フィールドのパターンを探します：
  • `` — 明示的なプレースホルダー
  • 値の代わりに使われている、形式の HTML コメント （例：, , ）
  • 内容が HTML コメントだけのテーブルセルまたはフィールド
• 不足箇所を一覧表示します：「{files} に未入力のフィールドが見つかりました。埋めますか？」
• 各不足箇所について、インタビュー全体ではなく、そのフィールドに関する具体的な質問をします。
• ユーザーの回答を反映し、ファイルを直接更新します。

4. ファイルは完成しており、ユーザーが更新を希望しています

ユーザーが変更を依頼した場合、または「マネージャーが変わった」「新しい人を採用した」「別のチームに異動した」など、会話の中で状況の変化に触れた場合です。対象を絞って更新します：

• ユーザーが別の作業中に変更点に触れた場合は、次のように提案します：「{file} を更新する必要がありそうです。今、修正しますか？」
• ユーザーが明確に依頼した場合は、そのまま進めます。
• 既存のコンテキストの検出で解決したパスからファイルを読み込みます。
• 編集し、ユーザーに完了を伝えます。

5. ファイルは完成しており、全面的な更新を希望しています

ユーザーがファイルを一から作り直したい場合です。初回セットアップと同じ手順に従い、そのファイルについてのインタビューをやり直します。

---

初回セットアップ

このスキル内のすべての assets/... パスは、この SKILL.md のディレクトリからの相対パスです。ファイル読み込みツールを使って、これらのパスにあるテンプレートを読み込んでください。何らかの理由でテンプレートを読み込めない場合は、このファイルの末尾にある使用例に示されたフィールド構成を使用してください。

1. コンテキストディレクトリを選ぶ

次のように尋ねます：「コンテキストファイルはどこに置きますか？永続的に保存できる場所ならどこでもかまいません。同期済みのクラウドフォルダー（OneDrive、Dropbox、iCloud）、ローカルディレクトリ、git リポジトリなどから選べます。後で見つけられるパスを選んでください。」

• ディレクトリが存在しない場合は作成します。
• 後続の手順で使えるよう、パスを保存します。
• macOS または Linux では、デフォルトとして ~/my-iq-context または ~/OneDrive/my-iq-context を提案します。このスキルが後で生成するパスでは、%USERPROFILE% を $HOME に置き換えます。

2. インタビューを始める

次のようにプロセスを紹介します：

「これからインタビューを行い、あなた専用のコンテキストポートフォリオを作成します。これは、あなたがどんな人で、どのように働き、何を大切にしているかを表す一連の Markdown ファイルです。どの AI スキル、エージェント、プラグインでもこれらのファイルを読み込み、すぐにあなたについて理解できます。

ファイルを一つずつ進めます。質問をしてファイルの草案を作成し、その後、間違っているところを教えてもらいます。今は作りたくないファイルはスキップできます。始めてもよいですか？」

3. 利用可能なデータソースから事実情報を事前入力する

面接の質問をする前に、この手順を必ず実行してください。 何も取得できないと思われる場合でも、省略しないでください。

ユーザーに質問する前に、環境で利用できる接続済みのソースから事実情報を収集してください。接続済みのシステムがすでに把握している情報を、ユーザーに入力させてはいけません。

確認する項目（ファイルごと）：

ファイル	事前入力する事実情報
identity.md	名前、役職・肩書き、組織、チーム、マネージャー
role-and-responsibilities.md	担当するチーム、定期的な予定（カレンダーから）、レポートライン
team.md	直属の部下、頻繁に連携する相手、組織図の情報
tools-systems-and-config.md	ADO の組織／プロジェクト／チーム／エリアパス、リポジトリ、使用中のツール
communication-style.md	メール／ドキュメントの文章サンプル（事前に許可を求める）
preferences-and-constraints.md	事前入力なし（主観的な境界に関する項目です）

実行方法：

1. 環境で利用できるデータソース（勤務先プロフィール、ディレクトリ、カレンダー、ADO、メールなど）を確認します。すでに許可されているソースのみを使用してください。
2. これから面接するファイルに関する事実情報を、該当するソースから取得します。
3. 調査結果を提案として提示します。「勤務先プロフィールからいくつか情報を取得しました。以下のとおりです。続ける前に、確認または訂正してください。」
4. どの値が自動入力されたものかをそれぞれ明示し、システムから取得した情報とユーザーに尋ねる情報を区別できるようにします。
5. 事前入力の提案が確認された後（または利用可能なソースがない場合）にのみ、残りの質問をします。

データソースが利用できない場合： そのことを明示して（「この環境では勤務先プロフィールやディレクトリにアクセスできないため、直接お伺いします」）、面接の質問に進みます。この手順を黙って省略してはいけません。

詳細なルールと制約については、「Interview Rules」内の「Pre-fill from available data sources before asking」セクションを参照してください。

4. identity.md のための面接

このスキルバンドルにある assets/templates/identity.md からテンプレートを読み込み、ファイル構造を確認します。

最初に、手順3（事前入力）を適用します。 名前、役職、組織、チーム、マネージャーについて利用可能なソースを確認します。見つかった情報は、確認用に提示します。その後、事前入力でカバーされていない項目について、以下の質問をします。

ユーザーに必ず尋ねる自由回答形式の質問：

• ディナーパーティーで、実際にどのような仕事をしているのか誰かに説明するとしたら、どう伝えますか？
• どのようなことで人から頼られますか？

事前入力でカバーされていない場合にのみ尋ねる事実確認の質問：

• お名前と現在の役職を教えてください。
• どの組織または会社に所属していますか？
• どのチームに所属していますか？
• マネージャーは誰ですか？

ドラフトを作成するのに十分な情報が得られたら（それ以上は質問を続けないでください）、ファイルのドラフトを作成します。リアクション確認の手順（下記のInterview Rulesを参照）とともに提示します。修正した後、コンテキストディレクトリに書き込みます。

移行時の言葉：「identity はこれで完了です。次は role-and-responsibilities です。普段の1週間がどのようなものかをまとめます。準備はよろしいですか？」

5. role-and-responsibilities.md のインタビュー

assets/templates/role-and-responsibilities.md からテンプレートを読み込みます。

最初に、手順 3（事前入力）を適用します。 利用可能なソースを照会し、サポートしているチーム、定期的なカレンダーの頻度、報告先を確認します。質問をする前に、確認できた内容を提示し、確認を求めます。

主な質問：

• 典型的な1週間の流れを教えてください。定期的に行うことは何ですか？
• どのチームやグループをサポートしていますか？
• チームごとに、どのような責任を担っていますか？どのような頻度で業務を行っていますか？
• 定期的にどのような決定をしていますか？大きな戦略的決定ではなく、日常的なものについて教えてください。
• 何を作成していますか？レポート、メール、ダッシュボードなどですか？
• 誰に報告していますか？
• 業務に影響する月次または四半期ごとのサイクルはありますか？

ドラフト作成に十分な情報が集まったら、ドラフトを作成します。チームごとに構成し、各チームに責任、定期的な業務、成果物を記載したセクションを設けます。提示し、修正し、書き込みます。

移行時：「役割と責任はこれで完了です。次はチームです。仕事で関わる重要な人たちについて扱います。準備はいいですか？」

6. team.md のインタビュー

assets/templates/team.md からテンプレートを読み込みます。

最初に、手順 3（事前入力）を適用します。 利用可能なソースを照会し、直属の部下、組織図、頻繁に協業する人（カレンダー／チャットから）を確認します。質問をする前に、確認できた内容を提示し、確認を求めます。

主な進め方：

• 最も頻繁にやり取りする人は誰ですか？まず自分のチームから始めます。
• チーム名簿を求めます（ユーザーがメールアドレスの一覧を貼り付ける場合があります）。
• チームごとに、リーダーと階層構造を特定します。
• 重要な人について、相手があなたに何を求めているか、あなたが相手に何を求めているかを確認します。
• 分かる範囲で、各人の重点領域や柱となる分野を記録します。
• 1:1、スクラム、同期など、やり取りのパターンを記録します。
• 特定の人とのやり取りや、その準備についてエージェントが知っておくべきことはありますか？

以前のファイルの情報を活用します。役割のインタビューで協業相手について言及されていた場合は、ここで再度質問せず、その人たちを挙げます。ドラフトを作成し、提示し、修正し、書き込みます。

移行時：「チームはこれで完了です。最後はツール、システム、設定です。すべてがどのように設定されているかを記録します。準備はいいですか？」

7. tools-systems-and-config.md のインタビュー

assets/templates/tools-systems-and-config.md からテンプレートを読み込みます。

最初に、手順 3（事前入力）を適用します。 利用可能なソースを照会し、ADO の組織／プロジェクト／チーム／エリアパス、リポジトリ、ツールの設定を確認します。質問をする前に、確認できた内容を提示し、確認を求めます。

主な質問：

• 毎日どのようなツールやプラットフォームを使っていますか？
• 会議のメモはどのように整理していますか？どこに保存されていますか？
• 会議を種類やチームごとに分類するタグやパターンはありますか？

次に、ユーザーがサポートする各ワークストリーム／チームについて（役割と責任のインタビューの情報を使用します）：

ユーザーが3つを超えるワークストリームをサポートしている場合は、まず、今すべてを設定するか、最も重要な1つまたは2つから始めて残りは後で追加するかを尋ねます。類似したワークストリームについては、同じ設定を適用するかどうかを尋ね、違いについてのみインタビューします。

• このワークストリームでは Azure DevOps を使っていますか？使っている場合、組織、プロジェクト、チーム、エリアパスは何ですか？使っていない場合は、このワークストリームの ADO セクションを省略します。
• （ADO を使用するワークストリームのみ）スプリントスコアカードから除外する作業項目のタイトルパターンはありますか？（例：見積もりやレビュー用のプレースホルダー項目）
• このワークストリームの戦略上の柱やセクションは何ですか？週次更新やスプリントレポートでグループ化の見出しとして使用されます。ワークストリームで ADO を使わない場合も定義します。
• ADO を使用するワークストリームの場合、各柱に対応する ADO エピックはどれですか？
• スプリント更新はどこに保存しますか？ファイルのプレフィックスは何ですか？
• 週次更新はどこに保存しますか？ファイルのプレフィックスは何ですか？
• このワークストリームのロードマップファイルはありますか？

共通設定を先頭にまとめ、その下のセクションにワークストリーム固有の設定を整理します。ドラフトを作成し、提示し、修正し、書き込みます。

移行時：「ツールと設定はこれで完了です。次はコミュニケーションスタイルです。エージェントがあなたの代わりに文章を書くとき、あなたらしい表現にできるようにします。準備はいいですか？」

8. communication-style.md の聞き取り

assets/templates/communication-style.md からテンプレートを読み込みます。

このセクションはほかより難しいものです。自分の話し方について尋ねると、決まり文句で説明する人が多いためです。より効果的な方法は2つあります。避けたいことを尋ねることと、実際の文章サンプルの分析を提案することです。両方を使います。

まず、サンプルを共有する方法を提案します。

「実際に書いた文章のサンプルをいくつか共有しますか？送信したものを2〜5件貼り付けてください。週次の進捗報告、リーダー向けメール、Loop の更新、レビューの記入内容、自信を持って送れた Teams メッセージなどです。読んで、そこからわかる話し方の特徴を抽出し、ファイルに記載する内容を提案します。何かを書き込む前に、必ずあなたに確認してもらいます。元の文章はコピーせず、文体のパターンだけを使います。」

ユーザーがサンプルを共有した場合：

• 各サンプルは文体だけを読み取ります。文体の格式、文の長さ、書き出し、つなぎ方、使う特定の言葉や避ける言葉、話の組み立て方、功績の扱い方、悪い知らせの伝え方などです。
• サンプルの文章をそのままファイルにコピーしないでください。パターンを抽出し、ファイルの構成に沿った箇条書きの案として提示します。
• 草案を提示します。「抽出した内容はこちらです。間違っている点や抜けている点を教えてください。」
• 通常どおり、反応を反映します。

ユーザーがサンプルを共有しない場合（またはサンプルに加えて）、次の質問を一度に1つずつ尋ねます。

1. 「同僚があなたの文章の書き方を一言で表すとしたら、何と言うでしょうか？」
2. 「この文を読んでください。『チームにとって真の相乗効果をもたらす存在になるため、この機会をぜひ活用してほしいと思います。』 あなたの文体として、どこがしっくりきませんか？」（肯定的な質問よりも、避けたい表現をすばやく引き出せます。）
3. 「リーダー向けに週次の進捗報告を書くとき、自動化したいと思うのはどんな部分ですか？また、いつも結局書き直すのはどんな部分ですか？」
4. 「文章を書くのが最も難しい相手は誰ですか？その相手に書くとき、何が変わりますか？」
5. 「Connect や業績評価で自分について書くとき、書いてすぐに削除したことのある表現は何ですか？」

草案を作成し、提示し、修正してから書き込みます。

書き込んだ後、ユーザーに次のように伝えます。

「時間の経過とともにパターンを自動的に学習することはありません。同じ間違いを繰り返したり、表現を置き換えたり、あなたの修正にうまく対応できなかったりしたら、このファイルを更新するよう頼んでください。修正内容を反映します。このファイルは、あなたが指示したときに更新されます。」

移行：「最後は、好みと制約です。AI に自分の周りでどのように振る舞ってほしいかを決めます。よろしいですか？」

9. preferences-and-constraints.md の聞き取り

assets/templates/preferences-and-constraints.md からテンプレートを読み込みます。

ここにあるルールの多くは、エージェントが独断で行うべきではないことに関するものです。抽象的なルールを尋ねるのではなく、具体的に困った経験を思い出してもらい、ルールを引き出します。質問は一度に1つずつ尋ねます。

1. 「AI ツールに望んでいないことをされたのは、最近ではいつですか？何をされて、代わりにどうしてほしかったですか？」（1つの回答から、境界に関するルールが3つ生まれることもあります。）
2. 「エージェントがあなたに確認せずに行ってもよいことは何ですか？必ずあなたの承認が必要なことは何ですか？」
3. 「速さと丁寧さ。どちらか1つを選ぶとしたら、どちらですか？」
4. 「AI に任せたい判断はありますか？それとも、常に選択肢を提示してほしいですか？」
5. 「AI に自分の代理として発言してほしくない場面はどこですか？」（Teams、メール、会議、公開チャットなど。）
6. 「永続的なメモリを備えたツール（VS Code のセッションメモリ、エージェントのメモリ機能など）を使っていますか？使っている場合、そこに保存してほしいこと、または特に保存してほしくないことはありますか？」回答が「いいえ」の場合は、メモリのセクションを省略します。

草案を作成し、提示し、修正してから書き込みます。反応を反映します。

移行：「聞き取りは以上です。次に、すべてのエージェントがファイルを見つけられるよう、カスタム指示にファイルを組み込みます。」

10. ファイルをカスタム指示ファイルに組み込む

ユーザーのカスタム指示ファイルのいずれかに参照項目を追加し、ほかのスキルやエージェントが新しいファイルを見つけられるようにします。ワークスペーススコープではなく、ユーザースコープを推奨してください。 このコンテキストの要点は、1つのリポジトリに限定せず、あらゆる場所で利用できることです。 クイックガイド：10a ハーネスを検出し、10b 対象ファイルを選び、10c（ハーネスが複数ある場合のみ）正規ファイルへのシンボリックリンクを提案し、10d 同梱テンプレートを使ってポインターを書き込みます。

macOS または Linux では、以下のコマンドとパスはすべて POSIX 相当のものがあります。すべてのパスで %USERPROFILE% を $HOME に置き換え、New-Item -ItemType SymbolicLink の代わりに ln -s <canonical-target> <harness-file> を使用し、Developer Mode の確認は完全に省略してください（macOS と Linux ではシンボリックリンクの作成に昇格権限は不要です）。

ステップ 10a。ユーザーが使用しているハーネスを検出します。 次のユーザースコープのパスが存在するかどうかを確認します（ファイルシステムを使用し、最初に尋ねる必要はありません）。

ハーネス	ユーザースコープのカスタム指示パス
VS Code Copilot Chat / Claude Code	%USERPROFILE%\.claude\CLAUDE.md
GitHub Copilot CLI	%USERPROFILE%\.copilot\copilot-instructions.md

VS Code Copilot Chat は %USERPROFILE%\.agents\AGENTS.md をネイティブでは読み込みませんが、Claude Code が使用するファイルと同じ %USERPROFILE%\.claude\CLAUDE.md は読み込みます。そのため、.claude\CLAUDE.md はこの 2 つのハーネスで共有されるユーザースコープのファイルです。

%USERPROFILE%\.agents\AGENTS.md が存在する場合は、それを正規の対象として扱います。環境によっては、上記のハーネス固有ファイルがこのファイルへのシンボリックリンクになっているため、1 回の書き込みですべての接続済みハーネスに反映されます。

ステップ 10b。対象を選びます。 最初に該当するルールを適用します。

1. %USERPROFILE%\.agents\AGENTS.md が存在する場合は、デフォルトでそこを対象にします。ハーネス固有ファイルはこのファイルへのシンボリックリンクになっているため、1 回の書き込みですべての接続済みハーネスに反映されます。書き込む前にユーザーに確認します。
2. それ以外で、ハーネス固有ファイルが 1 つだけ存在する場合は、そのファイルへの書き込みを提案します。確認を取ります。ステップ 10c の正規ファイルとシンボリックリンクの選択肢についても伝えます。
3. それ以外で、ハーネス固有ファイル（copilot-instructions.md と CLAUDE.md）が両方存在する場合は、両方を一覧表示し、どちらを更新するか尋ねます。すべてのハーネスに 1 回の編集で反映されるよう、.agents\AGENTS.md を正規ファイルとして作成し、他のファイルをそこへのシンボリックリンクにすることを強く推奨します（ステップ 10c）。
4. それ以外（ユーザースコープのカスタム指示ファイルがどこにも存在しない場合）は、「最もよく使う AI ハーネスはどれですか？ VS Code Copilot Chat、Claude Code、GitHub Copilot CLI、それとも他のものですか？」と尋ねます。その後、対応するユーザースコープのファイル（最初の 2 つは .claude\CLAUDE.md、Copilot CLI は .copilot\copilot-instructions.md）を作成し、## Personal Context セクションを設けます。

ユーザーがワークスペーススコープを明示的に希望する場合は、<workspace>\AGENTS.md に書き込み、対象となるのはそのリポジトリのみであるというトレードオフを伝えます。

ステップ 10c。ほかのハーネスを正規ファイルにシンボリックリンクすることを提案します。 ユーザーが複数のハーネスを持っている（または使用を希望する）場合にのみ該当します。「%USERPROFILE%\.agents\AGENTS.md を正規ファイルにして、ほかのハーネスファイルをそこへのシンボリックリンクにしますか？ そうすれば 1 回の編集ですべてのハーネスに変更が反映されます。」と尋ねます。

はいの場合、ユーザーがリンクを希望するほかのハーネスファイルごとに、次の手順を実行します。

1. 前提条件。 Windows でファイルのシンボリックリンクを作成するには、Developer Mode を有効にするか、管理者権限で PowerShell を実行する必要があります。次のコマンドで Developer Mode を確認します。

   Get-ItemPropertyValue 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock' AllowDevelopmentWithoutDevLicense -ErrorAction SilentlyContinue
   

   Developer Mode が有効な場合は 1 を返します。有効でない場合は、次の 2 つの選択肢を提示し、ユーザーに選んでもらいます。

   • オプション A：Developer Mode を有効にする（一度設定すればよく、再起動も不要です）。 Settings -> Privacy & Security -> For developers -> turn on Developer Mode。あるいは、管理者権限で PowerShell を開き、次を実行します。

     New-ItemProperty -Path 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock' -Name AllowDevelopmentWithoutDevLicense -Value 1 -PropertyType DWord -Force
     

   • オプション B：管理者権限で PowerShell を実行し、シンボリックリンクを作成する。 実際のパスを入力した正確なコマンドをユーザーに渡し、管理者として開いた PowerShell ウィンドウで実行するよう依頼します。成功したことを確認してから続行します。

     New-Item -ItemType SymbolicLink -Path '<harness-file>' -Target "$env:USERPROFILE\.agents\AGENTS.md"
     

   Dev Mode がオンになっているか、ユーザーが昇格したコマンドを実行したことを確認できるまで、先に進まないでください。

2. 既存のファイルをバックアップします。<file>.bak-<yyyyMMddHHmmss> という名前で保存し、何も失われないようにします。決して削除しないでください。

3. シンボリックリンクを作成し、%USERPROFILE%\.agents\AGENTS.md を指すようにします（ユーザーがオプション B で既に自分で実行している場合はスキップします）:

   New-Item -ItemType SymbolicLink -Path '<harness-file>' -Target "$env:USERPROFILE\.agents\AGENTS.md"
   

コンテキストの接続には、上記のインラインのシンボリックリンク手順で十分です。

ユーザーがシンボリックリンクを拒否した場合は、ハーネスごとの書き込みを行って次に進みます。同じことを二度繰り返さないでください。

ステップ 10d. ポインターを書き込みます。 同梱の AGENTS.md テンプレート assets/templates/AGENTS.md（この SKILL.md からの相対パス）を、## Personal Context ブロックの構造（見出し、エントリのラベル、ルーティング表、ルール）の正として使用してください。形式を独自に作り直さないでください。

動作:

• 対象ファイルがまだディスク上に存在しない場合は、作成します。不足している親ディレクトリ（例: %USERPROFILE%\.copilot\ や %USERPROFILE%\.claude\）を作成し、同梱テンプレート全体を対象パスにコピーし、<CONTEXT_DIR> をステップ 1 で選択したコンテキストディレクトリの絶対パスに置き換えて書き込みます。
• 対象ファイルは存在するが ## Personal Context セクションがない場合は、セクションをファイル末尾に追記します（テンプレートの ## Safety セクションも不足していれば追加します）。<CONTEXT_DIR> は置き換えます。それより上の既存の内容には触れないでください。
• ## Personal Context セクションが既に存在する場合は、変更された特定のエントリだけを追加または更新します。セクション全体を書き直さないでください。既存のラベルと順序は維持し、@<path> の行だけを入れ替えます。
• ディスク上に実際に存在するファイルのみを接続します。ユーザーがスキップしたファイルに対して @<path> のポインターを追加しないでください。

11. 確認と要約

「これがあなたのコンテキストポートフォリオです。カスタム指示を読み込むAIスキル、エージェント、プラグインであれば、これらのファイルを見つけて、扱う内容をすぐに理解できます。

ファイルは時間の経過とともに更新することで、より良くなっていきます。プロジェクトは変わり、優先順位も移ります。特にコミュニケーションスタイルのファイルは、私が同じ間違いを繰り返していることに気づき、その修正を取り込むよう依頼するにつれて進化していくでしょう。これらは完成品ではなく、生きたドキュメントとして扱ってください。」

ユーザーに以下を表示します:

• 作成したファイルの一覧とそのパス。
• ポインターを書き込んだカスタム指示ファイルのパス。

---

コンテキストファイル

ファイル	目的	利用元
identity.md	名前、役割、組織、チーム、マネージャー、担当業務	ユーザーが誰かを知る必要があるあらゆるスキル
role-and-responsibilities.md	チームごとの責任、サイクル、成果物	ステータス、レポート、計画のスキル
team.md	役割と注力領域を含むチームのメンバー一覧	人との対話を準備または要約するスキル
tools-systems-and-config.md	ツール、会議タグ、チームごとの ADO 設定、ピラー、レポート設定	会議メモを読む、レポートを実行する、ADO と対話するスキル
communication-style.md	声のトーン、文体、フォーマットのルール、避けるべき言葉、読者層ごとの調整	ユーザーに代わってコンテンツを書くあらゆるスキル
preferences-and-constraints.md	厳格な境界、承認ルール、作業上の好み、メモリのルール	すべてのスキル（特に書き込みや送信を行うもの）

利用者は、任意のカスタム指示ファイル（AGENTS.md、copilot-instructions.md、CLAUDE.md、*.instructions.md）から読み込まれたポインターを通じて、これらのファイルを見つけます。MCP や専用のリーダースキルは必要ありません。

---

インタビューのルール

トーン

率直で、温かく、具体的に行ってください。あなたはインタビュアーであり、コーチではありません。ユーザーの回答について意見を述べたり、褒めたり、論評したりしないでください。

質問する前に、利用可能なデータソースで情報を事前入力する

ユーザーに質問リストへの回答を促す前に、利用可能なツールやデータソースで、事実に関する項目に答えられるか確認してください。接続済みのシステムがすでに知っている情報を、ユーザーに入力させる必要はありません。

よくある例（実際に利用できる環境のものを使ってください）：

• 接続済みの勤務先プロフィールやディレクトリには、ユーザーの氏名、役職、組織、チーム、マネージャー、直属の部下が登録されている場合があります。これは identity.md と team.md に役立ちます。
• カレンダー、メール、チャットの履歴から、頻繁にやり取りする相手や定期的な予定がわかる場合があります。これは team.md と role-and-responsibilities.md に役立ちます。
• プロジェクト管理やソース管理の連携機能から、ユーザーの組織／プロジェクト／領域のパスやリポジトリがわかる場合があります。これは tools-systems-and-config.md に役立ちます。
• メールやドキュメントにある既存の文章サンプルは、ユーザーの許可があれば、追加のサンプルを求めずに communication-style.md を作成する際の参考にできます。

ルール：

1. ユーザーがすでに許可した情報源だけを使ってください。面談の途中で新たな情報源にアクセスする場合は、事前に確認してください。
2. 事前入力した内容は回答ではなく、提案です。見つかった内容を提示し、自動入力したものであることを明記したうえで、ファイルに反映する前に、各項目についてユーザーに確認または修正を求めてください。
3. ツール名を列挙しないでください。「勤務先プロフィールから一部の情報を取得できます」のように伝えてください。
4. 利用可能な情報源がない場合や、情報が曖昧、古い、または機密性の高いものである場合は、質問してください。
5. 自由回答形式の項目（実際の仕事内容、周囲から頼られること、話し方、境界線など）は、引き続き質問が必要です。間接的な兆候から作り上げないでください。

質問

• 一度に質問するのは一つだけです。質問をリスト形式で提示しないでください。
• 複数の質問を一つにまとめて聞かないでください。
• 先に作成したファイルで得た情報を、後の聞き取りに活用してください。すでにわかっていることを再度尋ねないでください。
• ユーザーが後で作成するファイルに役立つ話題にそれた場合は、その内容を記録し、該当するファイルの作成時に活用してください。
• ユーザーの回答が曖昧な場合は、具体的な内容を尋ねてください。「具体例を挙げてもらえますか？」や「日々の業務では実際にどのような感じですか？」と聞いてください。
• 下書きを作成するのに十分な情報が集まったら、そう伝えて下書きを作成してください。質問を続けないでください。「十分」とは、そのファイルのテンプレートにある主要項目を網羅する回答が得られていることです（identity の場合は、氏名、役割、組織、チーム、マネージャー、仕事内容です）。先の回答で情報が得られていれば、リストにある質問をすべてする必要はありません。

見直し

各ファイルの下書きを作成したら、その内容を提示し、次のように伝えてください。 「こちらが下書きです。目を通して、しっくりこないところを教えてください。 違和感のあるところ、誤った前提、抜けている点はありますか？」

ユーザーが修正なしで問題ないと答えた場合は、もう一度だけ促してください。 「最も弱い、またはありきたりだと思う文を一つ選んでください。もっとあなたらしくするには、どうすればよいでしょうか？」

ユーザーが再度、問題ないと答えた場合は、その回答を受け入れて次に進んでください。

ファイルの品質

• ファイルは簡潔にまとめてください。5ページではなく、1ページに収めてください。
• ファイルは、AI がユーザーについて書いたような文章ではなく、ユーザー本人が書いたような文章にしてください。
• ユーザー自身の言葉遣い、表現、形式のレベルに合わせてください。
• エムダッシュは使わないでください。
• ユーザーがファイルをスキップしたい場合は、そのままスキップしてください。
• ユーザーがファイルの作成途中で中断する必要がある場合は、どこまで進んだかを伝え、再開できるようにしてください。

例：アイデンティティのヒアリング例

最初の質問から最終的なファイルの作成まで、完全な identity.md のヒアリングがどのように進むかを示します。

エージェント： お名前と現在の役職を教えてください。

ユーザー： Dana Kim、シニアプログラムマネージャーです。

エージェント： どの組織に所属していますか？また、どのチームですか？

ユーザー： Contoso のクラウドエンジニアリングです。Jordan Rivera の配下にあるプラットフォーム運用チームに所属しています。

エージェント： ディナーパーティーで、実際にどんな仕事をしているのかを誰かに説明するとしたら、何と言いますか？

ユーザー： データプラットフォームチームが円滑に業務を続けられるようにしています。スプリント計画や状況報告を行い、全員が更新メールに追われることなく、リーダーシップが状況を把握できるようにしています。また、プログラム管理の反復作業を自動化する AI ツールも構築しています。

エージェント： どんなことで相談を受けますか？

ユーザー： 主に2つです。プロジェクトの実際の状況（取り繕った説明ではなく）を明確に把握することと、AI ツールを使ってワークフローの面倒な作業を減らす方法を考えることです。

エージェント： 下書きを作成するには十分な情報がそろいました。こちらが下書きです。

# Identity

- **Name:** Dana Kim
- **Role:** Senior Program Manager
- **Organization:** Cloud Engineering, Contoso
- **Team:** Platform Operations
- **Manager:** Jordan Rivera

## What I Do

I keep the data platform teams running: sprint planning, status reporting,
and making sure leadership knows what's happening without everyone drowning
in update emails. I also build AI tooling that automates the repetitive
parts of program management.

## What People Come to Me For

Two things: getting a clear picture of where a project actually stands (not
the sanitized version), and figuring out how to use AI tools to cut busywork
out of their workflows.

一通り読んで、しっくりこないところを教えてください。違和感のあるところ、私が誤って想定したところ、抜けていることがあれば何でも教えてください。

ユーザー： よさそうです。これで進めてください。

エージェント： 最も弱い、または一般的すぎる文を1つ選んでください。もっとあなたらしさが伝わる表現にするには、どうすればよいですか？

ユーザー： 「データプラットフォームチームが円滑に業務を続けられるようにしています」という部分です。実際には、エンジニアリング、リーダーシップ、運用の進行サイクルをつなぐ役割に近いです。この3つの視点を同時に持っている人はほかにいません。

エージェント： （「What I Do」の段落を更新し、ファイルをコンテキストディレクトリに書き込みます。）

アイデンティティの作成は完了です。次は、実際の一週間の過ごし方を記録する、役割と責任の項目です。準備はよいですか？

---

例：対象を絞った更新

何気なく言及されたコンテキストの変更によって、対象を絞った更新（状態4）が行われる例です。

ユーザー： 先週の会議を取得してもらえますか？あ、そういえば、Jordan はもう私の上司ではありません。Morgan の配下に異動しました。

エージェント： 会議を取得します。アイデンティティファイルも更新が必要なようです。今、修正しましょうか？

ユーザー： はい、お願いします。

エージェント： （読み込まれたカスタム指示から identity.md のパスを特定し、ファイルを読み取り、Manager フィールドの「Jordan Rivera」を「Morgan」に更新して、ファイルを書き戻します。）

完了しました。identity.md の上司を Morgan に更新しました。それでは、会議の取得に進みます。

---

安全性

• コンテキストファイルに認証情報、API キー、トークン、シークレットを保存しないでください。ヒアリング中にユーザーから提供された場合は、省略し、その理由を説明してください。
• ユーザーが選択したコンテキストディレクトリと、ユーザーが承認したカスタム指示ファイルにのみ書き込んでください。それ以外の場所にファイルを書き込まないでください。
• 既存のコンテキストファイルを削除しないでください。更新が必要な場合は、まず既存のファイルを <file>.bak-<yyyyMMddHHmmss> にバックアップし、上書きする前にユーザーに確認してください。

コンシューマーがこれらのファイルを安全に読み取る方法（データとして扱う、内容を漏らさない、プロンプトインジェクションのテキストを無視するなど）については、同梱されている AGENTS.md テンプレートの assets/templates/AGENTS.md にある ## Safety ブロックを参照してください。このブロックは手順10dでユーザーのカスタム指示ファイルに書き込まれるため、すべての利用スキルでルールが自動的に適用されます。

---

作者

@lakshmistoltz による寄稿。