WenyuChiou/ai-research-skills

해결하는 문제

AI 연구 지원은 종종 5가지 구체적인 측면에서 실패하며, 이 카탈로그는 이를 해결하기 위해 구축되었습니다. 첫째, 새로운 채팅 세션을 시작할 때마다 연구 컨텍스트를 다시 설명해야 하는 번거로움입니다. 이 프로젝트는 해당 상태를 체크인된 매니페스트 파일에 저장합니다. 둘째, AI 모델은 존재하지 않는 인용을 환각(hallucination)으로 생성합니다. 이 프로젝트는 뒷받침하는 증거 아티팩트가 없는 모든 주장을 사실이 아닌 '갭(gap)'으로 표시하도록 강제합니다. 셋째, 수십 편의 논문을 읽어도 어떤 연구 갭이 논문 주제로 가치 있는지 알기 어렵습니다. '갭-투-토픽(gap-to-topic)' 스킬은 3가지 구조화된 게이트(열려 있는가? 실제 기여인가? 실현 가능한가?)를 적용합니다. 넷째, AI가 작성한 문체는 쉽게 식별되어 논문의 신뢰성을 떨어뜨립니다. 전용 작문 및 증거 감사 스킬이 이를 해결합니다. 다섯째, Claude, Codex, Antigravity와 같은 AI 도구 간 전환 시 상태가 초기화되는 문제입니다. 명시적이고 지속 가능한 핸드오프가 이를 해결합니다.

작동 방식

핵심 자산은 17개의 휴대용 스킬 파일 세트이며, 각 파일은 특정 연구 작업을 SKILL.md 계약으로 정의합니다. 이러한 스킬은 문헌 탐색, 갭 발견, 연구 질문 구성, 프로젝트 계획, 모델 구축, 실행 및 검증, 논문 초안 작성, 제출 및 응답이라는 8단계 파이프라인을 중심으로 구성됩니다. 각 단계의 출력은 다음 단계의 입력이 되며, 핸드오프는 자유 형식 텍스트가 아닌 YAML 스키마에 의해 기계적으로 정의됩니다. 하위 스킬은 잘못된 형식의 입력을 거부할 수 있어 과신된 주장이 전파되는 것을 방지합니다. 시스템 전체는 3가지 설계 원칙을 따릅니다. 매니페스트는 연구 상태를 체크인된 YAML/Markdown 파일에 저장하여 새로운 AI 세션이 스스로 온보딩할 수 있게 합니다. 안티 리크(anti-leakage) 규칙이 포함된 스키마는 뒷받침되는 주장과 갭을 구조적으로 분리합니다. 캐릭터 기반 라우팅은 토큰을 많이 소모하는 기계적 작업을 Codex나 Antigravity에 위임하고, 판단, 긴 컨텍스트 합성, 최종 검토는 기본 모델이 유지하도록 합니다. 별도의 연구 허브 런타임(pip을 통해 설치 가능)은 실행 가능하고 재개 가능한 워크플로우를 제공하며, 선택적 에이전트 협업 하네스는 정책 및 체크포인트 거버넌스를 추가합니다. 인간 개입(Human-in-the-loop) 제어는 계약 위반, 스킬 제거, 외부 쓰기, 의미론적 수락, 릴리스 승인이라는 5개 게이트에서 자동화를 일시 중지합니다.

대상 사용자

블랙박스가 아닌 검사 가능한 연구 워크플로우를 원하는 대학원생, 박사, 포닥, 연구 지원 인력 및 에이전트/하네스 빌더를 위해 구축되었습니다. 또한 AI를 연구에 도입하도록 돕는 사서, 연구 보조원 또는 지도 교수에게도 유용하며, 아무것도 설치하지 않고도 README를 공유할 수 있습니다. 에이전트 및 하네스 빌더는 상태, 인간 개입 제어, 복구 및 평가를 다루는 전용 아키텍처 가이드를 이용할 수 있습니다.

주요 특징

• 12개 스킬의 연구 워크스페이스로 시작하여 필요에 따라 작문, Zotero 또는 위임 플러그인을 추가할 수 있는 17개의 휴대용 스킬
• 단일 명령어로 설치 가능: claude plugin marketplace add WenyuChiou/ai-research-skills, 이후 claude plugin install research-workspace@ai-research-skills
• 자연어 요청 사용: 원하는 내용을 설명하면(예: "이 5편의 논문을 방법, 데이터, 한계점별로 비교해줘") 적절한 스킬이 활성화됨
• Zotero, Obsidian, NotebookLM을 하나의 선택적 라이브러리 관리 루프로 통합. 모두 선택 사항이며 시스템은 사용자가 가진 하위 집합에 적응함
• Claude Code, Codex CLI, Cursor, Windsurf, Gemini CLI, Hermes, OpenClaw 등 다양한 호스트에서 작동
• 라이브 CLI 워크플로우 포함: pip install research-hub-pipeline, 이후 research-hub setup 및 research-hub doctor
• 환각 방지 강제: 증거 아티팩트가 비어 있는 주장은 status: gap 및 갭 사유를 포함하도록 강제되며, 절대 지원되지 않음
• 인간 개입 게이트는 읽기 전용 및 가역적 단계가 자동으로 계속되도록 보장하지만, 계약 위반 및 외부 쓰기에는 명시적인 인간 승인이 필요함