traffic-safety-statistics-brief git:20260907.d9240bdA

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

---
name: traffic-safety-statistics-brief
description: "국토교통 업무의 교통안전 통계 근거 브리프 절차. 내부 kosis-official-statistics capability를 사용하며 draft-only 경계를 지킵니다."
metadata:
  kgov:
    domain: "국토교통"
    capability: kosis-official-statistics
    runtime_contract: "kgov/kosis-official-statistics/v1"
    operation: "kgov/kosis-official-statistics/query-statistics/v1"
    role: additional
---

<!-- generated from catalog/domain-skills.json; do not edit -->

# 교통안전 통계 근거 브리프

- Domain: **국토교통**
- 내부 capability: `kosis-official-statistics`
- 실행 상태: `fixture-verified` / live smoke `not-run`
- 실행 경계: `draft-only`
- Reference Skill: 없음

## Runtime binding

- Contract: `kgov/kosis-official-statistics/v1`
- Operation: `kgov/kosis-official-statistics/query-statistics/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/kosis-official-statistics/v1",
    "fixed_input": {
      "argv": [
        "--fixture"
      ]
    },
    "operation": "kgov/kosis-official-statistics/query-statistics/v1"
  },
  "example_result": {
    "contract_id": "kgov/kosis-official-statistics/v1",
    "count": 1,
    "execution_mode": "synthetic-fixture",
    "manual_review_required": true,
    "records": [
      {
        "category": "전국",
        "item": "인구",
        "period": "2025",
        "table_name": "합성 인구 통계",
        "value": "100"
      }
    ],
    "source_receipt": {
      "endpoint": "https://kosis.kr/openapi/Param/statisticsParameterData.do",
      "operation_id": "kgov/kosis-official-statistics/query-statistics/v1",
      "policy_id": "kosis-statistics-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.kosis_official_statistics",
  "network_mode": "optional-live",
  "output_schema": {
    "additionalProperties": false,
    "properties": {
      "contract_id": {
        "const": "kgov/kosis-official-statistics/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"
            },
            "item": {
              "type": "string"
            },
            "period": {
              "type": "string"
            },
            "table_name": {
              "type": "string"
            },
            "value": {
              "type": "string"
            }
          },
          "required": [
            "table_name",
            "period",
            "category",
            "item",
            "value"
          ],
          "type": "object"
        },
        "maxItems": 100,
        "type": "array"
      },
      "source_receipt": {
        "additionalProperties": false,
        "properties": {
          "endpoint": {
            "const": "https://kosis.kr/openapi/Param/statisticsParameterData.do",
            "type": "string"
          },
          "operation_id": {
            "const": "kgov/kosis-official-statistics/query-statistics/v1",
            "type": "string"
          },
          "policy_id": {
            "const": "kosis-statistics-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": [
    "kosis-statistics-api"
  ]
}
```
<!-- kgov-runtime-binding:end -->

## 업무별 추가 체크

- 기준기간·지역·도로유형·사고유형·지표·분모·단위를 분리
- KOSIS 통계표 코드·작성기관·조회일·통계 기준·개정 상태를 보존
- 위험도 순위·단속·시설 개선 우선순위는 교통안전 담당기관 검토로 이관

## 절차

1. 저장소 루트에서 `docs/capabilities/kosis-official-statistics/procedure.md`와 `docs/capabilities/kosis-official-statistics/runtime-contract.md`를 먼저 읽습니다.
2. `python3 -m kgov_runtime.capabilities.kosis_official_statistics --fixture`로 합성 fixture 계약을 검증합니다.
3. live 실행은 capability manifest의 credential·proxy·허용 host 경계를 충족할 때만 수행합니다.
4. 통계 해석·정책 판단은 수동 검토
5. fixture 성공, URL 도달, live 검증을 서로 다른 증거로 보고합니다.

## 금지

- 이 Skill을 근거로 원본 변경·제출·결재·발송을 자동 수행하지 않습니다.
- 비밀값이나 원문 개인정보를 로그·결과·fixture에 남기지 않습니다.
- 내부 capability를 별도 top-level `skills/` 제품 표면으로 복제하지 않습니다.