Style Extract — Yuque Document Writing Style Analysis
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 "帮我总结一下我的写作特点", "我想保持和这篇一样的风格"
Required MCP Tools
All tools are from the yuque-mcp server:
yuque_search— Search documents by keyword to find target documentsyuque_get_doc— Read full document content for style analysisyuque_list_repos— List personal knowledge bases to browse documents
Workflow
Step 1: Identify Target Documents
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.
Step 2: Analyze Style Dimensions
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 |
Step 3: Extract Style Profile
Compose a style profile with concrete examples:
## 📊 写作风格分析报告
### 文档信息
- **文档**：[标题](链接)
- **知识库**：「知识库名称」
- **字数**：约 X 字
- **更新时间**：YYYY-MM-DD
---
### 📐 结构特征
- **层级**：[如：使用 H2/H3 两级标题，不使用 H4]
- **组织方式**：[如：总分总结构，先给结论再展开]
- **段落长度**：[如：每段 2-4 句，简洁明了]
### 🎯 语气与风格
- **整体基调**：[如：专业但不刻板，偶尔使用口语化表达]
- **人称使用**：[如：多用"我们"，营造协作感]
- **典型句式**：[引用 1-2 个代表性句子]
### 📝 用词特点
- **术语密度**：[高/中/低]
- **中英混用**：[如：技术名词保留英文，其余用中文]
- **高频词汇**：[列出 5-8 个特征性词汇]
### 🎨 格式偏好
- **常用元素**：[如：大量使用表格、代码块较少、喜欢用 emoji 做标记]
- **视觉节奏**：[如：每 2-3 段插入一个列表或表格，避免大段纯文字]
### 💡 表达手法
- **举例方式**：[如：喜欢用实际场景举例，常用"比如说..."]
- **逻辑连接**：[如：善用"首先/其次/最后"，过渡自然]
---
### 🎯 风格摘要（一句话）
> [用一句话概括这个写作风格，如："专业严谨但不失亲和力的技术文档风格，善用结构化表达和实例说明。"]
### 📋 风格复用建议
如果你想模仿这个风格写作，注意以下要点：
1. [具体建议 1]
2. [具体建议 2]
3. [具体建议 3]Step 4: Compare Styles (Optional)
If the user provides multiple documents for comparison:
## 📊 风格对比
| 维度 | 文档 A | 文档 B |
|------|--------|--------|
| 语气 | [特征] | [特征] |
| 结构 | [特征] | [特征] |
| 用词 | [特征] | [特征] |
| 格式 | [特征] | [特征] |
### 共同点
- [共同特征 1]
- [共同特征 2]
### 差异点
- [差异 1]
- [差异 2]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-groupplugin
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 |