k-skill/docs/features
Jeffrey (Dongkyu) Kim 8b36634e28 Stop guessing districts and require exact station retries for ambiguous fine-dust lookups
The fine-dust proxy now resolves natural-language region hints through
city-level station lists and only returns a report when a single station
can be justified. When the hint is ambiguous, the proxy returns a small
candidate list so callers can retry with an exact station name instead
of silently guessing.

The skill guidance was updated to match that runtime contract: region
hint first, then retry with stationName when candidate_stations are
returned. Coordinate-centric guidance was removed from the primary skill
surface so the default path stays lightweight and consistent with the
live proxy behavior.

Constraint: The current AirKorea key can access city-level and station-level measurement APIs but station-info lookups may still return 403
Constraint: Free-API proxy responses must stay safe to expose publicly, so ambiguous locations should not be auto-guessed
Rejected: Auto-pick the first city-level station for unmatched district hints | hides ambiguity and returns misleading air-quality data
Rejected: Keep coordinate-first language in the primary skill | no coordinate source exists in the default user flow
Confidence: high
Scope-risk: moderate
Reversibility: clean
Directive: Preserve the ambiguous_location contract; if you improve matching later, prefer evidence-backed narrowing over silent fallback guesses
Tested: node --test scripts/skill-docs.test.js; npm run test --workspace k-skill-proxy; python3 -m unittest discover -s scripts -p test_fine_dust.py; live curl for ambiguous regionHint=광주 광산구 and exact stationName=우산동(광주)
Not-tested: Broader region alias quality outside the manually checked examples
2026-03-28 23:28:12 +09:00
..
blue-ribbon-nearby.md Restore advertised landmark routing for Blue Ribbon nearby searches 2026-03-27 19:15:21 +09:00
daiso-product-search.md Keep Daiso online-stock lookups aligned with live product ids 2026-03-27 19:31:24 +09:00
delivery-tracking.md Document the verified public tracking outputs explicitly 2026-03-27 02:44:48 +09:00
fine-dust-location.md Stop guessing districts and require exact station retries for ambiguous fine-dust lookups 2026-03-28 23:28:12 +09:00
hwp.md Clarify HWP markdown verification in the feature guide 2026-03-26 12:34:34 +09:00
k-skill-proxy.md Make the fine-dust proxy easier to consume than the upstream APIs 2026-03-28 17:14:18 +09:00
kakaotalk-mac.md Document safe macOS KakaoTalk skill usage 2026-03-26 23:12:42 +09:00
kbo-results.md Prepare k-skill for packaged releases and broader skill discovery 2026-03-25 23:57:53 +09:00
ktx-booking.md Keep PR #19 CI stable without user Python site-packages 2026-03-27 22:51:33 +09:00
lotto-results.md Prepare k-skill for packaged releases and broader skill discovery 2026-03-25 23:57:53 +09:00
seoul-subway-arrival.md Prepare k-skill for packaged releases and broader skill discovery 2026-03-25 23:57:53 +09:00
srt-booking.md Prepare k-skill for packaged releases and broader skill discovery 2026-03-25 23:57:53 +09:00
zipcode-search.md Harden postcode lookup guidance for flaky shell/runtime conditions 2026-03-26 23:58:01 +09:00