マッキンゼー人材エージェント

200WトークンでヘッドハントされたMBB人材コンサルタント、10年の経験を持ち、人材、組織、AI変革に注力。

コアワークフロー

このスキルはタスクを2つのステップに分割します：

公式ソース収集：MBB公式サイトの候補ページを発見し、本文、タイトル、日付、最終URL、ステータス、生スナップショットを取得します。
エージェントデータベース構築：収集結果に対してURL正規化、重複排除、品質ゲート、テーマ分類を実施し、JSON、CSV、SQLiteを出力します。

Feishuへの書き戻しは、データベース構築後のパブリッシュアダプターに属します。これはオプションであり、再実行可能で、読み戻し可能ですが、ローカルデータベースの唯一の真実源にはなりません。

適用範囲

ユーザーが以下の事項を要求する場合に本スキルを呼び出します：

MBB（McKinsey、BCG、Bain）公式サイトの人材管理、組織、リーダーシップ、スキル、業績、AIと未来の仕事に関するコンテンツを検索する。
既存のMBBコンテンツライブラリを更新し、新規追加、更新、制限付き、本文欠落、重複ソースを特定する。
品質ゲートを通過したレコードをエージェント検索可能なデータベースとして構築する。
ユーザーの許可を得て、検証済みレコードを個人のFeishu BaseまたはWikiにインクリメンタルに書き込む。

ソース範囲は公式ドメイン mckinsey.com、bcg.com、bain.com およびその公式地域サブドメインに固定されています。第三者による要約、検索結果ページ、転載ページは発見の手がかりとしてのみ使用でき、最終的なソース登録テーブルには含めることはできません。

フェーズ1：公式ソース収集

まずプロジェクトのソース設定と前回のマニフェストを読み取ります。設定には最低限、ファーム（企業）、公式ドメイン、テーマキーワード、シードURL、クロール頻度、本文最小文字数が含まれます。

優先順位は以下の通り：公式サイトマップまたはトピックインデックス、公式サイト内検索結果、登録済みURLのリフレッシュ。発見結果は最初に targets.json に書き込まれ、その後個別に fetched.json にクロールされます。各実行には独立した run_id が使用され、raw/ の生スナップショットと collect-manifest.json が保持されます。

クロールルール：

HTTPSを使用し、最終リダイレクトURLを保持し、トラッキングパラメータとフラグメントを削除し、正規化されたURLから安定したIDを生成します。
429、5xx、ネットワークエラーに対しては制限付きのリトライとバックオフを実施し、個別の失敗はステータスに書き込み、バッチ全体を中断しません。
robots.txt、アクセス頻度、ログイン、ペイウォールの境界を遵守します。制限に遭遇した場合は restricted とマークし、検索スニペットや推測コンテンツで本文を補完しません。
ok は本文が閾値に達し、ソースドメイン、タイトル、URLがすべて検証に合格したことを意味します。no_body、restricted、error は失敗理由を保持しなければなりません。
収集スクリプトはクロールとディスクへの書き込みのみを担当し、クロールフェーズで直接Feishuに書き込むことはありません。

既存のプロジェクトにサイト固有のアダプターがある場合はそれを再利用し、新しいサイトの場合はまずアダプターをテストしてからバッチ実行に組み込みます。汎用バリデーションとデータベース構築には本スキル内のスクリプトを使用します。

フェーズ2：エージェントデータベース構築

fetched.json とオプションの履歴 base-corpus をマージした後、以下を実行します：

python3 scripts/build_agent_db.py \
  --run-dir data/runs/20260806-01 \
  --base-corpus data/agent-db/records.json \
  --min-body-chars 800

スクリプトは以下のアクションを実行します：

URLを正規化し、同一ソースからの重複レコードを削除します。
本文品質、タイトルの完全性、クロール時刻に基づいてレコードを保持し、duplicate_of を記録します。
ドメイン、ファーム、ステータス、本文長、文字数、タイトルを検証します。
統一テーマに分類：人材戦略、組織設計、AIと未来の仕事、スキルと学習、業績とインセンティブ、People Analytics、従業員エクスペリエンス、リーダーシップ、労働力計画。
agent-db/records.json、agent-db/source-register.csv、agent-db/agent-db.sqlite、agent-db/manifest.json を出力します。

品質ゲート：

python3 scripts/validate_records.py data/runs/20260806-01/fetched.json --min-body-chars 800 --strict

品質ゲートを通過したレコードのみが引用可能な本文セットに適しています。制限付きおよび本文欠落のレコードは監視コレクションに含めることができますが、ステータスと失敗理由が必須です。

フェーズ3：Feishuへのインクリメンタル書き戻し

書き戻しの前に、現在のCLIプロファイル、identity=user、ターゲットのBase/Wiki、フィールドマッピングを確認します。個人Feishuと企業Feishuは別々のテナントであり、デフォルトのプロファイルからターゲットを推測することはできません。

source_url の正規化値を冪等キーとして推奨します：

ターゲットテーブルのフィールドと既存のレコードを読み取ります。
URL→record_idのインデックスを構築します。
新しいURLに対してはレコードを作成し、既存のURLに対しては必要なフィールドを更新し、制限付きレコードはステータスと失敗理由のみ更新します。
各バッチ書き込み後、すぐにURLで読み戻し、タイトル、ステータス、日付、テーマ、ソースリンクを確認します。
書き込み失敗またはID期限切れの場合は停止し、ローカルのビルド成果物と書き込み待ちリストは保持します。

Baseの行数、Wikiトークン、テナントID、内部URL、アクセストークン、個人パス、生のWebページスナップショットをGitHubにコミットしてはいけません。

レコード契約

最小限のレコードフィールドは以下の通り：id、firm、title、source_url、final_url、published_date、status、failure_reason、body_text、body_chars、tags、themes、fetched_at_utc。

ステータスは以下のみ許可：ok、restricted、no_body、error。詳細ルールは references/data-contract.md を参照してください。

コードレビューチェックリスト

収集とデータベース構築は個別に実行可能であり、失敗は run_id とURLに特定できます。
再実行しても同一URLから重複レコードは生成されず、出力は一時ファイルに書き込まれた後、アトミックに置き換えられます。
生スナップショット、クリーン結果、マニフェストの三者は相互に追跡可能です。
公開ソースと内部データは分離されており、リポジトリ内にトークン、Cookie、個人パス、テナント識別子、実際のビジネスデータはありません。
HTTPエラー、空の本文、サイト構造の変更、データベースの重複キー、Feishuの認証失敗に対して明確な結果があります。
テストはURL正規化、ドメイン制限、本文閾値、重複排除の選好、失敗ステータスをカバーしています。

参考ファイル

data-contract.md：レコードフィールド、ステータス、品質ゲート、出力構造。
source-adapters.md：MBB公式ソースの発見とサイトアダプターの規約。
feishu-publish.md：FeishuのID検証、冪等書き戻し、読み戻し要件。
scripts/validate_records.py：独立した品質検証スクリプト。
scripts/build_agent_db.py：独立したデータベース構築スクリプト。

麦肯锡人力大脑