yuque-personal-style-extract

风格提取——语雀文档写作风格分析

分析一篇或多篇语雀文档，提取写作风格特征，帮助用户学习优秀文档，或保持写作风格一致。

使用场景

• 用户想分析某篇特定文档的写作风格
• 用户说“分析一下这篇文档的写作风格”“extract the style”“学习这篇文档的风格”
• 用户想让多篇文档保持风格一致
• 用户说“帮我总结一下我的写作特点”“我想保持和这篇一样的风格”

所需 MCP 工具

所有工具均来自 yuque-mcp 服务：

• yuque_search — 按关键词搜索文档，查找目标文档
• yuque_get_doc — 读取完整文档内容，以分析其风格
• yuque_list_repos — 列出个人知识库，以便浏览文档

工作流

步骤 1：确定目标文档

用户可能会提供：

• 特定文档的标题或链接
• 用于搜索文档的关键词
• 分析整体写作风格的请求（多篇文档）

如果用户提供了特定文档：

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

如果用户提供了关键词，先进行搜索：

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

如果要分析整体风格，请从用户的知识库中读取 3-5 篇近期文档。

步骤 2：分析风格维度

从以下维度检查文档：

维度	观察要点
📐 结构（Structure）	标题层级、章节组织方式、列表与段落的使用情况
🎯 语气（Tone）	正式或非正式、技术性或对话式、权威或协作
📝 用词（Vocabulary）	技术深度、术语使用、中英文混用模式
📏 篇幅（Length）	平均章节长度、段落密度、文档整体长度
🎨 格式（Formatting）	表格、代码块、图片、提示框、表情符号的使用情况
🔗 引用（References）	引用来源的方式、链接的使用、交叉引用
💡 表达（Expression）	示例、类比、设问、幽默的使用情况

步骤 3：提取风格档案

结合具体示例，撰写风格档案：

## 📊 写作风格分析报告

### 文档信息
- **文档**：[标题](链接)
- **知识库**：「知识库名称」
- **字数**：约 X 字
- **更新时间**：YYYY-MM-DD

---

### 📐 结构特征

- **层级**：[如：使用 H2/H3 两级标题，不使用 H4]
- **组织方式**：[如：总分总结构，先给结论再展开]
- **段落长度**：[如：每段 2-4 句，简洁明了]

### 🎯 语气与风格

- **整体基调**：[如：专业但不刻板，偶尔使用口语化表达]
- **人称使用**：[如：多用"我们"，营造协作感]
- **典型句式**：[引用 1-2 个代表性句子]

### 📝 用词特点

- **术语密度**：[高/中/低]
- **中英混用**：[如：技术名词保留英文，其余用中文]
- **高频词汇**：[列出 5-8 个特征性词汇]

### 🎨 格式偏好

- **常用元素**：[如：大量使用表格、代码块较少、喜欢用 emoji 做标记]
- **视觉节奏**：[如：每 2-3 段插入一个列表或表格，避免大段纯文字]

### 💡 表达手法

- **举例方式**：[如：喜欢用实际场景举例，常用"比如说..."]
- **逻辑连接**：[如：善用"首先/其次/最后"，过渡自然]

---

### 🎯 风格摘要（一句话）

> [用一句话概括这个写作风格，如："专业严谨但不失亲和力的技术文档风格，善用结构化表达和实例说明。"]

### 📋 风格复用建议

如果你想模仿这个风格写作，注意以下要点：
1. [具体建议 1]
2. [具体建议 2]
3. [具体建议 3]

步骤 4：比较风格（可选）

如果用户提供了多篇文档进行比较：

## 📊 风格对比

| 维度 | 文档 A | 文档 B |
|------|--------|--------|
| 语气 | [特征] | [特征] |
| 结构 | [特征] | [特征] |
| 用词 | [特征] | [特征] |
| 格式 | [特征] | [特征] |

### 共同点
- [共同特征 1]
- [共同特征 2]

### 差异点
- [差异 1]
- [差异 2]

指南

• 始终使用与用户相同的语言回答（中文或英文）
• 使用实际文档中的具体示例——引用特定句子或表达模式
• 保持客观、描述性的语气，不作评判——例如“使用较短的段落”，而不是“段落太短”
• 分析多篇文档时，指出其中一致的模式和差异
• 风格档案应具有可操作性，让读者看完后能够模仿这种风格写作
• 此技能分析个人知识库中的文档；对于团队知识库，请使用 yuque-group 插件中的对应技能

错误处理

情况	操作
未找到文档	尝试其他搜索关键词，然后告知用户
文档过短（<100 字符）	告知用户文档过短，无法进行有意义的风格分析
yuque_get_doc 失败（403）	告知用户可能没有权限访问此文档
API 超时	重试一次，然后告知用户存在连接问题
用户未提供特定文档	列出其知识库中的近期文档，并询问要分析哪篇