topic-bookmarks-reorganizer

トピックのブックマークを整理

概要

ブラウザーのブックマークエクスポートから、ユーザーが指定したトピックフォルダーを1つ整理し、より見やすく、インポート可能なNetscape HTMLファイルにします。このワークフローでは、元のエクスポートを分析し、対象のトピックフォルダーを抽出して、リンクとサブフォルダーを再分類し、URLの重複を削除したうえで、ブラウザーにインポートできる形式で出力します。

使用する場面

ユーザーから次のいずれかを依頼された場合に、このスキルを使用します。

• ブックマークのエクスポートファイルを分析し、指定されたトピックフォルダーを見つける
• そのトピック内のリンクとサブフォルダーを再分類する
• URLで重複リンクを削除する
• ブラウザーにインポートできる新しいHTMLファイルを出力する
• 出力に対象のトピックフォルダーだけを残す

使用しない場面

次の場合は、このスキルを使用しないでください。

• 入力がブックマークのエクスポートHTMLファイルではない
• ユーザーがファイル処理を伴わない手動の文章作成支援だけを求めている
• ユーザーが無関係なJSON／PDF／Docxの変換を求めている

手順

1. 必要な入力を確認します。

• エクスポートファイルのパス
• 対象トピックフォルダー名
• 出力ファイルのパス

2. まずレポートモードでスクリプトを実行します。

python3 scripts/reorganize_topic_bookmarks.py \
  --input /path/to/bookmarks.html \
  --output /tmp/topic-preview.html \
  --topic-folder "<topic-folder-name>" \
  --mode auto \
  --lang en \
  --report /tmp/topic-report.json \
  --print-report

3. 必要な場合に限り、最終オプションをユーザーに確認します。

• 自動で方法を選択する場合は --mode auto
• 汎用の方法を使用する場合は --mode generic
• URLの重複を残す場合は --no-dedupe-url

4. 最終出力を生成します。

python3 scripts/reorganize_topic_bookmarks.py \
  --input /path/to/bookmarks.html \
  --output /path/to/topic-bookmarks-reorganized.html \
  --topic-folder "<topic-folder-name>" \
  --mode auto \
  --lang en

5. 検証して結果を報告します。

• 出力ファイルが存在することを確認する
• 入力リンク数、出力リンク数、削除した重複数を報告する
• 出力にトップレベルフォルダーが対象のトピックフォルダー1つだけ含まれていることを確認する

出力の要件

• 出力形式はNetscapeブックマークHTMLで、ブラウザーにインポートできます
• 出力には対象のトピックフォルダーだけが含まれます
• リンクは元の<A ...>属性（例：add-date／icon）を保持します
• フォルダー構造は上位カテゴリに再編成されます