菜单
새 검증을 어느 layer (Jenkins Stage 1 / precheck 1-4 / Stage 3 / adapter capabilities)에 배치할지 분류 (rule 27 R5). 사용자가 "이 검증 어디에 넣지?", "precheck 단계 분류", "validation layer" 등 요청 시. - 새 입력 검증 / 새 graceful degradation 단계 / Validator 작성 / "어느 단계에서 막을까?" 같은 질의 (server-exporter는 호출자/Stage1)
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
schema/sections.yml + schema/field_dictionary.yml + schema/baseline_v1/ 3종 정합 갱신 (rule 13 R1). schema 변경 후 호출. 사용자가 "schema 정합 갱신", "field dictionary 동기화", "ERD 갱신" (server-exporter 어휘로는 schema doc) 등 요청 시 또는 schema 5개 이상 누적 변경 시 자동. - schema/sections.yml or field_dictionary.yml 수정 후 / 새 섹션 / 새 필드 / Round 검증 후 baseline 변경
구조화된 server-exporter 기능 명세서 작성. 사용자가 "명세서 써줘", "스펙 정리" 등 요청 시. - 구조화된 spec 필요 / PR 본문 / 문서화
server-exporter에 새 벤더(예: Huawei iBMC, Inspur, Ampere)를 3단계로 추가하는 절차 안내. vendor_aliases.yml + adapters/{channel}/{vendor}_*.yml + (선택) OEM tasks + vault + baseline + ai-context + docs 동시 갱신. 사용자가 "Huawei vendor 추가", "새 벤더 추가", "Huawei 지원하자" 등 요청 시 자동 호출. - 새 vendor가 호출자 시스템에서 요청됨 / 펌웨어 프로파일링 후 정식 지원 / 기존 generic fallback 한계 시
사용자 사이트 사고 환경 (HPE Gen12 / Lenovo XCC3 / Dell iDRAC8 / Cisco CIMC 등) 의 fixture를 캡처해 회귀 회피. cycle 2026-05-01 학습 — 사이트 사고 fixture 부재로 다음 reverse regression 위험. 사이트 envelope / probe 결과 / 펌웨어 응답을 tests/fixtures/redfish/{vendor}_{firmware}/ 에 저장 + tests/evidence/<날짜>-<vendor>.md 작성. 사용자가 "사이트 fixture 캡처", "사고 재현 입력 저장" 요청 시.
lab 부재 vendor 추가 (web sources 의무). cycle 2026-05-06 학습 — 4 신규 vendor (Huawei/Inspur/Fujitsu/Quanta) + Superdome Flex 의 lab 부재 web sources 패턴 라이브러리화. 사용자가 "Huawei iBMC 추가", "lab 없는 vendor 어떻게?", "vendor 추가" 등 요청 시 + lab 부재 명시 시. - rule 50 R2 9단계 + rule 96 R1-A web sources 의무 + vault SKIP 사용자 명시 승인
다중 worker cycle 자동화 (Phase 0 ticket 작성 → Phase 1 분석 → Phase 2 결정 → Phase 3 구현 → Phase 4 회귀 → Phase 5 종료). cycle 2026-05-06 학습 — 24 ticket × 5 worker 패턴 라이브러리화. 사용자가 "cycle 시작", "사용자 N 작업 묶음 ticket 으로 분해해줘", "cycle 자동화" 등 요청 시. - 3 항목 이상 작업 묶음 / 다중 worker 동시 진행 / 호환성 / 큰 리팩토링
| name | classify-precheck-layer |
| description | 새 검증을 어느 layer (Jenkins Stage 1 / precheck 1-4 / Stage 3 / adapter capabilities)에 배치할지 분류 (rule 27 R5). 사용자가 "이 검증 어디에 넣지?", "precheck 단계 분류", "validation layer" 등 요청 시. - 새 입력 검증 / 새 graceful degradation 단계 / Validator 작성 / "어느 단계에서 막을까?" 같은 질의 (server-exporter는 호출자/Stage1) |
server-exporter의 검증 / 차단 logic을 적절한 layer에 배치. 너무 늦으면 시간 낭비, 너무 이르면 graceful degradation 무력화.
| Layer | 위치 | 검증 종류 |
|---|---|---|
| 1. Jenkins Stage 1 (Validate) | Jenkinsfile | 입력 형식 (JSON 파싱 / IP 형식 / target_type 값) |
| 2a. precheck ping | precheck_bundle.py | 호스트 도달성 (ICMP / TCP SYN) |
| 2b. precheck port | precheck_bundle.py | target_type별 port 응답 (SSH 22 / WinRM 5985-5986 / vSphere 443 / Redfish 443) |
| 2c. precheck protocol | precheck_bundle.py | TCP 응답 + 첫 응답 형식 |
| 2d. precheck auth | precheck_bundle.py | 자격증명 인증 |
| 3. adapter capabilities | adapters/{channel}/{vendor}_*.yml | vendor-specific 비즈니스 규칙 (예: "이 펌웨어는 Volumes endpoint 미지원") |
| 4. gather 중 graceful degradation | gather_*.yml | 일부 endpoint 실패 → 가능한 데이터만 + errors 기록 |
| 5. Jenkins Stage 3 (Validate Schema) | Jenkinsfile + output_schema_drift_check | envelope 6 필드 / field_dictionary 정합 |
| 6. Jenkins Stage 4 (E2E Regression) | Jenkinsfile + pytest | baseline 회귀 |
| Q | 답 | layer |
|---|---|---|
| Q1: 외부 시스템 호출 없이 판정 가능? | YES → 입력 형식 / payload 검증 | Stage 1 |
| NO → 외부 의존 | precheck (2a-2d) | |
| Q2: vendor 자동 감지 후에야 적용 가능? | YES → vendor 결정 후 | adapter capabilities (3) |
| NO → vendor agnostic | precheck 또는 gather (2/4) | |
| Q3: 출력 envelope 형식 검증? | YES | Stage 3 (5) |
| NO → 데이터 무결성 | Stage 4 baseline (6) |
## 검증 layer 분류 — <검증 항목>
### Q1-Q3 답
- Q1: NO (외부 의존)
- Q2: YES (vendor 자동 감지 후만 적용)
- Q3: NO
### 권장 layer: 3 (adapter capabilities)
### 이유
- 펌웨어 5.x 미만은 Volumes endpoint 미지원 — vendor + 펌웨어 결정 후 분기 가능
- adapter dell_idrac9.yml의 capabilities에 `volumes_endpoint: ">=5.0"` 추가
### 대안 (기각)
- precheck protocol에 추가 → vendor 모르고 분기 불가
- gather 중 try/except → silent degradation 위험 (rule 95 R1 #8)
debug-precheck-failure, task-impact-previewprecheck-engineerdocs/11_precheck-module.md