kma-weather-forecast · diff
git:20260715.885aba7 to git:20260907.d9240bd
179 added, 0 removed. Audit A to A.
---
name: kma-weather-forecast
description: "기상 업무의 기상청 예보 조회 절차. 내부 disaster-geospatial-brief capability를 사용하며 read-only 경계를 지킵니다."
metadata:
kgov:
domain: "기상"
capability: disaster-geospatial-brief
+ runtime_contract: "kgov/disaster-geospatial-brief/v1"
+ operation: "kgov/disaster-geospatial-brief/query-village-forecast/v1"
role: primary
---
<!-- generated from catalog/domain-skills.json; do not edit -->
# 기상청 예보 조회
- Domain: **기상**
- 내부 capability: `disaster-geospatial-brief`
- 실행 상태: `fixture-verified` / live smoke `not-run`
- 실행 경계: `read-only`
- Reference Skill: `korea-weather`
+
+ ## Runtime binding
+
+ - Contract: `kgov/disaster-geospatial-brief/v1`
+ - Operation: `kgov/disaster-geospatial-brief/query-village-forecast/v1`
+ - Fixed input: `{"argv": ["--fixture"]}`
+ - Output fields: `manual_review_required`, `contract_id`, `execution_mode`, `status`, `count`, `records`, `source_receipt`
+
+ <!-- kgov-runtime-binding:start -->
+ ```json
+ {
+ "binding": {
+ "contract_id": "kgov/disaster-geospatial-brief/v1",
+ "fixed_input": {
+ "argv": [
+ "--fixture"
+ ]
+ },
+ "operation": "kgov/disaster-geospatial-brief/query-village-forecast/v1"
+ },
+ "example_result": {
+ "contract_id": "kgov/disaster-geospatial-brief/v1",
+ "count": 1,
+ "execution_mode": "synthetic-fixture",
+ "manual_review_required": true,
+ "records": [
+ {
+ "category": "TMP",
+ "forecast_date": "20260101",
+ "forecast_time": "1200",
+ "forecast_value": "3",
+ "grid_x": 60,
+ "grid_y": 127
+ }
+ ],
+ "source_receipt": {
+ "endpoint": "https://apis.data.go.kr/1360000/VilageFcstInfoService_2.0/getVilageFcst",
+ "operation_id": "kgov/disaster-geospatial-brief/query-village-forecast/v1",
+ "policy_id": "data-go-kr-village-forecast-api"
+ },
+ "status": "fixture-validated"
+ },
+ "exit_codes": {
+ "input_error": 2,
+ "policy_blocked": 3,
+ "review_blocked": 1,
+ "success": 0,
+ "upstream_error": 4
+ },
+ "fixture_argv": [
+ "--fixture"
+ ],
+ "input_schema": {
+ "additionalProperties": false,
+ "properties": {
+ "argv": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "argv"
+ ],
+ "type": "object"
+ },
+ "module": "kgov_runtime.capabilities.disaster_geospatial_brief",
+ "network_mode": "optional-live",
+ "output_schema": {
+ "additionalProperties": false,
+ "properties": {
+ "contract_id": {
+ "const": "kgov/disaster-geospatial-brief/v1",
+ "type": "string"
+ },
+ "count": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "execution_mode": {
+ "enum": [
+ "synthetic-fixture",
+ "official-live"
+ ],
+ "type": "string"
+ },
+ "manual_review_required": {
+ "const": true,
+ "type": "boolean"
+ },
+ "records": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "category": {
+ "type": "string"
+ },
+ "forecast_date": {
+ "type": "string"
+ },
+ "forecast_time": {
+ "type": "string"
+ },
+ "forecast_value": {
+ "type": "string"
+ },
+ "grid_x": {
+ "type": "integer"
+ },
+ "grid_y": {
+ "type": "integer"
+ }
+ },
+ "required": [
+ "category",
+ "forecast_date",
+ "forecast_time",
+ "forecast_value",
+ "grid_x",
+ "grid_y"
+ ],
+ "type": "object"
+ },
+ "maxItems": 100,
+ "type": "array"
+ },
+ "source_receipt": {
+ "additionalProperties": false,
+ "properties": {
+ "endpoint": {
+ "const": "https://apis.data.go.kr/1360000/VilageFcstInfoService_2.0/getVilageFcst",
+ "type": "string"
+ },
+ "operation_id": {
+ "const": "kgov/disaster-geospatial-brief/query-village-forecast/v1",
+ "type": "string"
+ },
+ "policy_id": {
+ "const": "data-go-kr-village-forecast-api",
+ "type": "string"
+ }
+ },
+ "required": [
+ "operation_id",
+ "policy_id",
+ "endpoint"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "enum": [
+ "fixture-validated",
+ "records-retrieved"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "manual_review_required",
+ "contract_id",
+ "execution_mode",
+ "status",
+ "count",
+ "records",
+ "source_receipt"
+ ],
+ "type": "object"
+ },
+ "schema_status": "active",
+ "source_output_mode": "projected-records",
+ "source_policy_ids": [
+ "data-go-kr-village-forecast-api"
+ ]
+ }
+ ```
+ <!-- kgov-runtime-binding:end -->
## 절차
1. 저장소 루트에서 `docs/capabilities/disaster-geospatial-brief/procedure.md`와 `docs/capabilities/disaster-geospatial-brief/runtime-contract.md`를 먼저 읽습니다.
2. `python3 -m kgov_runtime.capabilities.disaster_geospatial_brief --fixture`로 합성 fixture 계약을 검증합니다.
3. live 실행은 capability manifest의 credential·proxy·허용 host 경계를 충족할 때만 수행합니다.
4. 출동·대피·의료판단은 공식기관으로 전환
5. fixture 성공, URL 도달, live 검증을 서로 다른 증거로 보고합니다.
## 금지
- 이 Skill을 근거로 원본 변경·제출·결재·발송을 자동 수행하지 않습니다.
- 비밀값이나 원문 개인정보를 로그·결과·fixture에 남기지 않습니다.
- 내부 capability를 별도 top-level `skills/` 제품 표면으로 복제하지 않습니다.