📋 Vikunja-complete — 任务管理CLI
v4.0.0生产级 Vikunja 任务/项目管理技能,提供确定性 shell 命令与强校验,支持任务、评论、标签、附件、令牌等全功能 API 调用。
详细分析 ▾
运行时依赖
版本
- 重大重写:定制 Vikunja 技能,含生产级命令脚本与强校验。 - 通过确定性 shell 命令,全面支持任务、评论、标签、经办人、视图、webhook、附件、关联、筛选、通知、订阅及 API 令牌管理。 - 附带详尽安装说明,需 curl、jq 及环境变量。 - 包含冒烟测试框架,用于端到端验证。
安装命令
点击复制技能文档
# Vikunja(定制核心版) 面向生产的定制 Vikunja 技能。 ## 设置 ``bash export VIKUNJA_URL="https://your-vikunja-host" export VIKUNJA_TOKEN="" ` 脚本路径: `bash {baseDir}/scripts/vikunja.sh ` ## 核心任务命令 `bash {baseDir}/scripts/vikunja.sh health {baseDir}/scripts/vikunja.sh list --project "Inbox" --limit 25 {baseDir}/scripts/vikunja.sh create --project "Inbox" --title "Call vendor" --due "2026-03-15" --priority 4 {baseDir}/scripts/vikunja.sh update --id 123 --title "Updated title" --priority 5 --reminder "2026-03-14" {baseDir}/scripts/vikunja.sh move --id 123 --project "Ops" --view "Kanban" --bucket "In Progress" {baseDir}/scripts/vikunja.sh complete --id 123 {baseDir}/scripts/vikunja.sh bulk-update --ids 101,102,103 --priority 3 --done false ` ## 评论 `bash {baseDir}/scripts/vikunja.sh comments list --task-id 123 {baseDir}/scripts/vikunja.sh comments add --task-id 123 --comment "Initial note" {baseDir}/scripts/vikunja.sh comments update --task-id 123 --comment-id 9 --comment "Edited note" {baseDir}/scripts/vikunja.sh comments delete --task-id 123 --comment-id 9 ` ## 标签 `bash # 全局标签 {baseDir}/scripts/vikunja.sh labels list {baseDir}/scripts/vikunja.sh labels create --title "blocked" --color "#ff0000" # 任务标签 {baseDir}/scripts/vikunja.sh labels list --task-id 123 {baseDir}/scripts/vikunja.sh labels add --task-id 123 --label "blocked" {baseDir}/scripts/vikunja.sh labels remove --task-id 123 --label-id 4 ` ## 负责人 `bash {baseDir}/scripts/vikunja.sh assignees list --task-id 123 {baseDir}/scripts/vikunja.sh assignees add --task-id 123 --user-id 1 {baseDir}/scripts/vikunja.sh assignees remove --task-id 123 --user-id 1 ` ## 视图与看板列 `bash {baseDir}/scripts/vikunja.sh views list --project "Inbox" {baseDir}/scripts/vikunja.sh views create --project "Inbox" --title "Kanban" --kind kanban {baseDir}/scripts/vikunja.sh buckets list --project "Inbox" --view "Kanban" {baseDir}/scripts/vikunja.sh buckets create --project "Inbox" --view "Kanban" --title "In Progress" ` ## 项目 webhook `bash {baseDir}/scripts/vikunja.sh webhooks list --project "Inbox" {baseDir}/scripts/vikunja.sh webhooks create --project "Inbox" --target-url "http://localhost:8787/hook" --event task.created --event task.updated {baseDir}/scripts/vikunja.sh webhooks delete --project "Inbox" --webhook-id 7 ` ## 附件 `bash {baseDir}/scripts/vikunja.sh attachments list --task-id 123 {baseDir}/scripts/vikunja.sh attachments upload --task-id 123 --file /tmp/proof.pdf {baseDir}/scripts/vikunja.sh attachments download --task-id 123 --attachment-id 44 --output /tmp/proof-copy.pdf {baseDir}/scripts/vikunja.sh attachments delete --task-id 123 --attachment-id 44 ` ## 关联关系 `bash {baseDir}/scripts/vikunja.sh relations add --task-id 123 --other-task-id 456 --kind blocks {baseDir}/scripts/vikunja.sh relations remove --task-id 123 --other-task-id 456 --kind blocks ` ## 已保存过滤器 `bash {baseDir}/scripts/vikunja.sh filters list {baseDir}/scripts/vikunja.sh filters create --title "Today High" --filter 'done = false && priority >= 4 && due_date < now/d + 1d' {baseDir}/scripts/vikunja.sh filters get --id 3 {baseDir}/scripts/vikunja.sh filters update --id 3 --title "Today Critical" {baseDir}/scripts/vikunja.sh filters delete --id 3 ` ## 通知与订阅 `bash {baseDir}/scripts/vikunja.sh notifications list {baseDir}/scripts/vikunja.sh notifications mark --id 8 {baseDir}/scripts/vikunja.sh notifications mark {baseDir}/scripts/vikunja.sh subscriptions subscribe --entity project --entity-id 12 {baseDir}/scripts/vikunja.sh subscriptions unsubscribe --entity project --entity-id 12 ` ## API 令牌 `bash {baseDir}/scripts/vikunja.sh tokens list {baseDir}/scripts/vikunja.sh tokens create --title "automation" --expires-at "2026-12-31" --permissions-json '{"tasks":["read_all"]}' {baseDir}/scripts/vikunja.sh tokens delete --token-id 5 ` ## 冒烟测试套件 `bash # 示例(可选):引入本地环境辅助文件 # source ~/.config/vikunja/.vikunja_skill_env export VIKUNJA_URL VIKUNJA_TOKEN {baseDir}/scripts/test-smoke.sh ``