yuque-personal-reading-digest

読書ダイジェスト — ドキュメントの要約と読書メモ

Yuque のドキュメントから、重要なポイント、主要な論点、実践につながる洞察をまとめた構造的な読書ダイジェストをすばやく作成します。

使用する場面

• 長い Yuque ドキュメントの要約を求められた場合
• ユーザーが「このドキュメントを要約して」「このドキュメントをまとめて」「読書要約を作成して」と言った場合
• 記事の重要なポイントを今後参照できるように抽出したい場合
• ユーザーが「この記事では何が述べられている？」「要点をまとめて」と言った場合

必要な MCP ツール

すべてのツールは yuque-mcp サーバーのものです。

• yuque_search — キーワードで対象のドキュメントを検索します
• yuque_get_doc — ドキュメントの全文を読み込みます
• yuque_list_repos — 保存先を見つけるために個人用リポジトリを一覧表示します
• yuque_create_doc — 読書ダイジェストを新しいドキュメントとして保存します

ワークフロー

ステップ 1：ドキュメントを特定する

ユーザーが提示する情報は、次のいずれかです。

• ドキュメントのタイトルまたはキーワード
• Yuque ドキュメントの直接 URL
• リポジトリとドキュメントの参照情報

ユーザーがキーワードまたはタイトルを提示した場合：

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

ユーザーが URL または具体的な参照情報を提示した場合は、repo_id と doc_id を直接抽出します。

ステップ 2：ドキュメントを読む

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

ドキュメントが非常に長い場合は、全体の長さを記録し、全文を読み進めます。

ステップ 3：読書ダイジェストを作成する

ドキュメントを分析し、構造化されたダイジェストを作成します。

# 📖 阅读摘要：[文档标题]

> **原文**：[文档标题](文档链接)
> **作者**：[作者]
> **阅读日期**：YYYY-MM-DD
> **预计阅读时间**：约 X 分钟

---

## 🎯 一句话总结

[用一句话概括文档的核心观点或目的]

---

## 📌 关键要点

1. **[要点 1]**：[简要说明]
2. **[要点 2]**：[简要说明]
3. **[要点 3]**：[简要说明]
4. **[要点 4]**：[简要说明]
5. **[要点 5]**：[简要说明]

---

## 🧠 核心论点与逻辑

[梳理文档的核心论证逻辑，2-3 段]

---

## 💡 启发与思考

- [这篇文档对我的启发 1]
- [这篇文档对我的启发 2]
- [可以应用到的场景]

---

## 📝 原文金句

> [摘录文档中值得记住的精彩段落 1]

> [摘录文档中值得记住的精彩段落 2]

---

## 🔗 相关延伸

- [可以进一步阅读的方向 1]
- [可以进一步阅读的方向 2]

---

> 本摘要由 AI 助手生成，建议结合原文阅读。

ステップ 4：ユーザーに確認する

ダイジェストをユーザーに提示し、次のように尋ねます。

• 「要約は正確ですか？修正したいところはありますか？」
• 「Yuque のナレッジベースに保存しますか？」

ステップ 5：（任意）Yuque に保存する

ユーザーが保存を希望する場合：

Tool: yuque_list_repos
Parameters:
  type: "user"

保存先のリポジトリを探すか、ユーザーに尋ねます（多くの場合は「読書メモ」または「読書要約」です）。

Tool: yuque_create_doc
Parameters:
  repo_id: "<namespace>"
  title: "📖 阅读摘要：[原文标题]"
  body: "<formatted digest>"
  format: "markdown"

ステップ 6：確認する

✅ 阅读摘要已生成并保存！

📄 **[📖 阅读摘要：原文标题](文档链接)**
📚 已归档到：「知识库名称」

### 摘要概览
- 提炼了 X 个关键要点
- 摘录了 X 条原文金句
- 生成了 X 个延伸阅读方向

ガイドライン

• 著者の本来の意図を保ち、歪曲したり過度に単純化したりしないでください
• 重要なポイントは具体的で実践可能なものにし、曖昧な一般論にしないでください
• 重要な主張には原文からの直接引用を含めてください
• 「気づきと考察」のセクションは個別化し、ユーザーの背景が分かっている場合はその状況に関連付けてください
• デフォルトの言語は中国語です。原文の言語に合わせてください
• 非常に長いドキュメント（5000 語超）の場合は、原文の構成に合わせてダイジェストをセクションに分けることを検討してください

エラー処理

状況	対応
yuque_search で結果が見つからない	正確なドキュメント URL またはリポジトリ／スラッグをユーザーに尋ねます
yuque_get_doc が失敗する（404）	ドキュメントが削除された可能性があることをユーザーに伝えます
yuque_get_doc が失敗する（403）	ユーザーに権限がない可能性があります。アクセス権を確認するよう案内します
ドキュメントが非常に短い（200 語未満）	ダイジェストの完全なテンプレートではなく、簡潔な要約を作成します
ドキュメントがテキスト以外（スライド、スプレッドシート）	このスキルはテキストドキュメントに最適であることをユーザーに伝えます