核心用法
Vikunja Fast Skill 是连接 Clawdbot 与 Vikunja 自托管任务管理平台的桥梁工具，通过官方 REST API 实现项目与任务的自动化管理。核心功能覆盖三大场景：
任务查询：支持 overdue（逾期）、due-today（今日到期）、list --filter（自定义筛选）三种模式，自动遍历所有项目聚合任务视图。采用 GET /tasks/all 端点获取全量数据，本地通过 jq 处理 JSON 响应。
任务操作：提供 show <id> 查看详情、done <id> 标记完成功能，基于 POST /tasks/{id} 端点更新任务状态。
格式化输出：内置智能渲染逻辑——提取项目标题首字符作为 emoji（无则默认🔨），日期简化为 Mon/D 格式（隐藏时间与年份），输出格式为 <EMOJI> <DUE_DATE> - #<ID> <TASK>。
认证机制：支持 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 存在中间人截获风险