chore: migrate .agent/ to .agents/ directory structure
This commit is contained in:
52
.agents/references/tech-stack.md
Normal file
52
.agents/references/tech-stack.md
Normal file
@@ -0,0 +1,52 @@
|
||||
# Tech Stack
|
||||
|
||||
> AI 에이전트는 구현 전 이 문서를 확인하여 올바른 기술/버전을 사용합니다.
|
||||
|
||||
## 언어 & 런타임
|
||||
|
||||
| 항목 | 버전 | 비고 |
|
||||
|------|------|------|
|
||||
| Python | 3.12 | `C:\ProgramData\miniforge3\envs\quant\python.exe` |
|
||||
|
||||
## 핵심 패키지
|
||||
|
||||
| 패키지 | 용도 | 비고 |
|
||||
|--------|------|------|
|
||||
| numpy | 행렬 연산, 수치 계산 | 전이행렬 곱, PD 계산 |
|
||||
| scipy | 최적화(WLS), 정규분포 | Zt 추정, Vasicek 임계값 |
|
||||
| pandas | 데이터프레임, 시계열 | 거시변수, API 응답 처리 |
|
||||
| statsmodels | OLS 회귀, 진단 검정 | Zt~거시 모형, ADF/LB/BP |
|
||||
| matplotlib | 차트 생성 | 한글 폰트: Malgun Gothic |
|
||||
| requests | HTTP 요청 | ECOS API 호출 |
|
||||
| tabulate | 표 출력 | 콘솔 결과 테이블 |
|
||||
| pyyaml | 설정 파일 | config.yaml 파싱 |
|
||||
|
||||
## 패키지 관리
|
||||
|
||||
- 패키지 매니저: conda (miniforge3) + pip
|
||||
- 환경: `quant` (`C:\ProgramData\miniforge3\envs\quant`)
|
||||
- 의존성 목록: `requirements.txt`
|
||||
- 설치: `pip install -r requirements.txt`
|
||||
|
||||
## 개발 도구
|
||||
|
||||
| 도구 | 명령어 |
|
||||
|------|--------|
|
||||
| 실행 (API 사용) | `C:\ProgramData\miniforge3\envs\quant\python.exe main.py` |
|
||||
| 실행 (Fallback) | `C:\ProgramData\miniforge3\envs\quant\python.exe main.py --no-api` |
|
||||
| Vikunja 조회 | `python .agents\workflows\helpers\vikunja_helper.py list` |
|
||||
| Wiki 업데이트 | `python .agents\workflows\helpers\wiki_helper.py update "페이지" /tmp/content.md` |
|
||||
|
||||
## 환경 변수
|
||||
|
||||
| 변수명 | 용도 | 설정 위치 |
|
||||
|--------|------|-----------|
|
||||
| ECOS API Key | 한은 Open API 인증 | `config.yaml` → `ecos.api_key` |
|
||||
|
||||
## 외부 API
|
||||
|
||||
| 서비스 | URL | 인증 |
|
||||
|--------|-----|------|
|
||||
| BOK ECOS | `https://ecos.bok.or.kr/api` | API Key in URL path |
|
||||
| Gitea | `https://git.variet.net` | Token in header |
|
||||
| Vikunja | `https://plan.variet.net` | Bearer token |
|
||||
Reference in New Issue
Block a user