# Send siyuan-task-skill to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "siyuan-task-skill", "name": "siyuan-task-skill", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/zhhkheaven/siyuan-task-skill", "canonicalUrl": "https://clawhub.ai/zhhkheaven/siyuan-task-skill", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/siyuan-task-skill", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=siyuan-task-skill", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "config.env", "SKILL.md", "scripts/siyuan_api.py", "scripts/task_ops.py", "references/API.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "siyuan-task-skill", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-12T15:35:07.851Z", "expiresAt": "2026-05-19T15:35:07.851Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=siyuan-task-skill", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=siyuan-task-skill", "contentDisposition": "attachment; filename=\"siyuan-task-skill-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "siyuan-task-skill" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/siyuan-task-skill" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/siyuan-task-skill", "downloadUrl": "https://openagent3.xyz/downloads/siyuan-task-skill", "agentUrl": "https://openagent3.xyz/skills/siyuan-task-skill/agent", "manifestUrl": "https://openagent3.xyz/skills/siyuan-task-skill/agent.json", "briefUrl": "https://openagent3.xyz/skills/siyuan-task-skill/agent.md" } } ``` ## Documentation ### SiYuan Note Task Management Manage tasks in SiYuan Note (思源笔记) via Python scripts. All connection settings are in config.env — modify that file when the SiYuan instance address or credentials change. ### Configuration Edit config.env in the skill root directory. Only 3 items need manual configuration: SIYUAN_API_URL=http://100.64.0.11:52487 SIYUAN_API_TOKEN=xxxxxxxxxxxxxxxx SIYUAN_NOTEBOOK_NAME=work Note: SIYUAN_NOTEBOOK_ID is auto-resolved from SIYUAN_NOTEBOOK_NAME at runtime. You can still set it explicitly to skip the lookup. Then run init to auto-create the database and write remaining config: cd /scripts python3 task_ops.py init This creates the 任务清单 document, the TASK database, all columns, and writes AV_ID / COL_* IDs back to config.env automatically. If the 任务清单 document already contains a TASK database (e.g. copied from another notebook), init will detect and reuse it instead of creating a duplicate. ### Task Data Model Tasks are stored as rows in a TASK database (Attribute View) block inside the 任务清单 document. Each row has these columns: ColumnChineseTypeValues / Colors主键任务名称blockPrimary key — task name任务内容任务内容textTask description / details (what the task is about)相关方相关方textFree text重要程度重要程度select高(红) / 中(绿) / 低(灰)紧急程度紧急程度select高(红) / 中(绿) / 低(灰)状态状态select未开始(灰) / 进行中(绿) / 结束(红) / 挂起(蓝)备注备注textExtra notes / supplementary remarks (not the main task info)创建时间创建时间createdAuto开始时间开始时间dateTimestamp结束时间结束时间dateTimestamp更新时间更新时间updatedAuto Database IDs (auto-generated in config.env by init command): AV_ID — Attribute View ID AV_BLOCK_ID — AV block ID COL_* — Column IDs for each field Each task automatically gets a sub-document under /任务清单/{task_name} with this template: # 任务描述 # 任务附件 # 下一步 The sub-document name always matches the task name. The task's primary key in the database is linked to the sub-document (non-detached), showing a document icon. Renaming a task also renames its sub-document. Deleting a task also deletes its sub-document. ### Scripts All scripts are in the scripts/ directory. Run from that directory: cd /scripts ### siyuan_api.py — Base API Client Low-level client wrapping all SiYuan HTTP API endpoints. Used by task_ops.py internally. Can also be imported directly for custom operations: from siyuan_api import SiYuanClient client = SiYuanClient() result = client.sql_query("SELECT * FROM blocks WHERE type = 'd' LIMIT 5") Key methods: sql_query, create_doc, append_block, update_block, delete_block, set_block_attrs, get_block_attrs, get_child_blocks, get_block_kramdown, export_md, upload_asset, push_msg. See references/API.md for full SiYuan API reference. ### task_ops.py — Task CRUD Operations High-level CLI for task management. All commands output JSON. Create a task (auto-creates sub-document with template): python3 task_ops.py create "任务名称" content="任务内容" importance="高" urgency="中" notes="备注信息" Parameter mapping: content → 任务内容 (task description / main information about the task) notes → 备注 (supplementary remarks, not the main task info) stakeholders → 相关方 importance → 重要程度 (高/中/低) urgency → 紧急程度 (高/中/低) status → 状态 (default: 未开始) List all tasks: python3 task_ops.py list Find tasks by status: python3 task_ops.py find "进行中" Change task status (pass row_id from list output): python3 task_ops.py start python3 task_ops.py complete python3 task_ops.py suspend Rename a task (also renames sub-document): python3 task_ops.py rename "新名称" Attach image to task sub-document (uploads file and inserts into section): python3 task_ops.py attach-image /path/to/image.png python3 task_ops.py attach-image /path/to/image.png section="任务描述" Default section is 任务附件. On macOS, save clipboard image first: osascript -e 'set png to (the clipboard as «class PNGf»)' -e 'set f to open for access (POSIX file "/tmp/clip.png") with write permission' -e 'write png to f' -e 'close access f' List sub-documents: python3 task_ops.py list-docs Delete a task (also deletes sub-document): python3 task_ops.py delete Migrate database (apply schema changes and reorder columns): python3 task_ops.py migrate ### Programmatic Usage For complex workflows, import TaskManager directly in Python: import sys; sys.path.insert(0, "/scripts") from task_ops import TaskManager tm = TaskManager() # Create task (auto-creates sub-document with template) result = tm.create_task("实现用户登录", content="OAuth2 集成", importance="高", urgency="高") row_id = result["row_id"] doc_id = result["doc_id"] # Rename task (also renames sub-document) tm.rename_task(row_id, "实现OAuth2登录") # Status transitions tm.start_task(row_id) tm.complete_task(row_id) # Delete task (also deletes sub-document) tm.delete_task(row_id) # Attach image to task sub-document (default section: 任务附件) tm.attach_image_to_task(row_id, "/path/to/image.png") tm.attach_image_to_task(row_id, "/path/to/image.png", section="任务描述") ### Important Notes The 任务清单 document and TASK database are auto-created on first use Tasks are stored as database rows (Attribute View), not plain blocks row_id from list output is used for all update/delete operations 创建时间 and 更新时间 columns are auto-managed by SiYuan Block references use SiYuan format: (( "anchor text")) All API responses have code field — 0 means success ## Trust - Source: tencent - Verification: Indexed source record - Publisher: zhhkheaven - Version: 1.0.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-12T15:35:07.851Z - Expires at: 2026-05-19T15:35:07.851Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/siyuan-task-skill) - [Send to Agent page](https://openagent3.xyz/skills/siyuan-task-skill/agent) - [JSON manifest](https://openagent3.xyz/skills/siyuan-task-skill/agent.json) - [Markdown brief](https://openagent3.xyz/skills/siyuan-task-skill/agent.md) - [Download page](https://openagent3.xyz/downloads/siyuan-task-skill)