learning-documentation-skill

学習記録スキル

学習活動、洞察、知識を Life OS Supabase データベースに体系的に記録します。

このスキルを使用するタイミング

• 学習活動（動画、記事、コース）の完了後
• 実験から得た洞察を記録するとき
• 今後利用する参考資料を保存するとき
• ナレッジベースを継続的に構築するとき
• 検索可能な学習アーカイブを作成するとき

Supabase の構造

テーブル： insights
場所： mocerqjnksmhcjzxrewo.supabase.co

必須フィールド：

• category：主分類
• subcategory：副分類
• title：簡潔で内容がわかるタイトル
• content：メインコンテンツ（構造化データには JSON を使用）
• metadata：追加のコンテキスト（任意）

カテゴリの分類体系

主カテゴリ

learning：

• サブカテゴリ：youtube_transcript、article、book、course、experiment
• 用途：一般的な知識の習得

michael_swim：

• サブカテゴリ：recruiting、meet_results、training、nutrition
• 用途：Michael の水泳関連の活動

mcp_reference：

• サブカテゴリ：architecture、claude_skills、integration_patterns
• 用途：MCP および Claude の技術文書

business：

• サブカテゴリ：biddeed_ai、everest_capital、strategy
• 用途：ビジネス上の洞察や意思決定

adhd：

• サブカテゴリ：task_patterns、interventions、productivity
• 用途：ADHD 管理に関する洞察

family：

• サブカテゴリ：shabbat、holidays、events
• 用途：家族の活動や行事

YouTube トランスクリプトの記録

タイミング： youtube_transcript.yml ワークフローの完了後

形式：

{
  "category": "learning",
  "subcategory": "youtube_transcript",
  "title": "Claude Skills Tutorial - 6 Essential Skills",
  "content": {
    "video_id": "thxXGxYIwUI",
    "video_url": "https://youtu.be/thxXGxYIwUI",
    "transcript_summary": "Tutorial on 6 Claude skills: frontend-design, domain-brainstormer, stripe-integration, content-writer, lead-research, skill-creator",
    "key_takeaways": [
      "Skills only load when needed (memory efficient)",
      "Progressive disclosure: ~100 tokens metadata, <5k when active",
      "Can build custom skills using skill-creator"
    ],
    "action_items": [
      "Deploy 6 base skills to both repos",
      "Build custom foreclosure-analysis-skill",
      "Create ADHD task management skill"
    ],
    "source": "apify"
  },
  "metadata": {
    "duration_minutes": 15,
    "watched_date": "2025-12-25",
    "relevance": "high"
  }
}

記事／ブログの記録

形式：

{
  "category": "learning",
  "subcategory": "article",
  "title": "MCP Architecture Deep Dive",
  "content": {
    "url": "https://example.com/mcp-architecture",
    "author": "Anthropic",
    "published_date": "2025-01-15",
    "key_concepts": [
      "Tool-based architecture",
      "Progressive disclosure",
      "Context injection patterns"
    ],
    "quotes": [
      "Skills are prompt templates that inject domain-specific instructions"
    ],
    "personal_notes": "This explains why skills are more efficient than rules"
  }
}

実験／テストの記録

形式：

{
  "category": "business",
  "subcategory": "biddeed_ai",
  "title": "Smart Router V5 Performance Test",
  "content": {
    "experiment_date": "2025-12-24",
    "hypothesis": "Gemini 2.5 Flash can handle 40-55% of requests",
    "methodology": "Run 100 auction analyses, track FREE vs PAID tier usage",
    "results": {
      "free_tier_percentage": 52,
      "paid_tier_percentage": 48,
      "cost_savings": "$28/month"
    },
    "conclusion": "Target achieved, deploying to production",
    "next_steps": [
      "Monitor for 1 week",
      "Adjust thresholds if needed"
    ]
  }
}

Michael の水泳に関する記録

大会結果：

{
  "category": "michael_swim",
  "subcategory": "meet_results",
  "title": "Harry Meisel Meet - December 2025",
  "content": {
    "meet_name": "Harry Meisel Invitational",
    "date": "2025-12-13",
    "location": "Orlando, FL",
    "results": [
      {
        "event": "50 Free",
        "time": "21.85",
        "place": 3,
        "improvement": "-0.15 from previous"
      },
      {
        "event": "100 Free", 
        "time": "47.92",
        "place": 5,
        "improvement": "-0.32 from previous"
      }
    ],
    "notes": "Strong performance, time drops across all events",
    "coach_notifications": ["UF", "FSU", "NC State"]
  }
}

