sam-workshop
samahn0601/sam-workshop
의대 단독저자 논문 작성 워크숍 17 skill pack — 8-step pipeline + HITL drive mode (Claude Desktop Code 탭)
Instalação
npx convez-ai samahn0601/sam-workshop1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
Workshop — 의대 교수 대상 AI 활용 논문 작성 (v1.2)
작성: 2026-04-28 / 갱신: 2026-04-30 (v1.2 reference-run) / 2026-05-31 (6/20 운영 정본 정합) 워크숍 일정: 2026-06-20 (토) 10:00–16:00 (+16:00–16:15 optional Q&A) 5h 실습 + 1h 점심 일정. 단독저자 모드. Deliverable: submission-directed draft package + (선택) AI-assisted item bank + 17 skill 영구 설치 타임라인 SSOT: TIMETABLE.md · 당일 운영: D_DAY_RUNBOOK / BLUEPRINT
현 상태 (D-20, 6/20 운영 정본 확정)
- 2026-05-31 (D-20): 타임라인·파이프라인 라벨을 6/20 운영 정본(10:00–16:00, 8-step + Bonus)으로 정합 완료 — TIMETABLE / skill README / OT slide·script 동기화. 아래 항목은 개발 이력(8b 분할 등은 v1.2 시점, 운영본에서 step 7/Bonus로 재배치됨).
- Skill Pack v1.2 완성 (17 skills + 5 schemas + 4 scripts + 5 templates) →
skills/sam-workshop/ - v1.3 포팅 plan 채택 (2026-05-03) — 본 파이프라인(autopilot+collab) v1.2 패치 일부를 워크숍 백엔드로 흡수. 3AI 합의 도출, Tier 1/2/3 분류, dry-run 5월 중순 예정. 상세: handoff_20260503_v1_3_plan.md
- v1.2 변경 (reference run 결과 반영, 2026-04-30):
- Step 8b 시간 분할: 8b1 desk-reject 5분 + 8b2 exam wrap 20분 (총 25분)
figure_render_fallback.py추가: free-tier 이미지 생성 미가용 시 matplotlib schematicpaper_profile.schema.json에target_audience_language필드 추가 → 영문 manuscript도 한국 청중이면 한국어 문항집 defaulthitl_recommend.py메시지 분리: Medical Safety Floor (H4) vs Conservative Floor (H3)revision_backlog.jsonl포맷 spec 명문화 (critic-multi-persona SKILL.md)
- v1.1 신규 (이전):
evidence-harvest-claim-bank,exam-item-builder - v1.1 패치 (이전): HITL hard floor override, manuscript versioning + manifest.json, 5h timetable reconciled
- 다음 (D-45 ~ D-0): Tier 1 코드 통합 → smoke test 3건 → dry-run → v1.3 hotfix → freeze → 본 행사 2026-06-20
한 줄 요약
Sam AI Pipeline (16-step Auto-Pilot/Collab)을 단독저자 + Claude Desktop Code 탭 중심 + 4 Self-Gate supervised 모드로 다이어트한 8-step 파이프라인. Claude 주력 + GPT-5.5 critic + GPT-image-2/Nano Banana 2 figure 병렬. 무료 티어 활용 권장.
목표 산출물 (참가자 1인당)
- submission-directed draft package (5–7일 내 본인 마감 가능 형태)
- Letter / Commentary / Case Report / Editorial: 본문 + cover letter + checklist
- Narrative Review: 1차 outline + 2 핵심 섹션 draft
- Original (Brief Report): IMRaD 골격 + Discussion 1차
- 본인 강의 시험문제 20–30문항
- Sam Workshop Skill Pack (15 skills 영구 설치) — 1년+ 라이프사이클 자산
- paper_home 폴더 (Code 탭 세션) — 논문 1년 라이프사이클 home (투고 → R&R → 출판)
핵심 차별점
- HITL Dial + 단계별 운전 모드 — 파이프라인 맵에서 각 단계를 "정지 없이 진행/정차"로 토글: 현장 🛡️표준(①③⑤⑥⑦)·⚡시간절약(①⑤⑦), 사후 자산 🏁최종집중·🎛️커스텀. 세션 시작 시 한 줄로 선택(
pipeline_map.md/gate_plan.json), 끝에 dial 처방 — 양방향. 2 Floor 강제 정차(Medical Safety: 임상권고/약물/IRB/R6 + Publication Ethics: AI 공개문/저자권/COI/저널정책) + ①⑦ soft floor(주제·AI공개문)는 어떤 모드에서도 저자 확인 - Code 탭 중심 + Chat 보조: Claude Desktop Code 탭에서 skill·script·파일·검증을 완결, 문헌검색(②)만 Chat Deep Research 선택 활용
- 결정적 검증 vs LLM 추론 엄격 분리 — DOI/PMID/regex는 script, 의미는 LLM
- 무료 티어 보조 멀티엔진 — Claude Pro 필수, GPT/Gemini 무료 OK
- Frontier 인식 — Sakana AI Scientist (Nature 2026.3), Google PaperOrchestra (2026.4) hook으로 supervised semi-automation 정직 포지셔닝
정본 파이프라인 (메인 8-step + Bonus 병행 트랙)
이 절이 파이프라인 단계 정의 SSOT다. 시간 배치는 TIMETABLE.md, 당일 카드는 FACILITATOR_PROMPT_CARD. 모든 발표/대본 자료(OT slide·OT script)는 이 라벨을 따른다.
DESIGN
1. Idea Lock [journal-fit-check] [Self-Gate A]
2. Deep Research [Chat DR + reporting-guideline-router]
3. Story & Outline [evidence-harvest-claim-bank
+ story-design]
WRITE
4. Draft [Code 탭 파일 에디터 + section-boundary]
5. Verify [verify-reference-essential
+ stats-consistency] [Self-Gate B]
REFINE
6. Critic [critic-multi-persona +
GPT-5.5 ext + scorecard-9d] [Self-Gate C]
FINISH
7. Humanize & Package [humanize-en/ko + desk-reject-precheck
+ cover letter + AI disclosure] [Self-Gate D]
(figure brief 옵션: figure-prompt-eng)
8. Wrap & Next [hitl-dial-recommender →
self-deadline checklist + 다음 논문 dial]
+ Bonus track (병행·선택): 목업 통계 흐름 / 강의자료 기반 시험문항 초안
Figures는 메인 블록이 아니다 — 당일은 step 7에서 figure brief/caption만, 렌더링은 homework. 옛 v1.2의 "step 7 = Figures(병렬)" 라벨이 10:00–16:00 운영 흐름과 어긋나 step 7(Humanize & Package)에 흡수하고, Wrap을 step 8로 승격했다.
폴더 구조 (현재)
workshop/
├── README.md ← 이 파일
├── INSTALL.md ← 설치 가이드
├── FINAL_REPORT.md ← 자율 완수 보고서 (skill pack v1)
└── skills/sam-workshop/ ← 배포 단위
├── README.md ← Skill Pack 사용법
├── _shared/
│ ├── schemas/ (3 JSON)
│ ├── scripts/ (3 Python, 1147 lines)
│ └── templates/ (4 markdown)
└── (15 skills × SKILL.md)
다음 작업 (사용자 액션 필요)
- Reference run 1회 (Letter 1편) — skill 자동 트리거 정확도, R1-R5 script 정확성 실측 (2026-04-30 완료)
- v1.3 Tier 1 코드 통합 (5월 1째주, ~5h) —
compliance_backend.py+ 3 SKILL.md 갱신 + 회귀 테스트 5건. 상세:handoff_20260503_v1_3_plan.md - Smoke test 3건 (5월 2째주 초) — Letter / Brief Report / Case Report
- Dry-run 1회 (5월 중순) — 외부 의대 교수 1-2명, Brief Report 통계 포함, shadow baseline 동시 캡처
- v1.3 hotfix (5월 셋째주, dry-run +48h 분류 후)
- (5월 말) 슬라이드 v3 (8-step + Hybrid backend evidence 흐름) + 사전 안내문
- (사후) Skill description benchmark 30개씩 (skill-creator 활용)
- (사후) 한국 의대 교수 자주 투고 저널 5–10개 specs 사전 정비
- (v2 후속)
exam-item-generatorskill 별도 분리
빠른 시작 (Desktop Code 탭 · 평평 설치 — 2026-06-10 실측 검증)
- Code 탭 통합 터미널에서 paper_home 생성:
install/init-workshop-{mac.sh,windows.ps1} - Code 탭 새 세션 → 작업 폴더 = paper_home
- 설치 발화 한 줄 붙여넣기: "sam-workshop repo를 clone해서 skills/sam-workshop 안의 17개 skill 폴더와
_shared를 지금 작업 폴더의.claude/skills/바로 아래로 복사해줘 (우산 폴더 금지 — 1단계)" - 새 세션 1회 →
/목록에 17개 확인 → 첫 발화:"내 논문 어느 저널에 투고할까?"
⚠️ Code 탭 skill 탐지는 .claude/skills/<skill>/SKILL.md 1단계만 인식 — cp -R skills/sam-workshop ~/.claude/skills/ 같은 우산 복사는 17개 전부 미탐지(실측). 반드시 평평하게.
자세한 설치/검증: INSTALL.md. Skill Pack 사용법: skills/sam-workshop/README.md.
의사결정 이력
- 2026-04-28: 워크숍 컨셉 시작 (12-step v2 슬라이드)
- 2026-04-29: HITL Dial 5단계 도입, Cowork-centered 아키텍처 확정 (→ 2026-05-31 Code 탭 중심으로 전환: skill·script가 Claude Code 네이티브라 Code 탭이 자산 보존에 유리, 환경 단일화)
- 2026-04-29: 3-AI consult #1 (Gemini + GPT-5.5 + Claude) → 합의안 산출
- 2026-04-30 AM: Skill Pack v1 자율 완수 (15 skills, 3823 lines)
- 2026-04-30 PM: 3-AI review #2 → 6 critical issues 식별
- 2026-04-30 PM: v1.1 P0 패치 자율 완수 — exam-item-builder + evidence-harvest-claim-bank 신규, hitl_recommend.py hard floor override, manuscript versioning, 5h timetable reconciled (3-AI consult #3)
참고
- 기반 파이프라인:
../sam-ai-autopilot/,../sam-ai-collab/,../shared/ - 3-AI consult 기록:
~/.claude/skills/3ai-consult/outputs/3ai-consult_20260430_FINAL.md - 워크숍 슬라이드 (현재):
../파이프라인 소개.png(12-step v2)