lint

위키 폴더 내의 깨진 위키링크, 규칙 미준수 Frontmatter, 인덱스 누락 등을 스캔하여 교정 및 최신화하는 도서관 정리 스킬입니다.

SKILL.md

GitHub

Lint (위키 무결성 점검 및 정리)

Overview

이 스킬은 시간이 지남에 따라 위키에 쌓이는 문서들이 정해진 운영 규칙과 아키텍처에 부합하는지 점검하는 '도서관 정리원' 역할을 수행합니다. 깨진 위키링크, 누락된 인덱스, 규격에 안 맞는 메타데이터 등을 탐색하여 자동으로 유지보수하고 위키의 무결성을 보존합니다.

Dependencies

없음

Quick Start

수석님이 /lint 또는 "위키 정리해줘", "깨진 링크 확인해줘"라고 요청하면 작동을 시작합니다.

Workflow

1. 위키 전체 무결성 정밀 스캔

  • wiki/ 폴더 내의 모든 마크다운 파일(*.md)을 스캔하여 다음 5가지 위반 사항이 있는지 검사합니다.
    • 깨진 위키링크 (Broken Wikilinks): [[존재하지않는문서]]와 같이 링크는 있으나 대상 마크다운 파일이 존재하지 않는 링크 탐색.
    • 인덱스 누락 및 초과: wiki/index.md에 링크가 등록되지 않은 고립된 문서(Orphan Page)가 있거나, 인덱스 항목이 단선 120자 제약을 초과하는지 검증.
    • YAML Frontmatter 미비: 필수 메타데이터 키(title, tags, created, updated, sources) 중 누락된 요소가 있는지 검사.
    • 최신화 날짜 불일치: 파일의 실제 최종 수정 내역과 Frontmatter의 updated 날짜의 싱크 검증.
    • 로그 누락: 위키 문서의 생성/수정 내역 중 wiki/log.md 테이블에 등재되지 않은 기록 탐색.

2. 검사 리포트 작성

  • 발견된 모든 오류 및 위반 항목들을 문제의 원인, 파일명, 추천 조치 사항과 함께 수석님께 표 형태로 깔끔하게 리포팅합니다.

3. 자동 교정 및 업데이트 실행

  • 수석님의 승인을 거친 뒤 (또는 즉각적인 교정 지시가 있을 경우) 위반 사항들을 순차적으로 치료합니다.
    • 고립된 문서는 index.md에 알맞은 요약과 함께 추가 등록합니다.
    • 깨진 링크는 올바른 대상 문서명으로 수정하거나, 빈 개념인 경우 필요한 뼈대 초안 페이지를 신설합니다.
    • YAML 규격이 맞지 않는 문서는 양식을 표준 포맷으로 교정합니다.

4. 로그 반영

  • 점검 및 교정 작업 완료 후, 발생한 모든 수정 내역을 wiki/log.md에 UPDATE 또는 CREATE 등의 오퍼레이션 코드로 추가 기록하여 추적성을 보장합니다.

Common Mistakes

  • 사용자 검증 없는 페이지 삭제: 깨진 링크를 연결하는 대신 원본 페이지나 링크를 임의로 일괄 삭제해 버리는 오류를 범해서는 안 됩니다.
  • 인덱스 글자수 초과 방치: 교정 과정에서 index.md에 긴 요약 문장을 그대로 적어 120자 단선 제약을 깨뜨리지 않도록 주의합니다.