retaining-wall-rt-kci - SKILL.md Agent Skill

name: retaining-wall-rt-kci description: KCI 2022 기준 역T형 옹벽 설계 검토 워크플로우. 안정성 검토와 철근콘크리트 휨철근(2차 방정식 해) 포함.

역T형 옹벽 (KCI 2022)

이 스킬은 KCI 2022 기준으로 역T형 옹벽의 구조 검토가 필요할 때 사용합니다.

안정성 검토: 전도, 활동, 지지력
토우, 힐, 벽체의 RC 휨철근 산정(강도설계)
벽체 마찰 없음, 벽체 배터(기울기) 없음(수직 벽체)
수압 없음

빠른 시작

필수 입력값을 모두 요청합니다. 누락이 있으면 계산 전에 명확히 다시 요청합니다.
스크립트를 실행해 안정성과 필요 철근량을 계산합니다. 계산 과정이 모두 출력됩니다.
리포트 형식을 사용자에게 확인합니다(md 또는 doc).
사용자가 이미지 불필요라고 말하지 않는 한 항상 도식 이미지를 생성합니다(--draw).
doc 리포트를 선택한 경우 단면 그림이 리포트 파일에 삽입되도록 생성합니다.

필수 입력값

형상

H (m): 옹벽 높이
toe (m): 토우 길이
heel (m): 힐 길이
t_stem (m): 벽체 두께
t_base (m): 기초 슬래브 두께

토질 / 하중

gamma_s (kN/m^3): 토중량
phi (deg): 내부마찰각
q (kPa): 등분포 상재하중

재료 / 설계

gamma_c (kN/m^3): 콘크리트 단위중량
mu (-): 기초 마찰계수(또는 tan(delta))
qa_allow (kPa): 허용지지력
fck (MPa): 콘크리트 압축강도
fy (MPa): 철근 항복강도
phi_flex (-): KCI 2022 휨 강도저감계수
cover (mm): 유효깊이를 위한 피복두께
bar_dia (mm): 가정 철근 직경 기준 / 검토
fs_sliding_min (-): 활동 안전율 최소값(기본 1.5)
fs_overturning_min (-): 전도 안전율 최소값(기본 2.0)
require_no_tension (bool): 기초 저면 인장 불허(기본 true)

선택

include_passive (bool): 토우에서 수동저항 포함(기본 false)
gamma_p (kN/m^3): 수동토 단위중량(기본 = gamma_s)
kp (-): 수동토 계수 직접 입력 시 사용

가정

Rankine 주동토압(벽면 마찰 없음, 수직 벽체).
기초 폭 = toe + heel + t_stem.
벽체 및 기초는 등두께.
자중은 gamma_c 사용.
힐 상부 토사가 수직하중에 포함.

계산 개요

토압

Ka = tan(45 - phi/2)^2
Pa = 0.5 * Ka * gamma_s * H^2 + Ka * q * H
합력 위치: 삼각분포는 H/3, 상재하중 성분은 H/2.

안정성

활동: FS = (mu * N + Pp) / Pa
전도: FS = Mr / Mo (토우 기준)
지지력: 편심 e 계산 후 qmax = N/B * (1 + 6e/B) (qmax <= qa_allow 요구)

휨철근(강도설계)

단일철근 직사각형 단면을 가정하고 2차 방정식으로 As를 풉니다.

a = As*fy / (0.85*fck*b)
Mn = As*fy*(d - a/2)
phi_flex * Mn >= Mu As의 양의 해를 사용. 실근이 없으면 단면 증대 또는 실패 보고.

검토 단면:

벽체 하단(기초 고정 캔틸레버)
힐 슬래브(벽체에서 캔틸레버)
토우 슬래브(벽체에서 캔틸레버)

스크립트

실행:

python scripts/retaining_wall.py --input input.json --out results.json --report report.md --report-format md --draw out.png
python scripts/retaining_wall.py --input input.json --out results.json --report report.doc --report-format doc --draw out.png

스크립트는 표준출력으로 전체 계산 리포트를 출력하고, 요약+단계 정보를 JSON으로 출력합니다. --report-format md는 단위와 기준을 포함한 Markdown 리포트를 작성합니다. --report-format doc는 MS Word에서 열 수 있는 .doc(RTF 기반) 리포트를 작성합니다. doc를 선택하면 단면 그림이 리포트에 삽입됩니다. --draw를 주지 않아도 리포트용 단면 그림을 자동 생성해 삽입합니다. --draw는 항상 PNG 도식을 생성합니다.

사용자가 이미지를 원한다면 항상 --draw를 사용해 PNG 도식을 출력합니다.

확인 질문이 필요한 경우

필수 입력값이 누락된 경우
활동/전도 안전율 기준을 사용자가 별도로 요구하는 경우
수동저항 포함 여부
KCI 계수 등이 누락된 경우