Imported from HongJunseong/weather-risk-assessment (
AGENTS.md). Install upstream withnpx skills add HongJunseong/weather-risk-assessment. Copyright stays with the author.
ํ๋ก์ ํธ ์์ ์ง์นจ
- Python ๊ธฐ์ ๋ฐ์ดํฐ ํ์ดํ๋ผ์ธ์ด๋ค.
docs/architecture.md์์ ์ญํ ๊ณผ ๋ฐ์ดํฐ ํ๋ฆ์,docs/maintenance.md์์ ํ์ฌ ์ ์ฝ์ ํ์ธํ๋ค. dags/๋ ์์ ์์์ ์ค์ผ์ค,collectors/๋ ์์ง,risk/๋ ๊ณ์ฐ,jobs/๋ Spark ๋ณํ,scripts/๋ ๋ฐ์ดํฐ ์ค๋นยท๋ด๋ณด๋ด๊ธฐ๋ฅผ ๋ด๋นํ๋ค.- ๋ก์ปฌ ๋ฐ์ดํฐ ๊ฒฝ๋ก๋
weather_risk_assessment/paths.py๋ฅผ ์ฌ์ฉํ๋ค. ์์ค ํจํค์ง์ ๋ฐ์ดํฐ๋ฅผ ์ ์ฅํ๊ฑฐ๋sys.path๋ฅผ ์์ ํ์ง ์๋๋ค. ์ ํธ๋ฆฌํฐ๋ ์ ์ฅ์ ๋ฃจํธ์์python -m weather_risk_assessment.scripts.<๋ชจ๋>๋ก ์คํํ๋ค. - ์ํ๋ ๊ฐ์ค์น์ ์ข
ํฉ ๊ณต์์ ๊ธฐ์ค์
risk/config.py๋ค. ๊ณ์ฐ ๋ณ๊ฒฝ ์ ๊ฒฝ๊ณ๊ฐยท๊ฒฐ์ธก์นยท๊ธฐ์กด ๊ฒฐ๊ณผ์ ๋ฏธ์น๋ ์ํฅ์ ๊ฒ์ฆํ๋ค. - ์๋ณด ์๊ฐ๊ณผ ํํฐ์ ์ KST ๊ธฐ์ค์ด๋ค. ์๊ฐ๋๊ฐ ์๋ pandas ์๊ฐ๊ณผ ์๊ฐ๋๊ฐ ์๋ ์๊ฐ์ ํผํฉํ๋ ๋ณ๊ฒฝ์ ์ฃผ์ํด์ ๊ฒ์ฆํ๋ค.
- ์คํค๋งยทS3 ๊ฒฝ๋กยทAirflow task_idยท์ค์ผ์ค ๋ณ๊ฒฝ์ downstream ์ํฅ๊ณผ ์ด๋ ฅ ํธํ์ฑ์ ๊ฒํ ํ๊ณ ๋ฌธ์์ ๊ธฐ๋กํ๋ค.
.env์ ์ค์ ์์ง ๊ฒฐ๊ณผ๋ ์ปค๋ฐํ์ง ์๋๋ค. ํ๊ฒฝ๋ณ์ ์ถ๊ฐ ์.env.example๊ณผ ์คํ ๋ฌธ์๋ฅผ ๊ฐฑ์ ํ๋ค.- ์ธ๋ถ APIยทS3ยทSlack ์์ด ๊ฐ๋ฅํ ๊ฒ์ฆ๋ถํฐ ์ํํ๋ค. ๊ธฐ๋ณธ ๊ฒ์ฆ:
python3 -m unittest discover -s tests -v,python3 -m compileall -q weather_risk_assessment dags tests. - Docker ํ๊ฒฝ์ด ์์ผ๋ฉด
docker compose --env-file .env -f docker/docker-compose.yaml config --quiet๋ก ์ค์ ์ ํ์ธํ๋ค. ์ธ๋ถ ์๋น์ค๋ฅผ ์ฌ์ฉํ ์ค์ ์คํ ์ฌ๋ถ๋ ๊ฒ์ฆ ๊ฒฐ๊ณผ์ ๋ช ์ํ๋ค. - ํ๋์ ๊ฒํ ๊ฐ๋ฅํ ์์
์ด ์๋ฃ๋๊ณ ๊ด๋ จ ๊ฒ์ฆ์ด ํต๊ณผํ๋ฉด
.agents/skills/commit/SKILL.md์ ๋ฐ๋ผ ๋ก์ปฌ ์ปค๋ฐ์ ๋ง๋ ๋ค. ๋ณ๋ ์์ฒญ ์์ด push, merge, rebase, amend, tag ์์ฑ์ ํ์ง ์๋๋ค. - ๋ฐ๋ณต ์ ์ฐจ๊ฐ ํ์ธ๋ ๋ค ์คํฌ๋ก ๋ถ๋ฆฌํ๋ค. ์ผ๋ฐ ๊ฐ๋ฐ ์์์ ์ฅํฉํ๊ฒ ์ง์นจ์ ์ถ๊ฐํ์ง ์๋๋ค.