knowledge-base

ナレッジベース

~/knowledge/ にある、トピック別にまとめた厳選リンクとメモのコレクションです。

構成

~/knowledge/
├── _index.md          # Topic listing
├── _inbox.md          # Unprocessed items
├── topics/*.md        # Articles, concepts, best practices
├── tools/*.md         # Software, libraries (organized by use case)
└── archive/YYYY-MM/   # Full article content (link rot protection)

エントリー形式

トピック（記事／概念）：

**[Title](url)** — Author

1-2 paragraph summary focusing on core insights. Be extremely concise, disregard grammar.

ツール（ソフトウェア／ライブラリ）：

### [tool-name](url)

**Platform:** macOS / JavaScript / Web Service
**Install:** Installation method
**Use case:** Problem it solves

Brief summary of why it's useful and when to use it.

**Alternatives:** other-tool (tradeoff)

ワークフロー：Safari から追加する

1. タブを取得します：get_tabs.sh markdown または get_tabs.sh -w N markdown
2. コンテキストのあふれを避けるため、8～10件ずつ処理します
3. バッチごとに以下を行います：
   • URL からコンテンツを取得します
   • 既存のトピックファイルを読みます
   • コンテンツに基づいて適切なトピックに振り分けます
   • 内容が充実している記事や独自性のある記事は archive/YYYY-MM/ にアーカイブします
   • 既存のトピックに当てはまらない項目は _inbox.md に追加します
4. 完了したら _index.md を更新します

振り分け

記事／概念 → topics/：

• タイトルだけでなく、内容に基づいて照合します
• より具体的なトピックを優先します
• 判断に迷う場合は、推奨トピックを添えて _inbox.md に追加します
• トピックが500行を超える、または30件を超える場合は、分割するかユーザーに確認します

ソフトウェア／ツール → 用途別に tools/：

• ライブラリ、CLI ツール、アプリ、ウェブサービスはすべてこちらに追加します
• ツールについての記事は topics/ に追加します
• 必要に応じて新しい用途別ファイルを作成します

品質管理

一括追加中に以下のものが見つかった場合は、作業を止めて確認してください：

• 場違いなコンテンツや質の低いコンテンツ
• GitHub リポジトリ／gist（振り分け先を確認します）
• 取得に失敗したもの（最後にまとめて、URL のみ追加するか確認します）

アーカイブ

以下の場合は archive/YYYY-MM/ にアーカイブします：

• 内容が充実している（500語超）
• 消失する可能性が高い（個人ブログ）
• 独自の知見がある

除外するもの：GitHub リポジトリ、YouTube、頻繁に更新されるドキュメント、ニュース

ファイル形式のリファレンス

トピックファイル：tags、updated を含む YAML フロントマターの後に、エントリーのセクションが続きます ツールファイル：同じフロントマターの後に、メタデータ付きの ### [tool](url) エントリーが続きます

リソースを追加したら、新しいトピック／ツールを _index.md に追加します。

リソースを探す

ユーザーがソフトウェア／ライブラリを必要としている場合は、ウェブ検索の前に tools/ を確認します。