---
name: style-extract
description: "Analyze Yuque documents to extract vocabulary, sentence, and tone patterns into a reusable writing-style profile. Use when the user wants to understand or reproduce their voice or keep documents consistent; trigger phrases include “分析一下我的写作风格”, “用我的风格写一篇...”, “帮我生成一个风格画像”, “extract my writing style”, and “write like me”."
license: MIT
compatibility: Requires the yuque-mcp MCP server connected with a personal Yuque token
metadata:
  author: yuque
  version: "1.0"
---

# 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:

```markdown
# ✍️ 写作风格画像

> 基于 [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:

1. Retrieve the saved style profile
2. Apply the "风格指纹" rules when generating content
3. After drafting, self-check against the profile dimensions
4. 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 |