obsidian-review

name	obsidian-review
description	Obsidian 플러그인 심사 리뷰 봇(eslint-plugin-obsidianmd)과 동일한 규칙으로 코드를 로컬 스캔하여 Required 이슈를 사전에 발견하고 수정합니다. 플러그인 심사 대응, ESLint 검사, sentence-case 수정 시 사용합니다.
argument-hint	[fix|setup|check]
disable-model-invocation	true
allowed-tools	["Bash(npx:*)","Bash(npm install:*)","Bash(npm run build:*)","Bash(git checkout:*)","Read","Edit","Write","Glob","Grep"]

Obsidian 플러그인 심사 봇 로컬 검증

인자: $ARGUMENTS

• 인자 없음: 전체 스캔 + 이슈 리포트만 출력
• fix: 전체 스캔 + 발견된 Required 이슈 자동 수정
• setup: ESLint 환경 세팅만 수행
• check: 환경이 준비되었는지만 확인

이슈 유형별 상세 해결법은 obsidian-plugin-review-guide.md를 참조한다.

1단계: 환경 확인

다음 3가지를 확인한다:

1. node_modules/eslint-plugin-obsidianmd 디렉토리 존재 여부
2. node_modules/eslint 디렉토리 존재 여부
3. 프로젝트 루트에 eslint.config.mjs 파일 존재 여부

하나라도 없으면 2단계로, 모두 있으면 3단계로 진행한다. 인자가 check이면 환경 상태만 보고하고 종료한다.

2단계: 환경 세팅 (필요 시)

누락된 항목만 설치/생성한다:

• eslint-plugin-obsidianmd 미설치 시:

  npm install --save-dev eslint-plugin-obsidianmd --legacy-peer-deps
  

• eslint 미설치 시:

  npm install --save-dev eslint --legacy-peer-deps
  

• eslint.config.mjs 미존재 시, 다음 내용으로 생성:

  import obsidianmd from 'eslint-plugin-obsidianmd';
  export default [...obsidianmd.configs.recommended];
  

설치 후 package.json과 package-lock.json 변경을 되돌린다:

git checkout -- package.json package-lock.json

인자가 setup이면 세팅 완료 후 종료한다.

3단계: ESLint 실행

npx eslint main.ts 'src/**/*.ts' 2>&1

4단계: 결과 분석

ESLint 출력을 분석하여 다음 형태로 요약 보고한다:

## 스캔 결과

- Required 이슈: N개
- Optional 이슈: N개

### Required 이슈 목록
| # | 파일 | 행 | 규칙 | 내용 |
|---|------|-----|------|------|
| 1 | src/ui/settings-tab.ts | 371 | sentence-case | "Copy the NID_AUT cookie value" |

에러 0개이면 "Required 이슈 없음 — 심사 봇 통과 예상"을 출력하고 종료한다.

5단계: 이슈 수정 (인자가 fix인 경우만)

발견된 Required 이슈를 하나씩 수정한다. 수정 전략:

• sentence-case: 기본 브랜드 목록(iOS, Obsidian, GitHub 등 57개)에 없는 고유명사는 소문자화하거나 제거. 첫 단어 위치면 대문자 허용. enforceCamelCaseLower: true 설정이므로 CamelCase도 변환 대상.
• empty catch: catch { 또는 주석 추가
• as any: 구체적 타입 또는 as unknown as Type
• no-explicit-any: unknown 또는 구체적 타입으로 대체
• template literal never: String() 래핑
• regex escape: new RegExp() 사용
• async without await: async 키워드 제거
• unused catch param: catch (error) → catch

수정 후 ESLint를 다시 실행하여 에러 0개 확인. 남아있으면 반복.

6단계: 빌드 확인

npm run build

빌드 실패 시 타입 에러 수정 후 재빌드.

7단계: 최종 보고

## 최종 결과

- 발견된 Required 이슈: N개
- 수정된 이슈: N개 (fix 모드인 경우)
- 남은 이슈: N개
- 빌드 상태: 성공/실패

### 수정된 파일 목록 (fix 모드인 경우)
- src/ui/settings-tab.ts (2건 수정)
- main.ts (1건 수정)