---

name: person-writer description: "AI Solo Craft の人物ページを作成・更新するスキル。DB直接投入 + X source自動登録。「人物作成」「people追加」「person登録」などの作業に使う。"

Person Writer Skill

AI Solo Craft の人物ページを作成・更新するスキル。

📋 事前確認（必須）

• LEARNINGS.md を読む
• 既存people一覧を確認: ./scripts/list-people.sh を実行

🚨 最重要ルール

すべてのコンテンツはDBに直接投入する。mdファイルは作成しない。

cd /Users/satokeita/Dev/ai-solo-craft
node scripts/create-person-db.mjs --stdin < /tmp/person.json

使用タイミング

• 新規人物ページの作成
• 既存人物ページの更新
• 「人物追加」「people作成」「person登録」「プロフィール作成」などの作業

🔧 実行フロー

Phase 1: リサーチ

1. 一次情報源を確認（必須）:
   • 本人のX/Webサイト/LinkedIn
   • Wikipedia（存在すれば）
   • 会社公式プロフィール
2. 以下を収集:
   • 正式名称（英語 + 日本語）
   • 現在の肩書き（英語 + 日本語）
   • 会社名
   • SNSアカウント（X handle が最重要）
   • 主な経歴・実績（3-5項目）
   • AI/ソロ開発との関連性

Phase 2: JSON作成 + DB投入

1. references/example-person.json をテンプレートとしてJSONを作成
2. bio_markdown は references/template-bio.md のテンプレートに従う
3. フィールドの詳細は references/field-reference.md を参照
4. /tmp/person-{slug}.json に保存して投入:

cd /Users/satokeita/Dev/ai-solo-craft
node scripts/create-person-db.mjs --stdin < /tmp/person-{slug}.json

自動的に行われること（X handleがある場合）:

• sources テーブルにX source upsert
• source_crawl_configs にRSSHub経由クロール設定（120分間隔）
• people_sources で人物→sourceのリンク作成
• 次回cron実行時からX投稿が自動収集され、人物ページの「最近のX発信」に表示

Phase 3: 確認

./scripts/verify-person.sh <slug> を実行してDB投入とsource登録を確認。

bio_markdownのルール

• 事実ベース、検証可能な情報のみ
• 定量データがあれば必ず含める（ユーザー数、GitHub Stars、売上等）
• 「ソロ開発者への示唆」セクションは必須（サイトの読者層に合わせる）
• 肩書きは一次ソースで確認してから記載（特にCXO/CDOの兼任、退任に注意）

品質基準

必須（Tier 1）

• 名前（英語 + 日本語）
• 肩書き（一次ソースで確認済み）
• bio_markdown に概要 + 経歴 + ソロ開発者への示唆
• X handle（sns_accounts に含む）
• person_type が正確

中品質（Tier 2）

• アバター画像
• 3つ以上のSNSアカウント
• 関連プロダクトの紐付け
• 定量データ（ユーザー数、Stars等）

高品質（Tier 3）

• AI分野での具体的な貢献セクション
• 複数の一次ソースからのクロスチェック
• 最近の動向（直近6ヶ月の情報）

禁止事項

• mdファイルを作成する（content/ディレクトリへの書き込み禁止）
• 未確認の肩書き・経歴を記載する
• 肖像権に問題のある画像を使用する
• Tier 1未満の品質で公開する

⚠️ よくある落とし穴

• peopleテーブルのカラム名を推測で書いてエラー: テーブル構造が変わっていることがある。select('*') で先にカラム一覧を確認してからクエリを書く
• 肩書きの未確認・古い情報の引用: 肩書きは一次ソースで必ず確認する。Wikipedia、企業公式プロフィール、本人のX bio の3点照合が必須。CXO→CPO転身、退任など時系列変化に特に注意
• X handleの @ 付き記載: create-person-db.mjs のJSONでは @ 不要。"handle": "username" と書く
• avatar_urlのTwitter画像URLの経年変化: pbs.twimg.com/profile_images/ のURLは時間経過で無効になることがある。GitHubアバター（avatars.githubusercontent.com）を優先。取得不可なら null（イニシャル表示）
• AI生成の人物風画像の使用禁止: Pollinations AI等で実在の人物に似た画像を生成してはならない。肖像権・誤認リスク（3/19 けいた指摘）
• mdファイルの作成: コンテンツはすべてDBに直接投入する。content/ ディレクトリへのmdファイル作成は禁止
• PSPDFKit → Nutrient の名称変更: 2024年に改名済み。古い記事の表記をそのまま使わない

✅ 完了チェックリスト

• DB投入成功
• X source自動登録確認
• ビルド成功
• LEARNINGS.md に学びを追記

📁 参照ファイル

ファイル	内容
references/example-person.json	人物JSONテンプレート
references/template-bio.md	bio_markdown テンプレート
references/field-reference.md	person_type, SNS, avatar, X source, 関連プロダクト等の詳細
scripts/list-people.sh	既存people一覧を取得
scripts/verify-person.sh <slug>	DB投入・source登録の確認