study-candidate-selector

결정적(deterministic) Skill. 점수 계산·정렬·선정은 scripts/select.mjs가 수행한다.

입력

{
  "date": "2026-09-17",
  "rankings": { "totalStarsTop10": [], "growth24hTop10": [], "newlyDiscovered": [] },
  "history": { "owner/name": { "top10Days": 3 } },
  "studyStates": { "owner/name": { "studyExists": false, "prOpen": true } },
  "policy": "(선택) study-policy YAML 문자열 또는 객체"
}

• rankings: github-star-analyzer 출력의 rankings
• history: 최근 repeated_top10_window_days일 동안 TOP10 등장 일수(오늘 포함). 없으면 오늘 등장 여부(0/1)로 계산
• studyStates: 기존 Study 파일 존재 여부(studyExists), 열린 PR 여부(prOpen), Study 대상 아님 판정(notStudyable, Registry의 studyability에서 옴). 없으면 미작성으로 간주
• policy: 생략 시 resources/study-policy.yml

실행

node scripts/select.mjs input.json > study-queue.json

점수 계산 (0~100)

각 요소를 0~1로 정규화한 뒤 priority 가중치를 곱해 합산 (소수 둘째 자리 반올림).

상태

• skipped_study_exists / skipped_pr_open / skipped_not_studyable: skip_if 규칙에 해당 (이 순서로 우선)
• selected: 나머지 중 priority 상위 max_daily_drafts개
• queued: 선정되지 않은 나머지

정렬: priority ↓ → stars ↓ → 이름순. 출력은 resources/schemas/study-queue.schema.json을 따른다.

조사 중 Study 대상이 아니라고 판정된 경우

github-researcher가 studyable: false를 반환하면, 해당 후보를 제외하고 다음 대기 후보를 올린다.

# input: { "queue": <StudyQueue>, "markNotStudyable": "owner/name" }
node scripts/select.mjs mark.json   # → { "queue": <StudyQueue>, "promoted": "owner/name" | null }

promoted가 있으면 그 저장소로 조사를 이어간다. null이면 오늘 Study 수가 줄어든 채로 진행한다.

규칙

• 점수를 직접 계산하거나 순서를 임의로 바꾸지 않는다.
• selected 항목만 github-researcher → study-writer 단계로 넘긴다.