yuque-personal-style-extract

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Style Extract — Yuque Document Writing Style Analysis

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

Analyze one or more Yuque documents to extract writing style characteristics, helping users learn from excellent documents or maintain consistent writing style.

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

When to Use

适用场景

User wants to analyze the writing style of a specific document
User says "分析一下这篇文档的写作风格", "extract the style", "学习这篇文档的风格"
User wants to maintain consistent style across documents
User says "帮我总结一下我的写作特点", "我想保持和这篇一样的风格"

用户想要分析特定文档的写作风格
用户说“分析一下这篇文档的写作风格”, “extract the style”, “学习这篇文档的风格”
用户想要跨文档保持统一风格
用户说“帮我总结一下我的写作特点”, “我想保持和这篇一样的风格”

Required MCP Tools

所需MCP工具

All tools are from the

yuque-mcp

server:

```
yuque_search
```
— Search documents by keyword to find target documents
```
yuque_get_doc
```
— Read full document content for style analysis
```
yuque_list_repos
```
— List personal knowledge bases to browse documents

所有工具都来自

yuque-mcp

服务器：

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

Workflow

工作流

Step 1: Identify Target Documents

步骤1：确定目标文档

The user may provide:

A specific document title or link
A keyword to search for the document
A request to analyze their overall writing style (multiple docs)

If a specific document is given:

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

If the user gives keywords, search first:

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

For overall style analysis, read 3-5 recent documents from the user's repos.

用户可能提供：

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

如果用户给出了特定文档：

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

如果用户给出了关键词，先进行搜索：

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

如果是整体风格分析，从用户的知识库中读取3-5份最近更新的文档。

Step 2: Analyze Style Dimensions

步骤2：分析风格维度

Examine the document(s) across these dimensions:

Dimension	What to Look For
📐 结构 (Structure)	Heading hierarchy, section organization, use of lists vs paragraphs
🎯 语气 (Tone)	Formal/informal, technical/conversational, authoritative/collaborative
📝 用词 (Vocabulary)	Technical depth, jargon usage, Chinese/English mixing patterns
📏 篇幅 (Length)	Average section length, paragraph density, overall document length
🎨 格式 (Formatting)	Use of tables, code blocks, images, callouts, emoji
🔗 引用 (References)	How sources are cited, use of links, cross-references
💡 表达 (Expression)	Use of examples, analogies, rhetorical questions, humor

从以下维度考察文档：

维度	考察点
📐 结构 (Structure)	标题层级、章节组织、列表与段落的使用方式
🎯 语气 (Tone)	正式/非正式、技术向/对话向、权威感/协作感
📝 用词 (Vocabulary)	技术深度、术语使用情况、中英文混用模式
📏 篇幅 (Length)	平均章节长度、段落密度、文档总长度
🎨 格式 (Formatting)	表格、代码块、图片、标注、emoji的使用情况
🔗 引用 (References)	来源引用方式、链接使用、交叉引用情况
💡 表达 (Expression)	举例、类比、反问、幽默的使用情况

Step 3: Extract Style Profile

步骤3：提取风格画像

Compose a style profile with concrete examples:

markdown

undefined

生成包含具体示例的风格画像：

markdown

undefined

📊 写作风格分析报告

文档信息

文档：标题
知识库：「知识库名称」
字数：约 X 字
更新时间：YYYY-MM-DD

文档：标题
知识库：「知识库名称」
字数：约 X 字
更新时间：YYYY-MM-DD

📐 结构特征

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

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

🎯 语气与风格

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

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

📝 用词特点

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

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

🎨 格式偏好

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

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

💡 表达手法

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

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

🎯 风格摘要（一句话）

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

📋 风格复用建议

如果你想模仿这个风格写作，注意以下要点：

[具体建议 1]
[具体建议 2]
[具体建议 3]

undefined

如果你想模仿这个风格写作，注意以下要点：

[具体建议 1]
[具体建议 2]
[具体建议 3]

undefined

Step 4: Compare Styles (Optional)

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

If the user provides multiple documents for comparison:

markdown

undefined

如果用户提供多份文档用于对比：

markdown

undefined

📊 风格对比

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

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

共同点

[共同特征 1]
[共同特征 2]

[共同特征 1]
[共同特征 2]

差异点

[差异 1]
[差异 2]

undefined

[差异 1]
[差异 2]

undefined

Guidelines

使用指南

Always answer in the same language the user used (Chinese or English)
Use concrete examples from the actual document — quote specific sentences or patterns
Be objective and descriptive, not judgmental — "uses short paragraphs" not "paragraphs are too short"
When analyzing multiple documents, identify both consistent patterns and variations
The style profile should be actionable — someone should be able to write in a similar style after reading it
This skill analyzes documents in personal repos — for team repos, use the corresponding skill in the
```
yuque-group
```
plugin

始终使用用户提问的语言作答（中文或英文）
使用来自实际文档的具体示例——引用具体的句子或模式
保持客观描述，不做评判——描述为“使用短段落”而非“段落太短”
分析多份文档时，既要识别一致的模式，也要指出差异
风格画像应具备可操作性——用户阅读后应该能够仿照该风格写作
本技能用于分析个人知识库中的文档——如果是团队知识库，请使用
```
yuque-group
```
插件中的对应技能

Error Handling

错误处理

Situation	Action
Document not found	Try alternative search keywords, then inform user
Document too short (<100 chars)	Inform user the document is too short for meaningful style analysis
`yuque_get_doc` fails (403)	Tell user they may lack permission to access this doc
API timeout	Retry once, then inform user of connectivity issue
User provides no specific document	List recent docs from their repos and ask which to analyze

场景	处理方式
未找到文档	尝试替换搜索关键词，之后告知用户
文档过短（少于100字符）	告知用户文档太短，无法进行有效的风格分析
`yuque_get_doc` 调用失败（403）	告知用户可能没有访问该文档的权限
API超时	重试一次，之后告知用户存在连接问题
用户未提供具体文档	列出其知识库中的近期文档，询问要分析哪一份