Style Extract — Your Writing Style Profile

Analyze your existing Yuque documents to extract your unique writing style — vocabulary habits, sentence structures, tone characteristics. Generate a reusable style profile that helps you (or AI) maintain a consistent voice when writing new content.

When to Use

User wants to understand their own writing style
User says "分析一下我的写作风格", "我的文风是什么样的", "extract my writing style"
User wants AI to write in their voice: "用我的风格写一篇...", "write like me"
User wants to ensure consistency across documents
User says "帮我生成一个风格画像", "create my style profile"

Required MCP Tools

All tools are from the yuque-mcp server:

yuque_list_books — List user's knowledge bases
yuque_list_docs — List documents in a knowledge base
yuque_get_doc — Read document content for style analysis
yuque_search — Find specific types of documents for analysis
yuque_create_doc — Save the style profile as a document

Workflow

Step 1: Gather Writing Samples

Ask the user for source material:

Case A — Specific documents: User provides links to documents they consider representative of their style.

Case B — Entire knowledge base: User specifies a knowledge base. Sample documents from it.

Case C — Auto-detect best samples: If the user isn't sure, search for their most substantial documents:

Tool: yuque_list_books

Tool: yuque_list_docs
Parameters:
  repo_id: "<namespace>"

Select 5-10 documents that are:

Written by the user (not copied/quoted content)
Substantial in length (> 500 characters)
Diverse in topic (to capture general style, not topic-specific patterns)

For each selected document:

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

Step 2: Analyze Writing Dimensions

Analyze the collected writing samples across these dimensions:

Vocabulary (用词习惯)

Formality level — Casual, semi-formal, or formal?
Jargon density — Heavy use of domain terms or plain language?
Favorite words — Recurring words or phrases the user gravitates toward
Filler patterns — Common transitions, connectors, hedging words
Language mixing — Do they mix Chinese/English? In what pattern?

Sentence Structure (句式结构)

Average sentence length — Short and punchy or long and flowing?
Complexity — Simple sentences or nested clauses?
Paragraph length — Brief paragraphs or dense blocks?
List usage — Frequent bullet points or prose-heavy?
Question usage — Do they use rhetorical questions?

Tone & Voice (语气特点)

Perspective — First person, second person, or impersonal?
Confidence level — Assertive ("X is Y") or hedged ("X might be Y")?
Humor — Dry wit, playful, or strictly serious?
Engagement style — Conversational or lecture-like?
Emotional range — Neutral/analytical or expressive/passionate?

Structural Habits (结构习惯)

Opening style — How do they start articles? (Question, statement, story, context)
Closing style — How do they end? (Summary, call-to-action, open question)
Heading style — Descriptive, concise, or creative headings?
Use of examples — Frequent concrete examples or abstract reasoning?
Formatting preferences — Heavy use of bold, quotes, code blocks, tables?

Step 3: Generate Style Profile

Create a structured style profile:

# ✍️ 写作风格画像

> 基于 [N] 篇文档分析生成
> 分析日期：YYYY-MM-DD

## 一句话风格概括

[用一句话描述用户的整体写作风格，如 "简洁直接的技术写作者，偏好短句和大量代码示例，语气自信但不傲慢"]

## 用词习惯

- **正式程度**：[描述 + 示例]
- **术语密度**：[描述 + 示例]
- **高频词汇**：[列出 5-10 个标志性用词]
- **过渡词偏好**：[常用的连接词和过渡表达]
- **中英混用**：[模式描述，如 "技术名词用英文，解释用中文"]

## 句式特征

- **句子长度**：[平均字数/句，与参考值对比]
- **段落长度**：[平均句数/段]
- **复杂度**：[简单句为主 / 复合句为主]
- **标志性句式**：[用户常用的句式模式，附原文示例]

## 语气画像

- **视角**：[第一人称 / 第二人称 / 无人称]
- **自信度**：[断言型 / 探讨型 / 谦逊型]
- **幽默感**：[描述]
- **互动性**：[对话式 / 独白式 / 教学式]

## 结构偏好

- **开头方式**：[描述 + 示例]
- **结尾方式**：[描述 + 示例]
- **标题风格**：[描述]
- **举例频率**：[高 / 中 / 低]
- **格式偏好**：[常用的 Markdown 元素]

## 风格指纹（供 AI 参考）

当需要模仿此风格写作时，遵循以下规则：

1. [具体规则 1，如 "每段不超过 4 句话"]
2. [具体规则 2，如 "技术概念首次出现时用中文解释 + 英文原词"]
3. [具体规则 3，如 "多用反问句引导思考"]
4. [具体规则 4，如 "避免使用'众所周知'等套话"]
5. [具体规则 5，如 "结尾倾向于提出开放性问题而非总结"]

## 示例对比

### 原文片段
> [从用户文档中摘取的典型段落]

### 风格要素标注
[标注该段落中体现的风格特征]

Step 4: Present and Refine

Show the style profile to the user and ask:

"这个风格画像准确吗？有没有哪些地方需要调整？"

Iterate based on user feedback. They might say:

"我觉得我没那么正式" → Adjust formality assessment
"这个高频词不是我的风格，是那篇文章特有的" → Remove outliers
"我希望新内容比我现在的风格更简洁" → Note as a style aspiration

Step 5: Save Style Profile (Optional)

Ask the user: "要把风格画像保存到语雀吗？以后写作时可以参考。"

If confirmed:

Tool: yuque_create_doc
Parameters:
  repo_id: "<target namespace>"
  title: "✍️ 我的写作风格画像"
  body: "<style profile in markdown>"

Confirm: "风格画像已保存到「[知识库名称]」：[文档链接]"

Using the Style Profile

When the user later asks to write content in their style:

Retrieve the saved style profile
Apply the "风格指纹" rules when generating content
After drafting, self-check against the profile dimensions
Present the draft with notes on which style elements were applied

Guidelines

Always answer in the same language the user used (Chinese or English)
Analyze at least 5 documents for a reliable profile — fewer may produce skewed results
Distinguish between the user's natural style and topic-specific writing (a tech doc vs. a personal reflection will differ)
High-frequency words should be genuinely characteristic, not just common words everyone uses
The style profile should be descriptive, not prescriptive — describe what the user does, don't judge it
When the user asks to "write like me", use the profile as a guide but don't produce robotic imitations
Update the profile periodically — writing style evolves over time

Error Handling

Situation	Action
Document not found (404)	Skip and note it; continue with other documents
Permission denied (403)	Tell user they may lack permission to access this document
Too few documents (< 3)	Inform user: "文档数量较少，风格分析可能不够准确。建议提供至少 5 篇文档"
Documents are mostly copied/quoted content	Inform user: "这些文档大部分是引用内容，需要你原创的文档来分析风格"
`yuque_create_doc` fails	Present the style profile in chat for manual saving
Mixed authorship	Ask user to confirm which documents are their own writing

style-extract