リクルーティング活動：

{
  "category": "michael_swim",
  "subcategory": "recruiting",
  "title": "Coach Outreach - University of Florida",
  "content": {
    "university": "University of Florida",
    "coach_name": "Anthony Nesty",
    "contact_date": "2025-12-20",
    "type": "initial_email",
    "response_received": false,
    "follow_up_date": "2026-01-03"
  }
}

Markdown の書式規則

content フィールド用（Markdown を保存する場合）：

# Title

## Key Points
- Point 1
- Point 2

## Takeaways
1. First takeaway
2. Second takeaway

## Action Items
- [ ] Action 1
- [ ] Action 2

## References
- [Source 1](url)
- [Source 2](url)

簡潔にまとめる：

• セクションには見出し（##）を使用する
• リストには箇条書きを使用する
• アクション項目にはチェックボックスを使用する
• 参考資料の URL を含める
• 過度な書式設定はしない

挿入ワークフロー

GitHub Actions 経由（推奨）

BidDeed.AI リポジトリ：

workflow: .github/workflows/insert_insight.yml
inputs:
  category: "mcp_reference"
  subcategory: "claude_skills"
  title: "Phase 1 Skills Deployed"
  content: "{json_content}"

Life OS リポジトリ：

workflow: .github/workflows/insert_insight.yml
inputs:
  category: "learning"
  subcategory: "youtube_transcript"
  title: "Video Title"
  content: "{json_content}"

Supabase への直接挿入（必要な場合のみ）

GitHub Actions を利用できない場合に限ります：

import requests

response = requests.post(
    "https://mocerqjnksmhcjzxrewo.supabase.co/rest/v1/insights",
    headers={
        "apikey": "YOUR_ANON_KEY",
        "Content-Type": "application/json"
    },
    json={
        "category": "learning",
        "subcategory": "article",
        "title": "Example Title",
        "content": {"key": "value"}
    }
)

検索パターン

カテゴリで検索：

SELECT * FROM insights 
WHERE category = 'learning' 
ORDER BY created_at DESC 
LIMIT 10

キーワードで検索：

SELECT * FROM insights
WHERE title ILIKE '%claude skills%'
OR content::text ILIKE '%claude skills%'

最近のアクティビティ：

SELECT category, subcategory, title, created_at
FROM insights
WHERE created_at > NOW() - INTERVAL '7 days'
ORDER BY created_at DESC

ベストプラクティス

推奨事項：

• ✓ 一貫したカテゴリ／サブカテゴリを使用する
• ✓ 内容がわかるタイトルを付ける
• ✓ 可能な場合はコンテンツを JSON として構造化する
• ✓ 該当する場合はアクション項目を含める
• ✓ 後で検索しやすいようにタグを付ける

禁止事項：

• ✗ エントリを重複させない（挿入前に確認する）
• ✗ 曖昧なタイトル（「Notes」、「Misc」など）を使用しない
• ✗ 機密データ（API キー、パスワードなど）を保存しない
• ✗ 既存の価値あるエントリを上書きしない
• ✗ 空のコンテンツやプレースホルダーのコンテンツを挿入しない

使用例

"Use learning-documentation-skill to log the Claude skills video transcript"

"Document experiment results for Smart Router V5"

"Log Michael's meet results from Harry Meisel"

他のスキルとの連携

youtube_transcript ワークフローの完了後：

1. Transcript generated
2. Use learning-documentation-skill
3. Log to Supabase insights table
4. Category: learning, subcategory: youtube_transcript

タスクの完了後：

1. Task marked COMPLETED
2. Use learning-documentation-skill
3. Log patterns/insights discovered
4. Category: adhd, subcategory: task_patterns

重要な注意事項

1. 一貫した分類体系： 常に標準カテゴリを使用します
2. JSON 構造： プレーンテキストより構造化データを優先します
3. アクション項目： 実行可能な洞察を抽出して追跡します
4. 重複の防止： 挿入前に検索します
5. 将来の自分のために： 後で検索しやすいように記録します