한국 건축구조기준(KDS) 75개 문서를 검색하고 구조계산을 수행하며, 설계 워크플로우를 제공합니다. 내진설계, 콘크리트/강구조, 기초, 하중, 가설구조 등 모든 KDS 기준을 지원하며, 공식 추출, 이미지 분석, 용어 설명, 기준 비교를 제공합니다. 모든 문서와 이미지 설명이 스킬에 포함되어 있어 독립적으로 사용 가능합니다.
Use this skill when users ask questions about Korean building codes, structural design calculations, seismic design, concrete/steel structures, foundations, loads, or any KDS (Korean Design Standards) related queries in Korean or English.
Korean: KDS, 건축구조기준, 건축구조, 내진설계, 지진, 밑면전단력, 콘크리트, 강구조, 철골, 철근, 하중, 풍하중, 적설하중, 기초, 지반, 옹벽, 허용응력, LRFD, ASD, 설계기준, 구조설계, 휨강도, 전단강도, 보, 기둥, 슬래브, 벽체, 가새골조, 모멘트골조, 가설구조, 거푸집, 동바리
English: KDS, Korean Design Standard, Korean building code, seismic design, earthquake, base shear, concrete structure, steel structure, foundation design, retaining wall, allowable stress design, load resistance factor design, structural code, wind load, snow load, seismic load, live load, dead load, flexural strength, shear strength, column design, beam design
All 75 KDS documents and 206 image descriptions are bundled in this skill at data/kds-documents/ and data/image-descriptions/.
Level 1: Metadata Lookup (Fastest - 0.1s)
scripts/kds_mapper.py for instant Korean↔English mappingLevel 2: Reference Files (Medium - 0.5s)
references/glossary.md - Korean-English terminology (100+ terms)references/workflows.md - 8 query type workflows, design proceduresreferences/kds-metadata.json - Complete metadata (130 KB)Level 3: Full Document Search (Detailed - 2-5s)
data/kds-documents/*.mddata/image-descriptions/User Intent: Find specific equation from KDS
Example Queries:
Quick Process:
kds_mapper.py to identify documentkey_formulas for line numbersOutput Format:
📐 공식: V = CₛW
📍 출처: KDS 41 17 00 Section 6.2.1, Line 850-880
변수 정의:
V = 밑면전단력 (kN)
Cₛ = 지진응답계수 (무차원)
W = 유효지진중량 (kN)
User Intent: Perform actual structural calculations
Example Queries:
Quick Process:
KDS-Specific Checks:
User Intent: View technical diagrams/charts
Example Queries:
Quick Process:
kds_mapper.py to identify documentimages listscripts/image_linker.py KDS_XX_YY_ZZ --image NExample:
🖼️ Image 26: 지붕 경사각에 따른 풍력계수
📍 KDS 41 12 00, Section 5.4.3
[ASCII art diagram showing wind pressure coefficients vs roof slope]
User Intent: Understand Korean/English technical terms
Example Queries:
Quick Process:
references/glossary.mdUser Intent: Compare KDS with international codes or different methods
Example Queries:
Quick Process:
KDS vs International Codes:
User Intent: Find related KDS documents
Example Queries:
Quick Process:
kds_mapper.py to lookup documentrelated_standardsSee references/workflows.md for detailed procedures.
| Category | Korean | Key Documents | Common Keywords |
|---|---|---|---|
| Loads | 하중 | KDS_41_12_00 | 풍하중, 적설하중, 지진하중, wind, snow |
| Seismic | 내진 | KDS_41_17_00, 17_10_00 | 지진, 밑면전단력, base shear, response spectrum |
| Concrete | 콘크리트 | KDS_41_20_00, 14_20_** | 철근, 휨강도, flexural, shear, rebar |
| Steel | 강구조 | KDS_41_30_10, 14_31_** | LRFD, ASD, 좌굴, buckling |
| Foundation | 기초 | KDS_41_19_00, 11_50_** | 지반, 지지력, bearing capacity |
| Temporary | 가설 | KDS_21_** | 거푸집, 동바리, formwork, shoring |
| Wood | 목구조 | KDS_41_50_** | 목재, timber, wood |
| Masonry | 조적 | KDS_41_60_** | 벽돌, block, brick |
| Composite | 합성 | KDS_41_40_**, 14_31_80 | 강-콘크리트, steel-concrete |
| Aluminum/Glass | 알루미늄/유리 | KDS_41_80_** | aluminum, glass |
| User Query | Category | Primary KDS | Script Command |
|---|---|---|---|
| "풍하중 계산" | Loads | 41_12_00 | kds_mapper.py 풍하중 |
| "seismic design" | Seismic | 41_17_00 | kds_mapper.py seismic |
| "콘크리트 보" | Concrete | 14_20_20 | kds_mapper.py "콘크리트 휨" |
| "steel column" | Steel | 14_31_10 | kds_mapper.py "강구조 압축" |
| "41-12-00" | Direct | 41_12_00 | kds_mapper.py 41-12-00 |
Format: KDS_XX_YY_ZZ_제목_버전.md
Examples:
KDS_41_12_00 = Building (41) > Loads (12) > General (00)KDS_14_20_80 = Materials (14) > Concrete (20) > Seismic (80)KDS_41_17_00 = Building (41) > Seismic (17) > General (00)Execute from scripts/ directory:
Purpose: Unified Korean/English/KDS ID search with metadata lookup
Usage:
# Korean search
python3 kds_mapper.py "내진설계"
# English search
python3 kds_mapper.py "seismic design"
# KDS ID search
python3 kds_mapper.py "41-17-00"
# Statistics
python3 kds_mapper.py --stats
Returns: Document info, filename, category, formulas, images
Purpose: Extract formulas with context from KDS documents
Usage:
# Find specific formula pattern
python3 formula_finder.py "V =" KDS_41_17_00
# Search by line range
python3 formula_finder.py --line-range 850-900 KDS_41_17_00
Purpose: Find and display image descriptions
Usage:
# List all images for a document
python3 image_linker.py KDS_41_12_00
# View specific image
python3 image_linker.py KDS_41_12_00 --image 26 --read
# Search in descriptions
python3 image_linker.py KDS_41_12_00 --search "풍력계수"
Every response should include:
vs. International Codes (IBC/ASCE 7):
Key Documents:
KDS 41 12 00 Standard Combinations:
Concrete (fck in MPa):
Steel (Fy in MPa):
206 Technical Diagrams with ASCII art descriptions:
data/image-descriptions/KDS_XX_YY_ZZ_imageNN_description.mdMost Common Images:
Version Tracking:
_22.10.md = October 2022)Superseded Standards:
Use kds_mapper.py first (0.1 sec response)
Check metadata before full search
Target specific documents - don't grep all 75 files
Use line ranges when reading
Always execute scripts from skill's scripts directory:
cd .claude/skills/kds-building-standards/scripts
python3 kds_mapper.py <query>
Ambiguous query:
Missing parameters for calculation:
No results found:
Version confusion:
For all structural calculations:
Search by Korean keyword:
User: "내진설계 밑면전단력 공식 알려줘"
Assistant: [Executes kds_mapper.py "밑면전단력"] → KDS 41 17 00
[Reads formula at line 850] → V = CₛW
[Provides variables + citation]
Search by English keyword:
User: "Show me steel column design formula"
Assistant: [Executes kds_mapper.py "steel column"] → KDS 14 31 10
[Extracts compression formulas]
Direct KDS ID access:
User: "41-12-00 풍하중 계산 방법"
Assistant: [Executes kds_mapper.py "41-12-00"] → KDS_41_12_00
[Searches "풍하중" in document]
Total Resources in This Skill:
Skill is fully self-contained and ready for distribution.
Always prioritize accuracy, cite KDS sources with versions, validate calculations against KDS limits, and provide bilingual Korean-English support.