feat: 공식 문서 근거자료, 브랜치 기능 문서 작성
This commit is contained in:
@@ -0,0 +1,41 @@
|
||||
---
|
||||
description: 기존 wiki 문서의 메타데이터/태그 보정 (retro cleanup 전용)
|
||||
argument-hint: <wiki 경로 또는 범위>
|
||||
---
|
||||
|
||||
기존 wiki 문서의 **메타데이터를 보정**합니다. 신규 변환은 `/ingest`를 사용하세요.
|
||||
|
||||
**대상:** $ARGUMENTS (지정 안 하면 `wiki/` 전체)
|
||||
|
||||
## 작업 절차
|
||||
|
||||
1. **대상 문서 수집**
|
||||
- 인자가 경로면 해당 문서들
|
||||
- 인자가 없으면 `wiki/` 전체 스캔
|
||||
|
||||
2. **frontmatter 검사 및 보정**
|
||||
- `title` 누락 → 본문 H1에서 추출
|
||||
- `source_type` 누락 또는 잘못된 값 → 본문/Sources 기반으로 재분류
|
||||
- `status` 누락 → `draft`로 기본 설정
|
||||
- `confidence` 누락 → `unknown`
|
||||
- `tags` 빈 배열 → 본문 키워드와 도메인(backend, db, infra 등)에서 추출
|
||||
- `related_projects` 빈 배열 → 본문/링크에서 프로젝트명 추출
|
||||
- `last_reviewed` 누락 → 오늘 날짜로
|
||||
|
||||
3. **태그 정규화**
|
||||
- 동의어 통일 (예: `db` / `database` → `db`)
|
||||
- 너무 일반적인 태그(`기타`, `미분류` 등) 제거
|
||||
- 도메인 태그 우선 (backend, db, infra, network, auth, ...)
|
||||
|
||||
4. **링크 일관성 검사**
|
||||
- 상대경로 링크가 있으면 `[[wikilink]]`로 변환
|
||||
- 깨진 wikilink 보고
|
||||
|
||||
5. **로그 기록**
|
||||
- `wiki/log.md`에 한 줄: `YYYY-MM-DD HH:mm /tag — <대상> → 변경 요약`
|
||||
|
||||
## 규칙
|
||||
|
||||
- **본문 내용은 건드리지 않는다.** frontmatter와 링크 형식만 조정.
|
||||
- 자동 분류가 애매하면 `status: needs-confirmation`으로 두고 사람 검토 요청.
|
||||
- 대량 처리 시에는 dry-run 결과를 먼저 보여주고 사용자 확인 후 적용.
|
||||
Reference in New Issue
Block a user