fix: .gitignore에서 .agent/ 트래킹 + 테스트 절대경로 제거 (이식성 보장)

This commit is contained in:
quantlab
2026-03-06 17:58:11 +09:00
parent b6ed432fe3
commit 5a931a5480
11 changed files with 425 additions and 7 deletions

View File

@@ -0,0 +1,50 @@
---
description: Vikunja API로 Variet Agent 프로젝트 태스크 현황을 조회하는 워크플로우
---
# Vikunja 태스크 현황 조회
서비스 정보는 `.agent/workflows/services.md` 참조.
// turbo-all
## 절차
1. 간편 조회 (TODO/DONE 리스트):
```powershell
C:\ProgramData\miniforge3\envs\quant\python.exe .agent\workflows\vikunja_helper.py list
```
2. TODO만 조회:
```powershell
C:\ProgramData\miniforge3\envs\quant\python.exe .agent\workflows\vikunja_helper.py list todo
```
3. DONE만 조회:
```powershell
C:\ProgramData\miniforge3\envs\quant\python.exe .agent\workflows\vikunja_helper.py list done
```
4. 태스크 완료 처리 (**⚠️ 반드시 이 방법 사용 — 직접 API 호출 금지**):
```powershell
C:\ProgramData\miniforge3\envs\quant\python.exe .agent\workflows\vikunja_helper.py done {TASK_ID}
```
여러 태스크 동시:
```powershell
C:\ProgramData\miniforge3\envs\quant\python.exe .agent\workflows\vikunja_helper.py done 71 77 78
```
5. 태스크 코멘트 추가:
```powershell
C:\ProgramData\miniforge3\envs\quant\python.exe .agent\workflows\vikunja_helper.py comment {TASK_ID} "내용"
```
6. 새 태스크 생성:
```powershell
C:\ProgramData\miniforge3\envs\quant\python.exe .agent\workflows\vikunja_helper.py create "제목" "설명"
```
> [!CAUTION]
> **절대로** `Invoke-RestMethod -Method Post -Body '{"done": true}'` 같은 직접 API 호출을 사용하지 마세요.
> Vikunja API는 POST 시 body에 포함되지 않은 필드를 빈값으로 덮어씁니다.
> `vikunja_helper.py`는 항상 GET → 기존 필드 보존 → POST 패턴을 사용하여 title/description 보존을 보장합니다.