From 6d7b120fabcda3c183a0cd5600b1ec50098189e5 Mon Sep 17 00:00:00 2001 From: Variet Date: Sun, 8 Mar 2026 08:16:03 +0900 Subject: [PATCH] fix: restore rigorous end.md + fill real Gitea/Vikunja tokens --- .agents/workflows/check-gitea.md | 8 ++--- .agents/workflows/end.md | 35 +++++++++++++++------ .agents/workflows/helpers/vikunja_helper.py | 8 ++--- .agents/workflows/helpers/wiki_helper.py | 10 +++--- .agents/workflows/services.md | 27 ++++++++-------- README.md | 14 +++------ 6 files changed, 56 insertions(+), 46 deletions(-) diff --git a/.agents/workflows/check-gitea.md b/.agents/workflows/check-gitea.md index f702ed7..18767f1 100644 --- a/.agents/workflows/check-gitea.md +++ b/.agents/workflows/check-gitea.md @@ -12,15 +12,15 @@ description: Gitea API로 저장소 커밋/이슈/PR 현황을 조회하는 워 1. 최근 커밋 조회 (최신 10개): ```powershell -$h = @{Authorization="token {{GITEA_TOKEN}}"} -$commits = Invoke-RestMethod -Uri "{{GITEA_BASE_URL}}/api/v1/repos/{{GITEA_OWNER}}/{{GITEA_REPO}}/commits?limit=10&sha=main" -Headers $h +$h = @{Authorization="token 3a01b4b15a39921572e64c413353e870d4d2161b"} +$commits = Invoke-RestMethod -Uri "https://git.variet.net/api/v1/repos/Variet/{{GITEA_REPO}}/commits?limit=10&sha=main" -Headers $h $commits | ForEach-Object { Write-Host "$($_.sha.Substring(0,7)) $($_.commit.message.Split("`n")[0])" } ``` 2. 열린 이슈 조회: ```powershell -$h = @{Authorization="token {{GITEA_TOKEN}}"} -$issues = Invoke-RestMethod -Uri "{{GITEA_BASE_URL}}/api/v1/repos/{{GITEA_OWNER}}/{{GITEA_REPO}}/issues?state=open&type=issues" -Headers $h +$h = @{Authorization="token 3a01b4b15a39921572e64c413353e870d4d2161b"} +$issues = Invoke-RestMethod -Uri "https://git.variet.net/api/v1/repos/Variet/{{GITEA_REPO}}/issues?state=open&type=issues" -Headers $h $issues | ForEach-Object { Write-Host "#$($_.number) $($_.title)" } ``` diff --git a/.agents/workflows/end.md b/.agents/workflows/end.md index 044f19b..0356eb7 100644 --- a/.agents/workflows/end.md +++ b/.agents/workflows/end.md @@ -30,30 +30,44 @@ description: 세션 종료 시 학습 기록 + Vikunja 동기화 + git commit ( ### 1-1. 커밋 전수 검사 -이번 세션의 모든 커밋을 확인하고 Vikunja에 매핑: +이번 세션의 **모든 커밋을 하나씩 검사**하고 Vikunja에 매핑합니다. +누락 없이 모든 커밋을 처리해야 합니다. ```powershell git log --oneline -20 ``` +각 커밋에 대해 아래 표를 기준으로 판단합니다: + | 커밋 유형 | Vikunja 액션 | |-----------|-------------| -| 기존 태스크 해당 작업 완료 | `python .agents\workflows\helpers\vikunja_helper.py done {ID}` | +| 기존 태스크 해당 작업 **완료** | `python .agents\workflows\helpers\vikunja_helper.py done {ID}` | | 신규 작업 완료 (기존 태스크 없음) | `python .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --done --labels Backend,Priority:High` | -| 작업 중 발견된 미완료 TODO | `python .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --labels Backend,Priority:Mid` | +| 작업 중 발견된 **미완료 TODO** | `python .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --labels Backend,Priority:Mid` | + +> [!IMPORTANT] +> - 커밋 1개 = Vikunja 액션 1개 이상 대응 +> - 여러 커밋이 같은 태스크에 해당하면 마지막 커밋에서 `done` 처리 +> - 매핑할 기존 태스크를 모르면 먼저 `list todo`로 조회 ### 1-2. Wiki 동기화 (해당 시에만) +코드 변경이 아키텍처에 영향을 주는 경우 Wiki를 업데이트합니다: + | 코드 변경 | 대상 Wiki | |-----------|----------| -| 서버 변경 | Architecture | -| 프론트엔드 변경 | Architecture | -| 새 모듈 추가 | Architecture | +| 서버 변경 (새 API, 모듈) | Architecture | +| 프론트엔드 변경 (새 컴포넌트) | Architecture | +| 인프라 변경 (Docker, CI/CD) | Architecture | +| 새 모듈/패키지 추가 | Architecture | ```powershell python .agents\workflows\helpers\wiki_helper.py update "Architecture" /tmp/wiki_content.md ``` +> [!TIP] +> Wiki 내용은 먼저 `read`로 기존 내용을 확인한 후, 수정된 전체 내용을 파일로 만들어 `update`합니다. + ## 2. Git Commit & Push ```powershell @@ -77,8 +91,11 @@ scope: (선택 — 모듈명 등) ## 3. 최종 체크리스트 -- [ ] known-issues 업데이트 완료 -- [ ] Vikunja 태스크 생성/완료 처리됨 -- [ ] Wiki 동기화됨 (해당 시) +> [!WARNING] +> 아래 항목 중 하나라도 누락되면 세션 종료를 완료할 수 없습니다. + +- [ ] known-issues 업데이트 완료 (새 이슈가 있었다면) +- [ ] Vikunja 태스크 생성/완료 처리됨 (커밋 전수 검사 기반) +- [ ] Wiki 동기화됨 (아키텍처 변경이 있었다면) - [ ] git push 완료 - [ ] 사용자에게 완료 보고 diff --git a/.agents/workflows/helpers/vikunja_helper.py b/.agents/workflows/helpers/vikunja_helper.py index 300aa63..26e2d10 100644 --- a/.agents/workflows/helpers/vikunja_helper.py +++ b/.agents/workflows/helpers/vikunja_helper.py @@ -25,11 +25,11 @@ if sys.stdout.encoding != "utf-8": sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8", errors="replace") # ============================================================ -# ⚙️ CONFIGURATION — Change these values for your project +# ⚙️ CONFIGURATION — PROJECT_ID만 프로젝트별로 변경하세요 # ============================================================ -API_BASE = "{{VIKUNJA_BASE_URL}}/api/v1" # e.g. "https://plan.variet.net/api/v1" -TOKEN = "{{VIKUNJA_TOKEN}}" # e.g. "tk_070f8e0b..." -PROJECT_ID = 0 # e.g. 9 +API_BASE = "https://plan.variet.net/api/v1" +TOKEN = "tk_070f8e0b715e818bb7178c3815ed5389040eddca" +PROJECT_ID = 0 # ← 프로젝트별 변경 필요 (e.g. 9) # ============================================================ HEADERS = { diff --git a/.agents/workflows/helpers/wiki_helper.py b/.agents/workflows/helpers/wiki_helper.py index 8e331b4..3d6e2f6 100644 --- a/.agents/workflows/helpers/wiki_helper.py +++ b/.agents/workflows/helpers/wiki_helper.py @@ -11,12 +11,12 @@ import sys, io, json, base64, urllib.request, urllib.error sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8') # ============================================================ -# ⚙️ CONFIGURATION — Change these values for your project +# ⚙️ CONFIGURATION — GITEA_REPO만 프로젝트별로 변경하세요 # ============================================================ -GITEA_BASE_URL = "{{GITEA_BASE_URL}}" # e.g. "https://git.variet.net" -GITEA_OWNER = "{{GITEA_OWNER}}" # e.g. "Variet" -GITEA_REPO = "{{GITEA_REPO}}" # e.g. "gravity_web" -GITEA_TOKEN = "{{GITEA_TOKEN}}" # e.g. "3a01b4b1..." +GITEA_BASE_URL = "https://git.variet.net" +GITEA_OWNER = "Variet" +GITEA_REPO = "{{GITEA_REPO}}" # ← 프로젝트별 변경 필요 +GITEA_TOKEN = "3a01b4b15a39921572e64c413353e870d4d2161b" # ============================================================ BASE = f"{GITEA_BASE_URL}/api/v1/repos/{GITEA_OWNER}/{GITEA_REPO}/wiki" diff --git a/.agents/workflows/services.md b/.agents/workflows/services.md index 384c176..48590ad 100644 --- a/.agents/workflows/services.md +++ b/.agents/workflows/services.md @@ -5,37 +5,35 @@ description: 프로젝트 연동 서비스 URL, API 키, 프로젝트 정보 참 # 서비스 연동 정보 > [!CAUTION] -> 이 파일에는 API 토큰이 포함되어 있습니다. `.gitignore`에 `.agents/` 추가를 검토하세요. +> 이 파일에는 API 토큰이 포함되어 있습니다. 프라이빗 레포에서만 사용하세요. ## 로컬 환경 | 항목 | 값 | |------|-----| | **Node.js** | 시스템 설치 (`node`, `npm`) | -| **Python (helper)** | `{{PYTHON_PATH}}` | -| **프로젝트 루트** | `{{PROJECT_ROOT}}` | +| **Python (helper)** | 시스템 설치 또는 conda 환경 | | **Shell** | PowerShell (`curl` = `Invoke-WebRequest` 별칭이므로 반드시 **`curl.exe`** 사용) | -| **서버 실행** | `{{SERVER_START_COMMAND}}` | ## Gitea (Git Repository) | 항목 | 값 | |------|-----| -| **Base URL** | `{{GITEA_BASE_URL}}` | -| **API Base** | `{{GITEA_BASE_URL}}/api/v1` | -| **Repo** | `{{GITEA_OWNER}}/{{GITEA_REPO}}` | -| **Token** | `{{GITEA_TOKEN}}` | -| **Auth Header** | `-H "Authorization: token {{GITEA_TOKEN}}"` | +| **Base URL** | `https://git.variet.net` | +| **API Base** | `https://git.variet.net/api/v1` | +| **Repo** | `Variet/{{GITEA_REPO}}` | +| **Token** | `3a01b4b15a39921572e64c413353e870d4d2161b` | +| **Auth Header** | `-H "Authorization: token 3a01b4b15a39921572e64c413353e870d4d2161b"` | ## Vikunja (Task Management) | 항목 | 값 | |------|-----| -| **Base URL** | `{{VIKUNJA_BASE_URL}}` | -| **API Base** | `{{VIKUNJA_BASE_URL}}/api/v1` | +| **Base URL** | `https://plan.variet.net` | +| **API Base** | `https://plan.variet.net/api/v1` | | **Project ID** | `{{VIKUNJA_PROJECT_ID}}` | -| **Token** | `{{VIKUNJA_TOKEN}}` | -| **Auth Header** | `-H "Authorization: Bearer {{VIKUNJA_TOKEN}}"` | +| **Token** | `tk_070f8e0b715e818bb7178c3815ed5389040eddca` | +| **Auth Header** | `-H "Authorization: Bearer tk_070f8e0b715e818bb7178c3815ed5389040eddca"` | ## Vikunja 태스크 조회 @@ -50,7 +48,8 @@ python .agents\workflows\helpers\vikunja_helper.py list todo | 서비스 | URL | 용도 | |--------|-----|------| -| {{SERVICE_NAME}} | {{SERVICE_URL}} | {{SERVICE_PURPOSE}} | +| Uptime Kuma | `https://status.variet.net` | 서비스 모니터링 | +| Authentik | `https://auth.variet.net` | SSO 인증 | ## AI 작업 프로토콜 diff --git a/README.md b/README.md index 71fb10e..56fbf9b 100644 --- a/README.md +++ b/README.md @@ -44,20 +44,14 @@ cp -r agent_guide/.agents/ your-project/.agents/ └── wiki_helper.py ← Gitea Wiki 래퍼 ``` -## 교체해야 하는 `{{PLACEHOLDER}}` 목록 +## 교체해야 하는 값 (프로젝트별) + +> Gitea/Vikunja 토큰은 이미 입력되어 있습니다. 프로젝트별로 아래 2개만 교체하면 됩니다. | Placeholder | 설명 | 파일 | |-------------|------|------| -| `{{GITEA_BASE_URL}}` | Gitea 서버 URL | services.md, check-gitea.md, wiki_helper.py | -| `{{GITEA_OWNER}}` | Gitea 소유자명 | services.md, check-gitea.md, wiki_helper.py | | `{{GITEA_REPO}}` | Gitea 저장소명 | services.md, check-gitea.md, wiki_helper.py | -| `{{GITEA_TOKEN}}` | Gitea API 토큰 | services.md, check-gitea.md, wiki_helper.py | -| `{{VIKUNJA_BASE_URL}}` | Vikunja 서버 URL | services.md, vikunja_helper.py | -| `{{VIKUNJA_TOKEN}}` | Vikunja API 토큰 | services.md, vikunja_helper.py | -| `{{VIKUNJA_PROJECT_ID}}` | Vikunja 프로젝트 ID | services.md, vikunja_helper.py | -| `{{PYTHON_PATH}}` | Python 실행 경로 | services.md | -| `{{PROJECT_ROOT}}` | 프로젝트 루트 경로 | services.md | -| `{{SERVER_START_COMMAND}}` | 서버 실행 명령어 | services.md | +| `{{VIKUNJA_PROJECT_ID}}` | Vikunja 프로젝트 ID | services.md, vikunja_helper.py (`PROJECT_ID`) | ## 상세 가이드