Skip to content

feat(franchise-fairdata-search): 공정위 FairData 가맹정보 조회 스킬 - #694

Closed
sungjunlee wants to merge 5 commits into
NomaDamas:mainfrom
sungjunlee:nightly/ds2-20260926-151044-290744
Closed

sungjunlee wants to merge 5 commits into
NomaDamas:mainfrom
sungjunlee:nightly/ds2-20260926-151044-290744

Conversation

@sungjunlee

Copy link
Copy Markdown

새 public API 스킬 franchise-fairdata-search 를 추가한다(이슈 #371).

추가

  • franchise-fairdata-search/skill.json, instruction.md, SKILL.md(생성 stub) — 이슈가 지정한 API, 기대 범위,
    인증키 발급 경로, 접근 경로 fallback 순서, 명시적 실패 모드.
  • franchise-fairdata-search/scripts/ — read-only 조회 헬퍼. 키는 소스·URL·로그에 남기지 않는다.
  • franchise-fairdata-search/tests/ — 네트워크 없이 fixture 로 파싱·정규화·실패 모드를 고정하는 테스트.

공정거래위원회 FairData 가맹사업 정보공개서·가맹점 통계 조회.

스킬 추가 절차 반영

docs/adding-a-skill.md 가 요구하는 생성·동기화를 함께 커밋했다.

node scripts/generate-skill-stubs.js
node scripts/migrate-cli-asset-instructions.js
node scripts/sync-cli-skills.js
node scripts/generate-plugin-manifest.js
  • docs/features/franchise-fairdata-search.md 추가 + README 표에 링크.
  • docs/runtime-action-audit.md 카탈로그에 해당 행과 mode/total 수치 갱신.
  • scripts/skill-docs.test.js 의 top-level 스킬 수 갱신.
  • .claude-plugin/plugin.json 과 packages/k-skill-cli/skills/** 동봉 복사본은 생성 결과 그대로.

검증

python3 -m pytest franchise-fairdata-search/tests -q                                      -> 38 passed passed
node scripts/generate-skill-stubs.js --check                            -> up to date
node scripts/migrate-cli-asset-instructions.js --check                  -> normalized
node scripts/sync-cli-skills.js --check                                 -> exact
node scripts/generate-plugin-manifest.js --check                        -> up to date
node --test scripts/skill-docs.test.js                                  -> 158/159

마지막 1건(toss-investment pack dry-run)은 이 변경과 무관한 기존 환경 의존 실패다
(npm pack 워크스페이스 상태 필요).

실제 API 호출·키 발급·프록시 배포는 하지 않았다.

Refs #371

- skill stub / CLI asset / plugin manifest 생성·sync 결과 반영
- docs/features/franchise-fairdata-search.md 추가 + README 표 링크
- docs/runtime-action-audit.md 카탈로그 행과 mode/total 수치 갱신
- scripts/skill-docs.test.js 의 top-level 스킬 수 갱신
- packages/k-skill-cli/skills/franchise-fairdata-search/** 를 scripts/sync-cli-skills.js 결과로 갱신
- 회귀 테스트 48 passed, 생성물 4종 --check OK
- _section: fetch_pages meta.complete=false 이면 section.status=partial + warnings[] (search_status 재사용)
- report: summary 항목에 partial/completeness_note, 리포트에 partial_sections[]/warnings[], 상단 result=partial
- stores/changes/sales: JSON warnings[] 와 --text stderr 경고 추가
- instruction.md 응답 계약 문서를 실제 동작과 맞춘다
- 회귀 테스트: 잘린 stores 조회 partial/stderr 경고, 잘린 report 섹션 표시 (51 passed)
@sungjunlee sungjunlee closed this Sep 26, 2026
@sungjunlee
sungjunlee deleted the nightly/ds2-20260926-151044-290744 branch September 26, 2026 16:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant