template은(는) 무엇을 하나요?
재현 가능한 계산 연구를 위한 프로덕션 등급 스캐폴드 — 10단계 DAG 파이프라인, ≥90% 테스트 커버리지, 암호화 증명(SHA-256 + 스테가노그래피 PDF 워터마킹), 멀티 프로젝트 워크스페이스, AI 에이전트 지원(AGENTS.md / SKILL.md 포함).
주요 기능
- 10단계 DAG 파이프라인: 각 단계가 명확히 정의된 방향성 비순환 그래프로 작업을 자동화합니다.
- ≥90% 테스트 커버리지: pytest를 사용하여 코드 품질과 안정성을 보장합니다.
- 암호화 증명: SHA-256 해싱과 PDF 스테가노그래피 워터마킹으로 결과의 무결성과 출처를 증명합니다.
- 멀티 프로젝트 워크스페이스: 여러 프로젝트를 단일 워크스페이스에서 관리할 수 있습니다.
- AI 에이전트 지원:
AGENTS.md와SKILL.md파일을 통해 AI 어시스턴트가 프로젝트를 이해하고 작업할 수 있도록 합니다.
사용 방법
-
프로젝트 초기화: 이 템플릿을 복제하여 새 프로젝트를 시작합니다.
git clone <repository-url> my-research-project cd my-research-project -
의존성 설치: 프로젝트에 필요한 패키지를 설치합니다.
pip install -r requirements.txt -
파이프라인 실행: DAG 파이프라인을 실행합니다.
python pipeline.py -
테스트 실행: 테스트를 실행하여 코드를 검증합니다.
pytest --cov=src --cov-report=term-missing --cov-fail-under=90 -
증명 생성: 암호화 증명을 생성합니다.
python generate_proof.py
환경 변수
PROJECT_ROOT: 프로젝트 루트 디렉토리 경로OUTPUT_DIR: 출력 파일 저장 디렉토리LOG_LEVEL: 로깅 수준 (DEBUG, INFO, WARNING, ERROR)
구조
project_root/
├── src/ # 소스 코드
│ ├── pipeline/ # DAG 파이프라인 구현
│ ├── proof/ # 암호화 증명 관련 모듈
│ └── utils/ # 유틸리티 함수
├── tests/ # 테스트 코드
├── outputs/ # 파이프라인 출력물
├── notebooks/ # Jupyter 노트북
├── AGENTS.md # AI 에이전트 설정
├── SKILL.md # 이 스킬 문서
└── README.md # 프로젝트 개요
AI 에이전트 연동
이 프로젝트는 AI 에이전트와의 협업을 염두에 두고 설계되었습니다. AGENTS.md 파일에는 에이전트가 프로젝트의 컨텍스트를 이해하고 적절히 작업할 수 있도록 하는 지침이 포함되어 있습니다. SKILL.md는 이 문서로, 스킬의 상세 사항을 제공합니다.
기여
기여를 환영합니다. 버그 리포트, 기능 제안, 풀 리퀘스트 등 모든 형태의 기여를 검토합니다.
라이선스
이 프로젝트는 MIT 라이선스 하에 배포됩니다.