doc-classifier 스킬 (Windows)

<SKILL_DIR> = 이 SKILL.md 가 있는 폴더의 절대 경로. <DC> = python "<SKILL_DIR>\doc_classifier.py".
명령은 한 번만 실행하고 stdout 의 마지막 1줄 JSON 만 읽는다 (stderr 의 [PROGRESS] 는 무시).
다음 명령은 JSON 의 next_commands[n].command 를 그대로 복사해 실행한다. 명령을 직접 조립하지 않는다.

1. 순서

• <job> 은 scan 결과 JSON 의 job 값이다. 사용자가 이름을 주면 scan 에 --job <이름> 을 붙인다.
• 드라이브 전체는 오래 걸린다(수십 분~수 시간). complete: false 면 사용자에게 알리고, 계속하라고 하면 next_commands[0] 을 실행한다.
• 보고서: report.report_file(엑셀). 파일이 10만 개를 넘으면 전체 목록은 CSV(report.file_list_files)로 따로 저장된다.
  엑셀/CSV 내용을 직접 읽지 않는다. 경로만 알린다.

2. 분류 규칙 파일 만들기 (사용자가 분류 기준을 말했을 때)

사용자가 말한 종류마다 이름과 키워드를 넣어 UTF-8 JSON 파일로 저장한다 (예: <SKILL_DIR>\data\rules_<job>.json).

{
  "계약서": ["계약", "협약", "MOU"],
  "회의록": ["회의록", "회의자료"],
  "도면": [".dwg", ".dxf"]
}

• . 으로 시작하면 확장자, 아니면 파일명/폴더명에 들어 있는 글자. 띄어쓰기와 _ - 차이, 대소문자는 무시된다.
• 위에 적은 종류가 우선이다. 미분류 는 이름으로 쓸 수 없다. 키워드는 2글자 이상으로 쓴다.
• 규칙을 고친 뒤에는 classify 부터 다시 실행한다 (scan 은 다시 하지 않는다).

3. 사용자에게 보고할 것

• 파일 경로는 file:///D:/자료/보고서.xlsx 형식 링크로 쓴다. 이모지 금지.
• 규칙을 바꾸자고 제안만 하고, 사용자가 동의해야 규칙 파일을 고친다.

4. 결과 처리 규칙 (반드시 따른다)

• needs_input: true 인 명령에는 <...> 자리표시자가 있다. 사용자가 준 값으로 바꿔 실행하고, 값이 없으면 먼저 묻는다.
• 금지: 파일 이동/삭제/이름 바꾸기 제안을 실행하는 것(이 도구는 읽기 전용), 같은 명령 반복 실행, 모든 페이지를 끝까지 넘기는 것.