yuque-personal-note-refine

Note Refine — メモを再構成してブラッシュアップ

ユーザーが散在した粗いメモを、構成が整い、重複がなく、内容が充実したドキュメントにまとめられるよう支援します。混沌を明快さに変えます。

使用する場面

• ユーザーが乱雑なメモを整理したい場合
• ユーザーが「帮我整理笔记」、「メモをブラッシュアップして」、「把这些笔记理一下」と言った場合
• ユーザーが日々の記録を蓄積していて、まとめたい場合
• ユーザーが「这些笔记太乱了」、「帮我重新组织一下」、「去重整理」と言った場合

必要な MCP ツール

すべてのツールは yuque-mcp サーバーから提供されます。

• yuque_search — 整理対象のメモを検索します
• yuque_get_doc — メモの全文を読み込みます
• yuque_list_repos — 個人のリポジトリを一覧表示します
• yuque_list_docs — リポジトリ内のドキュメントを一覧表示します
• yuque_create_doc — 整理後のドキュメントを作成します
• yuque_update_doc — 元のドキュメントをその場で更新します

ワークフロー

ステップ 1：元となるメモを特定する

ユーザーが指定する内容は次のとおりです。

• 整理したい特定のドキュメント
• 日々の記録をまとめる対象の日付範囲
• 関連する散在したメモを探すためのトピックキーワード
• 統合する複数のドキュメントへの参照

ユーザーが「最近のメモを整理して」と言った場合：

Tool: yuque_search
Parameters:
  query: "每日捕获"
  type: "doc"

トピックを指定したメモの場合：

Tool: yuque_search
Parameters:
  query: "<topic keyword>"
  type: "doc"

ステップ 2：元となるメモをすべて読む

特定した各ドキュメントについて：

Tool: yuque_get_doc
Parameters:
  repo_id: "<namespace>"
  doc_id: "<slug>"

元となるドキュメントを 5～10 件読み込みます。それ以上ある場合は、新しさと関連性を基準に優先順位を付けます。

ステップ 3：分析して計画を立てる

整理する前に、元の内容を分析します。

1. テーマを特定する — 関連する内容をトピック別に分類します
2. 重複を見つける — 繰り返されているアイデアや情報に印を付けます
3. 不足箇所を見つける — 情報が不完全な箇所を記録します
4. 構成を評価する — 最適な整理方法を判断します

分析結果をユーザーに提示します。

## 📋 笔记分析

**来源**：X 篇文档，共约 XXXX 字

### 主题分布
- **[主题 1]**：X 条相关记录
- **[主题 2]**：X 条相关记录
- **[主题 3]**：X 条相关记录

### 发现
- 🔄 发现 X 处重复内容
- 🕳️ 发现 X 处信息缺口
- 📊 建议整理为 X 篇主题文档

要按这个方向整理吗？

ステップ 4：メモを整理する

ユーザーの確認を得て、整理を実行します。

4a. 単一ドキュメントの整理

1 つのドキュメントを再構成します。

• わかりやすい見出しと階層を追加します
• 重複した内容を削除します
• 表現と明瞭さを改善します
• 不足している背景情報やつなぎの説明を追加します
• 時系列のメモを論理的な構成に整理します

4b. 複数ドキュメントの統合

複数のメモをテーマ別のドキュメントにまとめます。

• トピック別に分類します
• ドキュメント間の重複を取り除きます
• 一貫性のある内容にまとめます
• 出典を保持します（元の記録の日付や情報源を記載します）

整理後のドキュメントのテンプレート：

# [主题标题]

> 整理自 X 篇笔记，时间跨度：YYYY-MM-DD 至 YYYY-MM-DD
> 最后整理：YYYY-MM-DD

---

## 概述

[对这个主题的整体概述，2-3 句话]

---

## [分类 1]

### [子主题 1.1]

[整理后的内容]

### [子主题 1.2]

[整理后的内容]

---

## [分类 2]

### [子主题 2.1]

[整理后的内容]

---

## 待补充

- [ ] [识别出的信息缺口 1]
- [ ] [识别出的信息缺口 2]

---

## 原始来源

- [原文档 1 标题](链接) — YYYY-MM-DD
- [原文档 2 标题](链接) — YYYY-MM-DD

---

> 本文档由 AI 助手整理，原始笔记已保留。

ステップ 5：整理後のドキュメントを保存する

ユーザーの希望を確認します。

• 新規作成 — 新しいドキュメントとして保存します（複数ドキュメントの統合におすすめ）
• その場で更新 — 元のドキュメントを置き換えます（単一ドキュメントの整理向け）

新規ドキュメントの場合：

Tool: yuque_create_doc
Parameters:
  repo_id: "<namespace>"
  title: "[主题标题]"
  body: "<refined content>"
  format: "markdown"

その場で更新する場合：

Tool: yuque_update_doc
Parameters:
  repo_id: "<namespace>"
  doc_id: "<slug>"
  body: "<refined content>"

ステップ 6：確認する

✅ 笔记整理完成！

📄 **[[主题标题]](文档链接)**
📚 已保存到：「知识库名称」

### 整理成果
- 📥 输入：X 篇原始笔记，约 XXXX 字
- 📤 输出：1 篇结构化文档，约 XXXX 字
- 🔄 去除重复：X 处
- 🕳️ 标记待补充：X 处

💡 原始笔记已保留，可随时对照。

ガイドライン

• 元のメモは必ず保持し、デフォルトでは新しいドキュメントに整理します
• 重複を取り除く際に情報を捨てないでください。統合し、内容を充実させます
• ユーザーの語り口や用語を保ち、カジュアルなメモを過度に形式ばった表現にしないでください
• 解釈に確信が持てない場合は、「【要確認】」のマーカーを付けます
• 日々の記録については、週ごとまたは隔週での整理を提案します
• メモが複数のトピックにまたがる場合は、トピックごとに別々の整理済みドキュメントを作成します
• 特定した不足箇所をユーザーが後で補えるよう、「追記が必要」セクションを追加します
• デフォルトの言語は中国語です

エラー処理

状況	対応
元となるメモが少なすぎる（3 件未満）	入手できる範囲で整理し、まずはメモを増やすよう提案します
元となるメモが多すぎる（10 件を超える）	新しいものを優先するか、対象を絞るようユーザーに尋ねます
内容がすでに十分整理されている	正直に伝え、軽微な改善のみを提案します
yuque_update_doc が失敗する	新しいドキュメントの作成に切り替えます
メモに複数の言語が混在している	優勢な言語を維持し、無理に翻訳しません