著者プロファイルの強化
このスキルは、Web検索を通じて不足している著者プロファイルフィールド(経歴、アバター、ウェブサイト、ソーシャル)を補完します。
ワークフロー概要
フェーズ1: 著者の特定
└─ 著者ファイルを検索して検証
フェーズ2: 並列検索(不足フィールドのみ)
├─ WebSearchエージェント1: 経歴/バックグラウンド
├─ WebSearchエージェント2: アバターURL
└─ WebSearchエージェント3: ウェブサイト + ソーシャル
フェーズ3: ユーザーレビュー(ブロッキングゲート)
└─ 結果を提示し、承認を待つ
フェーズ4: 強化された著者の保存
└─ フロントマターフィールドの更新
フェーズ5: 品質チェック
└─ pnpm lint:fix && pnpm typecheck を実行
フェーズ1: 著者の特定
1.1 著者ファイルを探す
引数として著者のスラッグ、名前、または部分的な名前を受け付けます:
- まず正確なスラッグで一致を試みる:
content/authors/{slug}.mdが存在するか確認(スペースはハイフンに変換、小文字化) - 正確な一致がない場合: Grepを使用して著者ファイル内の名前を検索:
Grepパターン: "name:.*{検索語}" グロブ: "content/authors/*.md"
結果:
- 単一一致 → そのファイルで続行
- 複数一致 → ユーザーが選択できるようにリスト表示
- 一致なし → 利用可能な著者を一覧表示
1.2 不足フィールドを特定
著者ファイルを読み込み、どのフィールドが欠けているか、または空であるかを確認します:
必須フィールド(常に存在):
nameslug
強化対象のオプションフィールド:
bio- 専門的な経歴と専門知識avatar- プロフィール画像のURLwebsite- 個人ウェブサイトのURLsocials.twitter- Twitter/Xハンドルsocials.github- GitHubユーザー名socials.linkedin- LinkedInユーザー名socials.youtube- YouTubeチャンネル
フィールドが「不足」している条件:
- フロントマターに存在しない
- 存在するが空(
""またはnull)
すべてのフィールドがすでに埋まっている場合は、ユーザーにその旨を伝え、特定のフィールドの更新を提案します。
フェーズ2: 並列検索
不足しているフィールドに基づいて、最大3つのWebSearchエージェントを並列で起動します:
**エージェント1 - 経歴/バックグラウンド:**
Taskツール(subagent_type: "general-purpose")
プロンプト: "Use WebSearch to find professional background info for [著者名].
Query: '[著者名]' bio background expertise
Extract: Job title, company, areas of expertise, notable projects.
Return: A 1-2 sentence professional bio."
**エージェント2 - アバターURL:**
Taskツール(subagent_type: "general-purpose")
プロンプト: "Use WebSearch to find a profile picture URL for [著者名].
Query: '[著者名]' site:github.com OR site:twitter.com
Extract: GitHub username or Twitter handle to construct avatar URL.
Return: Avatar URL (prefer GitHub format: https://github.com/{username}.png)"
**エージェント3 - ウェブサイトとソーシャル:**
Taskツール(subagent_type: "general-purpose")
プロンプト: "Use WebSearch to find social media profiles for [著者名].
Query: '[著者名]' twitter github linkedin youtube
Extract: Personal website, Twitter handle, GitHub username, LinkedIn profile, YouTube channel.
Return: List of found profiles with URLs/handles."
不足フィールドにのみエージェントを起動します。経歴がすでに存在する場合はエージェント1をスキップします。
TaskOutput(ブロッキング)を使用してすべての結果を収集します。
フェーズ3: ユーザーレビュー(ブロッキングゲート)
これは必須の承認ステップです。 保存する前に提案された変更を提示します。
3.1 変更内容を提示
提案された更新を比較表として表示します:
## [著者名] の提案された更新
| フィールド | 現在 | 提案 |
|-------|---------|----------|
| bio | (空) | "X社の創業者、Yのクリエイター..." |
| avatar | (空) | "https://github.com/username.png" |
| website | (空) | "https://example.com" |
| socials.twitter | (空) | "username" |
| socials.github | (空) | "username" |
| socials.linkedin | (空) | "username" |
| socials.youtube | (空) | (見つかりません) |
3.2 承認を依頼
AskUserQuestionツールを使用します:
question: "これらの変更を著者プロファイルに保存しますか?"
header: "レビュー"
multiSelect: false
options:
- label: "保存"
description: "これらの値で著者ファイルを更新する"
- label: "編集"
description: "変更する内容を教えてください"
- label: "キャンセル"
description: "ファイルを変更しない"
3.3 応答を処理
- 保存: フェーズ4に進む
- 編集: ユーザーのフィードバックを適用し、更新されたプレビューを表示
- キャンセル: 変更せずに終了
ユーザーの明示的な承認なしにフェーズ4に進まないでください。
フェーズ4: 強化された著者の保存
4.1 フロントマターを更新
Editツールを使用して、承認されたフィールドのみを更新します:
更新前:
---
name: "John Doe"
slug: "john-doe"
bio: ""
avatar: ""
website: ""
socials:
twitter: ""
github: ""
linkedin: ""
youtube: ""
---
更新後:
---
name: "John Doe"
slug: "john-doe"
bio: "分散システムを専門とするソフトウェアエンジニア..."
avatar: "https://github.com/johndoe.png"
website: "https://johndoe.dev"
socials:
twitter: "johndoe"
github: "johndoe"
linkedin: "johndoe"
youtube: ""
---
4.2 既存の値を保持
重要: 明示的に要求された場合を除き、既存の空でない値を上書きしないでください:
- 既存の
nameとslugは変更しない - 空または欠落していたフィールドのみを更新する
- 追加のカスタムフィールドは保持する
4.3 確認
ユーザーに報告します:
更新: content/authors/{slug}.md
- bio: 追加
- avatar: 追加
- website: 追加
- socials.twitter: 追加
- socials.github: 追加
フェーズ5: 品質チェック
リンターと型チェックを実行して問題を検出します:
pnpm lint:fix && pnpm typecheck
エラーが見つかった場合は、タスクを完了する前に修正します。
エラー回復
| エラー | 回復方法 |
|---|---|
| 著者が見つからない | content/authors/ 内の利用可能な著者を一覧表示 |
| 不足フィールドがない | ユーザーに通知し、特定のフィールドの更新を提案 |
| WebSearchが失敗 | 代替のクエリパターンを試す |
| ユーザーが変更を拒否 | 編集またはキャンセルを許可 |
| 情報が見つからない | フィールドを "(見つかりません)" とマークし、他のフィールドで続行 |
品質チェックリスト
保存する前に確認:
- 著者ファイルが
content/authors/に存在する - 空または欠落したフィールドのみを更新している
- 経歴は1〜2文で、プロフェッショナルな口調
- アバターURLが有効(GitHub形式を優先)
- ソーシャルハンドルはユーザー名のみ(URLではない)
- 既存の空でない値が保持されている
- ユーザーが変更を明示的に承認した