메뉴
MCP playbook for creating and editing SiYuan documents and blocks. Use for path-based document creation, block append/insert/update, metadata, daily notes, and verified edits.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
MCP playbook for browsing and reading SiYuan notes. Use for notebooks, document trees, human-readable paths, IDs, storage paths, block content, and read-only discovery.
MCP playbook for SiYuan attribute views. Use to inspect database metadata, render views, add columns or rows, update cells, and keep AV, view, row, column, and block IDs distinct.
MCP playbook for SiYuan assets and exports. Use for uploads, Markdown export, document extraction, resource ZIP export, OCR text, templates, and safe asset maintenance.
MCP SiYuan markup guide for rich Markdown written through block and document actions. Use for headings, lists, tasks, tables, code, math, diagrams, tags, callouts, super blocks, embeds, and block references.
MCP playbook for finding and querying SiYuan content. Use for fulltext, read-only SQL, backlinks, references, assets, dynamic query blocks, and safe find-replace.
Top-level skill for operating SiYuan Note through the Sisyphus MCP server. Use to choose an aggregated tool, discover action resources, route complex tasks to a scenario skill, and apply permissions and safety rules.
| name | siyuan-mcp-create-edit |
| description | MCP playbook for creating and editing SiYuan documents and blocks. Use for path-based document creation, block append/insert/update, metadata, daily notes, and verified edits. |
Read the target first, choose the highest-level action that preserves intent, perform one bounded change, then read it again.
Use a workspace path for convenient path-based creation:
fs(action="write", path="/Notebook/Project/Notes", markdown="# Notes\n\nInitial content.")
Use a notebook ID plus notebook-local hpath when low-level control is needed:
document(action="create", notebook="<notebook-id>", path="/Project/Notes", markdown="# Notes")
Do not include the notebook name in the low-level hpath.
block(action="append", parentID="<doc-id>", dataType="markdown", data="## New section\n\nParagraph.")
block(action="insert", previousID="<block-id>", dataType="markdown", data="Inserted paragraph.")
block(action="update", id="<block-id>", dataType="markdown", data="Replacement block content.")
Use block update only when replacing the whole block is intended. Prefer a scoped replacement for a small textual change:
block(action="replace", id="<block-id>", edit={"old":"draft","new":"final"})
block(action="set_attrs", id="<block-id>", attrs={"custom-source":"agent"})
document(action="create_daily_note", notebook="<notebook-id>")
Before rename, move, delete, or broad replacement, resolve the exact target, show the affected scope, and obtain approval. After every mutation, read by stable ID when possible. Use siyuan://help/action/block/append when any parameter is uncertain.