通过Vikunja API快速管理项目和任务，支持逾期/今日任务查询、标记完成及智能摘要，适合自托管任务管理场景。
说明：
## 核心用法
Vikunja Fast Skill 是连接 Clawdbot 与 Vikunja 自托管任务管理平台的桥梁工具，通过官方 REST API 实现项目与任务的自动化管理。核心功能覆盖三大场景：
**任务查询**：支持 `overdue`（逾期）、`due-today`（今日到期）、`list –filter`（自定义筛选）三种模式，自动遍历所有项目聚合任务视图。采用 `GET /tasks/all` 端点获取全量数据，本地通过 `jq` 处理 JSON 响应。
**任务操作**：提供 `show ` 查看详情、`done ` 标记完成功能，基于 `POST /tasks/{id}` 端点更新任务状态。
**格式化输出**：内置智能渲染逻辑——提取项目标题首字符作为 emoji（无则默认?），日期简化为 `Mon/D` 格式（隐藏时间与年份），输出格式为 ` – # `。
**认证机制**：支持 JWT Token（推荐，以 `eyJ` 开头）或用户名/密码登录换取 Token，通过 `Authorization: Bearer` 头部传递。
## 显著优点
– **自托管友好**：专为 Vikunja 自部署场景设计，数据完全私有可控
– **零配置快速启动**：仅需 `VIKUNJA_URL` + Token 即可运行，无需复杂初始化
– **跨项目聚合**：单次调用获取所有项目的任务视图，避免逐项目查询的低效
– **灵活的筛选语法**：支持 Vikunja 原生查询语法（如 `done = false && due_date < now`）
## 潜在局限
– **依赖外部服务**：需用户自行部署维护 Vikunja 实例，技能本身无任务存储能力
– **网络连通性要求**：所有操作均为实时 API 调用，离线场景不可用
– **Token 管理成本**：JWT 有过期机制，长期运行需处理续期逻辑
– **功能边界**：仅覆盖任务 CRUD 与查询，不支持项目创建、标签管理等高级功能
## 适合人群
– 已部署 Vikunja 的个人/团队用户
– 追求数据自主可控、拒绝 SaaS 的隐私敏感型用户
– 需要将任务管理集成到 Clawdbot 工作流的高级用户
## 常规风险
– **Token 泄露风险**：JWT 存储于环境变量或配置文件，需确保 `~/.clawdbot/clawdbot.json` 权限控制
– **API 限流隐患**：高频调用可能触发 Vikunja 服务端限流（未明确文档说明阈值）
– **版本兼容性**：依赖 `/api/v1` 端点，Vikunja 大版本升级可能破坏接口契约
– **无 HTTPS 降级风险**：若 `VIKUNJA_URL` 使用 HTTP，Token 存在中间人截获风险
会员专属
