git:20260907.d9240bd to git:20260908.16b104c
11 added, 11 removed. Audit A to A.
---
name: industrial-accident-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
+ 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 검증을 서로 다른 증거로 보고합니다.
+ 1. 전체 저장소 checkout이 필요합니다. Skill 디렉터리만 복사해서 실행하지 않습니다. 클라이언트와 모든 명령은 `kgov_runtime/`, `docs/`, `tests/`가 있는 저장소 루트에서 실행하고, 루트 기준 `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. 제공된 로컬 입력은 procedure의 실제 입력 절차와 제한에 따라 별도로 검사합니다. 파일이 없거나 읽을 수 없으면 차단 상태를 보고하고 fixture로 대신 검증했다고 주장하지 않습니다.
+ 4. live 실행은 capability manifest의 credential·proxy·허용 host 경계를 충족할 때만 수행합니다.
+ 5. 통계 해석·정책 판단은 수동 검토
+ 6. fixture 성공, 로컬 입력 검사, URL 도달, live 검증을 서로 다른 증거로 보고합니다.
## 금지
- 이 Skill을 근거로 원본 변경·제출·결재·발송을 자동 수행하지 않습니다.
- 비밀값이나 원문 개인정보를 로그·결과·fixture에 남기지 않습니다.
- 내부 capability를 별도 top-level `skills/` 제품 표면으로 복제하지 않습니다.