serendipity-88/yuque-power-user

yuque-power-user은(는) 무엇을 하나요?

语雀文档自动化 Claude Code Skill — MCP API 避坑指南、YMD 高级语法、画板 DSL、CLI 图片上传、Playwright 补充方案

概述

이 스킬은 Claude Code가 语雀(Yuque) 플랫폼과 효율적으로 상호작용할 수 있도록 설계된 고급 사용자 가이드입니다. 语雀은 중국에서 널리 사용되는 지식 관리 및 협업 문서 플랫폼입니다.

主要功能

• MCP API 避坑指南 — 语雀 MCP API 사용 시 일반적인 오류와 함정을 방지하는 방법
• YMD 高级语法 — 语雀 Markdown(YMD)의 고급 구문을 활용한 문서 서식 지정
• 画板 DSL — 语雀 画板(Whiteboard)을 위한 DSL(Domain-Specific Language) 사용법
• CLI 图片上传 — 명령줄 인터페이스를 통한 이미지 업로드 자동화
• Playwright 补充方案 — Playwright를 사용한 브라우저 자동화 보충 방안

使用指南

MCP API 避坑指南

다음은 语雀 MCP API를 사용할 때 주의해야 할 일반적인 문제와 해결 방법입니다:

# API 요청 예시
curl -X POST "https://www.yuque.com/api/v2/repos/{namespace}/docs" \
  -H "X-Auth-Token: {YOUR_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "문서 제목",
    "body": "문서 내용",
    "format": "markdown"
  }'

주의 사항:

• X-Auth-Token 헤더가 필수이며, 정확한 토큰 값을 사용해야 합니다.
• 요청 본문의 format 필드는 markdown, html, lake 중 하나여야 합니다.
• body 필드의 내용은 语雀의 Markdown 형식(YMD)을 따라야 합니다.

YMD 高级语法

YMD(Yuque Markdown)는 语雀에서 사용하는 확장 Markdown 구문입니다. 다음은 고급 기능 예시입니다:

<!-- 수식 -->
$$ E = mc^2 $$

<!-- 다이어그램 -->
```mermaid
graph TD;
    A-->B;
    A-->C;
    B-->D;
    C-->D;

• 완료된 작업
• 미완료 작업

헤더 1	헤더 2
셀 1	셀 2

### 画板 DSL

语雀 画板 DSL을 사용하여 다이어그램을 생성할 수 있습니다:

```plaintext
// 예시 DSL 코드
node "서버" at (100, 100) {
    shape: rectangle
    color: #4A90D9
}

node "클라이언트" at (300, 100) {
    shape: circle
    color: #F5A623
}

edge "서버" -> "클라이언트" {
    label: "HTTP 요청"
    style: dashed
}

CLI 图片上传

CLI를 통해 이미지를 업로드하는 방법:

# 语雀 CLI 도구 설치 (예시)
npm install -g yuque-cli

# 이미지 업로드
yuque upload image.png --namespace {namespace}

# 여러 이미지 업로드
yuque upload *.png --namespace {namespace}

Playwright 补充方案

Playwright를 사용한 브라우저 자동화 보충 방안:

const { chromium } = require('playwright');

async function yuqueAutomation() {
    const browser = await chromium.launch();
    const page = await browser.newPage();
    
    // 语雀 로그인
    await page.goto('https://www.yuque.com/login');
    await page.fill('input[name="login"]', 'your-email');
    await page.fill('input[name="password"]', 'your-password');
    await page.click('button[type="submit"]');
    
    // 문서 목록 로드
    await page.waitForURL('**/dashboard');
    console.log('로그인 성공!');
    
    await browser.close();
}

yuqueAutomation();

支持平台

이 스킬은 다음 AI 어시스턴트 플랫폼에서 사용할 수 있습니다:

• Claude Code
• Cursor
• Codex

许可证

이 스킬은 MIT 라이선스 하에 제공됩니다.