소스 정보
- 저장소
- zrong/skills
- 최근 소스 활동
- 2026년 6월 8일 10:06
- 감지된 SKILL.md 언어
- 중국어
- 스타
- 12
- 포크
- 4
설치 방법
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
소스 파일 검토
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
파일 탐색기
3 개 파일SKILL.md 표시 중
SKILL.md
소스 지침 · 읽기 전용 미리보기- name
- vikunja
- description
- Vikunja 任务管理工具，支持查看项目和任务，并将每周已完成的任务同步到 Joplin weekly 笔记。
# Vikunja Skill
从自托管 Vikunja 实例读取任务，同步到 Joplin。
## 前置依赖
- **joplin skill** 必须已安装（`https://github.com/zrong/skills`）
- Vikunja 实例需要可访问
- 在 `agent_config.toml` 中配置 `[vikunja]` section
## 环境配置
在 `agent_config.toml` 中添加：
```toml
[vikunja]
base_url = "https://nas.zengrong.net:8456/api/v1"
api_token = "<your-api-token>"
```
## 命令指南
建议使用 `uv run --project vikunja/scripts vikunja/scripts/vikunja_tool.py <command>` 执行。
### 1. 项目
- **列出项目**: `list-projects`
### 2. 任务
- **列出任务**: `list-tasks [--project ID] [--done] [--week YYYY-Www] [--limit N]`
- 使用 `--week` 时，任务归属周按有效日期判断：若任务设置了 `end_date`，优先使用 `end_date`；否则使用 `done_at`
### 3. 同步
- **同步到 Joplin**: `sync-weekly [--note "2026-03-14weeks"] [--week "2026-W14"]`
- 无参数：同步当前周
- `--note`：从笔记标题解析目标周
- `--week`：直接指定 ISO 周
- 写入 daily 小节时按任务有效日期分组：优先 `end_date`，未设置时使用 `done_at`
## 测试流程
1. `uv run --project vikunja/scripts vikunja/scripts/vikunja_tool.py list-projects`
2. `uv run --project vikunja/scripts vikunja/scripts/vikunja_tool.py list-tasks --done --limit 5`
3. `uv run --project vikunja/scripts vikunja/scripts/vikunja_tool.py sync-weekly`
GitHub에서 보기