kma-weather-forecast git:20260907.d9240bdA

Immutable. This exact content never changes and is served at /api/v1/blob/fe9bcc8530c4125c.

---
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/` 제품 표면으로 복제하지 않습니다.