article-enrichment

article-enrichment — 生のダンプから役立つブレインページへ

規約： 引用のルール、逐語引用の要件、バックリンクの徹底については、conventions/quality.md を参照してください。

規約： ファイリングのルールについては、_brain-filing-rules.md を参照してください。記事ページは、生データの取り込み用に media/articles/ の下に置きます。個別にパーソナライズした統合結果には、承認済みの例外である media/articles/<slug>-personalized.md を使用します。

これは何をするものか

生の抽出テキストが壁のように並んだ記事のブレインページを、次の要素を含む構造化ページに書き直します。

• エグゼクティブサマリー — 2～3文で、覚えておく価値のある最も重要なことをまとめます
• 重要な理由 — ユーザー固有のプロジェクトや関心事とのつながりを示します（推測せず、ブレインのコンテキストから読み取ります）
• 引用に適した一節 — エッセイで参照する価値のある逐語引用を3～5件掲載します
• 主な洞察 — トピックのラベルではなく、実際の洞察を示します
• 意外な点、または直感に反する点 — このコンテンツならではの特徴を示します
• 関連項目 — 関連するブレインページへの標準的な Markdown リンクを掲載します

元の内容が失われないよう、生のソースコンテンツは折りたたまれた <details> セクションに保持します。

呼び出すタイミング

• 新しい記事ページが needs_enrichment: true で media-ingest 経由でブレインに追加されたとき
• 既存の記事ページが ## Content ヘッダーの下に統合なしでテキストだけ並んでいるとき
• ユーザーがブレインページを役に立たない、退屈、またはダンプだと言ったとき
• 記事ページについて、LLM 判定によるブレイン品質評価で引用のしやすさ、または実行可能性が不合格になったとき

パイプライン

1. READ      → Open the article brain page; parse frontmatter + body.
2. SCAN      → Look for ## Content (raw dump) and absence of ## Executive Summary.
3. CONTEXT   → gbrain query the article's key entities to ground "Why It Matters".
4. ENRICH    → Sonnet (default) or Opus (for high-value content) restructures.
5. WRITE     → Replace ## Content with the structured sections; preserve raw
               source in <details>; clear needs_enrichment in frontmatter.
6. CROSS-LINK→ Add back-links from referenced people/companies pages
               (Iron Law per conventions/quality.md).

呼び出し方法

このスキルは、エージェント向けの Markdown 指示書です。v0.25.1 では、決定論的な CLI コマンドは提供しません。エージェントは gbrain の既存の操作を使用します。

# 1. Find candidate pages
gbrain query "needs_enrichment: true type:article" --limit 50

# 2. For each candidate, read the page
gbrain get media/articles/<slug>

# 3. Enrich via the agent's LLM (Sonnet by default; Opus for high-value)
#    The agent reads the raw content + brain context + writes the structured page.

# 4. Write the enriched page
#    Use the put_page operation with the new structured markdown body.

# 5. Cross-link entities
#    For every person/company mentioned, add a timeline back-link.

品質基準

次の条件を満たす場合、強化済みページとして合格です。

• ✅ ## Executive Summary（2～3文）がある
• ✅ ## Quotable Lines に逐語引用（言い換えではなく文字どおりの引用）が3件以上ある
• ✅ ## Key Insights に箇条書きの洞察（トピックのラベルではない）が3件以上ある
• ✅ ## Why It Matters が、具体的なブレインのコンテキストと結び付いている（一般論ではない）
• ✅ ## See Also に標準的な Markdown リンクがある（[[wiki-links]] は不可）
• ✅ 生のソースコンテンツを保持する <details> ブロックがある

モデルの選択

モデル	使用する場面	引用の正確さ
Sonnet（デフォルト）	一括での強化、ほとんどの記事	良好 — ときどき言い換えます
Opus	価値の高いコンテンツ、独自の考察を含む記事、長文記事	優秀 — 「逐語」の指示を守ります

ルール：一括で強化する場合は、まず Sonnet でドラフトを作成し、LLM 判定によるブレイン品質評価で5件を抜き取り確認します。引用が言い換えられている場合は、そのバッチでは Opus に切り替えてください。

リンク規約

すべての相互参照には、標準的な Markdown リンク [Title](relative/path.md) を使用してください。 [[wiki-links]] は絶対に使用しないでください。GitHub ではレンダリングされません。

失敗した場合

gbrain のエラー code、終了コード、[AGENT] ブロック、または通知ブロックについては、エージェント運用者プロトコルに従ってください。このスキル固有の対応は次のとおりです。

• get_page が page_not_found を返した場合：生のダンプが移動したか、slug が間違っています。記事が見つからないと報告する前に、タイトルを検索してください。
• 書き直し時に revision_conflict が返された場合：読み取り後に他のユーザーがページを編集しています。ページを読み直し、新しいテキストに強化処理を適用し直して、新しいリビジョンで保存してください。確認せずに上書きしてはいけません。
• write_pending（終了コード 10）の場合：gbrain write-request <request_id> をポーリングしてください。レシートがコミットされた後に限り、ページの強化が完了したと報告してください。

避けるべきパターン

• ❌ 引用を言い換えること（「著者は…と主張している」など）。逐語でなければ引用ではありません。
• ❌ 一般論の「重要な理由」（「イノベーションが重要だから」など）。具体的なブレインのコンテキストに結び付けるか、このセクションを削除してください。
• ❌ トピックのラベルを作り、それを洞察と呼ぶこと。洞察とは、記事が述べていることで、すでに知っていたことではないものです。
• ❌ 生のソースを破棄すること。必ず <details> で囲んでください。
• ❌ 冪等性のない形で再強化すること。frontmatter の needs_enrichment フラグを確認し、すでに false なら処理をスキップしてください。

関連スキル

• skills/media-ingest/SKILL.md — このスキルが拡充する生の記事ページを作成します
• skills/idea-ingest/SKILL.md — 著者の人物ページを必須とするリンク・記事の取り込み
• skills/conventions/quality.md — 引用 + バックリンクのルール

コントラクト

このスキルは以下を保証します。

• ルーティングが frontmatter 内の正規のトリガーと一致すること。
• 出力が writes_to: に記載されたディレクトリ配下に書き込まれること（該当する場合）。
• 参照される規約（quality.md、brain-first.md、_brain-filing-rules.md）が遵守されること。
• プライバシーコントラクトが維持されること: 実名なし、フォーク固有のファイルシステムパスリテラルなし、上流フォークへの参照なし。

完全な動作コントラクトは上記の本文セクションに記載されています。このセクションは適合テスト用に存在します。

出力形式

このスキルの出力形状は、上記の本文セクション内にインラインで記載されています（「Output」、「Brain page format」、または同等の項目を参照）。ここにあるリテラルなセクション見出しは、適合テスト（test/skills-conformance.test.ts）用に存在します。