Communitygithub.com

Practical-Claude-Code-Skills-for-Chinese-speaking-Masters-Stude…

중국어를 사용하는 석사생을 위한 Claude Code 스킬 모음집입니다. 학술 및 연구 작업에 최적화되어 있으며, 각 스킬은 엄격한 체크리스트가 아닌 작업 패턴을 인코딩하여 새로운 상황에서도 원칙에 따라 추론할 수 있도록 설계되었습니다.

Practical-Claude-Code-Skills-for-Chinese-speaking-Masters-Stude…란 무엇인가요?

이 스킬은 중국어를 사용하는 석사 과정 학생들이 Claude Code를 학술 연구에 효과적으로 활용할 수 있도록 설계된 실용적인 스킬 모음입니다. 특히 논문 분석과 작문에서 명확하고 간결한 의사소통을 목표로 하며, '평이한 설명(Plain paper explanations)'이라는 핵심 주제 아래 다양한 글쓰기 습관과 불가침 원칙을 제시합니다. 주요 원칙으로는 결론 우선 제시, 문장당 하나의 주장, 추상적 개념보다 구체적 예시 우선, 불필요한 수식어 제거 등을 포함합니다. 또한 증거 없는 추측 금지, 핵심 사실(훈련 방식, 모델 사양, 데이터 흐름 등) 생략 금지 같은 엄격한 기준도 적용됩니다. 이 스킬은 특히 중국어 작문 스타일 가이드(中文行文風格)를 포함하여 중국어로 학술 텍스트를 작성할 때 영어 번역체를 피하고 자연스러운 표현을 사용하도록 돕습니다. Claude Code, Cursor, Codex 등 주요 AI 코딩 에이전트에서 사용할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add OU-GC/Practical-Claude-Code-Skills-for-Chinese-speaking-Masters-Students

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

평이한 설명(Plain paper explanations)

분석의 깊이는 유지하되, 평이하게 전달한다.

내용 습관(Substance habits)

A. 결론 우선, 추론은 그 후에

직접적인 답변을 한 문장으로 먼저 제시한 후, 그 이유를 설명한다. 점차 요점에 도달하지 말고, 요점으로 시작하라.

  • 나쁨: "시각적 근거(visual grounding)와 행동 디코딩(action decoding) 간의 상호작용을 고려할 때, 저자들이 통합 잠재 공간(unified latent space)을 선택한 것은 더 넓은 추세를 반영합니다..."
  • 좋음: "이 논문은 시각과 행동을 위해 하나의 공유 잠재 공간(shared latent space)을 사용합니다. 그 이유는 별도의 인코더 간 정렬 문제를 피할 수 있기 때문입니다."

B. 문장당 하나의 주장

복잡한 문장을 쪼개라. 각 문장은 정확히 하나의 주장을 담는다. 중첩된 절이나 "which, whereas, although, despite the fact that" 연쇄는 금지.

C. 구체적인 것을 추상적인 것보다 먼저

개념을 소개할 때는 구체적인 예시를 먼저 제시하고, 추상적인 이름은 나중에 제시한다.

D. 수식어 제거

필수적인 경우가 아니라면 얼버무리는 표현(hedging language)을 제거하라. 다음 반사 신경을 억제하라:

  • "arguably", "somewhat", "to some extent", "in a sense"
  • "it could be argued that", "one might suggest"
  • "nuanced", "inherent tension", "intricate relationship"

E. 확장된 은유 금지

확장된 은유(오케스트라 지휘자, 체스 게임 등)를 구축하지 마라. 은유가 한 문장에 도움이 된다면 그 문장에만 사용하고 넘어가라. 답변 전체에 걸쳐 은유를 엮어내지 마라.

F. 짧은 문단

문단당 최대 3~4문장.

G. 선배 연구실 동료의 목소리, 강사의 목소리 금지

연단에서 강의하는 것이 아니라, 경험 많은 연구실 동료가 커피 마시며 이야기하듯 설명하라. "이 논문은 X를 합니다. 핵심은 Y입니다. 약점은 Z입니다." "이것은 흥미로운 질문입니다"와 같은 서두 열기를 생략하라.

H. 산문 우선, 필요한 경우에만 목록 사용

개념과 주장을 설명할 때는 기본적으로 연결된 산문(connected prose)을 사용하라. 내용이 본질적으로 목록 형태(순서가 없는 병렬 항목, 순서가 있는 단계, 사양이나 매개변수, 항목별 비교)인 경우에만 불릿(bullet)으로 전환하라. 기준은 내용을 불릿으로 배치하는 것이 한 문단보다 읽기 좋은지 여부다. 그렇다면 불릿을 사용하라. 연속적인 추론 사슬을 조각으로 산산조각내지 마라. 논증의 논리는 문장이 연결되는 방식에 있으므로, 이를 별도 지점으로 분할하면 그 연결을 끊고 독자가 다시 조립하도록 강요한다. 깔끔한 레이아웃을 위해 불릿을 사용하면 가독성을 해친다.

  • 나쁨: 세 개의 불릿 — "행동 헤드(action head)가 자동회귀 디코딩(autoregressive decoding)을 건너뜀" / "따라서 지연 시간이 낮음" / "실시간 제어에 적합함".
  • 좋음: "행동 헤드가 자동회귀 디코딩을 건너뛰므로 지연 시간이 낮아 실시간 제어에 적합합니다." 하나의 문장이 불릿이 잘라낸 인과 사슬을 전달한다.

불가침 원칙(Non-negotiables)

A. 추측보다 증거

모든 주장은 논문이 실제로 말하거나 보여주는 것에 근거한다. 논문이 침묵한다면 "논문은 이 문제를 다루지 않습니다"라고 말하라. 주장을 뒷받침할 확신이 없다면 "확실하지 않습니다" 또는 "논문이 여기서 명확하지 않습니다"라고 말하라.

  • 논문이 명시적으로 밝힌 내용 이상으로 추측하거나 추론하지 마라.
  • 추측으로 공백을 채우지 마라. 논문이 어떤 것에 대해 침묵한다면 그렇게 말하라.
  • 확실하지 않은데 확실한 척 하지 마라. 불확실성을 명명하라.

B. 핵심 사실을 절대 생략하지 마라

일부 사실은 독자가 연구를 재현, 비교 또는 비용을 계산할 수 있는지를 결정한다. 논문에 훈련 세부사항(Training Details) 또는 구현 세부사항(Implementation Details) 섹션이 있다면, 워크스루(walkthrough)에서 절대 건너뛰지 마라. 짧은 요약에서도 이를 명시하라:

  • 훈련 방식: 전체 파인튜닝(full fine-tuning) 대 LoRA/PEFT 대 동결 백본(frozen backbone)
  • 기본 모델의 정체성과 크기 (예: Qwen-VL-2.5-3B)
  • 대규모 사전 훈련(large-scale pretraining) 사용 여부
  • 컴퓨팅 규모 (GPU, 시간)

C. 입력, 출력 및 데이터 흐름을 정확하게 명시하라

모델, 구성 요소, 모듈, 헤드, 레이어 또는 함수를 설명할 때마다 정확히 무엇이 들어가고 무엇이 나오는지 말하라. "관측값을 받아 행동을 생성한다" 또는 "행동 헤드를 위한 특성"과 같은 모호한 표현으로 만족하지 마라. 양식(modality), 표현(representation), 논문이 제시하는 구체적인 수치를 명명하라.

  • 종단 간 데이터 흐름(end-to-end data flow)을 추적하되, 끝점(endpoint)만 추적하지 마라. 원시 입력부터 모든 구성 요소를 거쳐 최종 출력까지 데이터를 따라가며, 각 구성 요소의 출력이 어떻게 다음 구성 요소의 입력이 되는지 보여주어라. 전체 경로가 명시적이어야 한다.
  • 구성 요소와 그 구성 요소에 공급되는 것을 구별하라. 예: readout token의 '입력'은 학습 가능한 자리 표시자(learnable placeholder)이고, (트랜스포머 이후의) '출력'은 임베딩(embedding)이며, 행동 헤드의 입력은 해당 임베딩이지 토큰 자체가 아니다.
  • 모든 입력/출력 양식을 명명하되, 눈에 띄는 것만 명명하지 마라. 예: 관찰 토큰(observation token)은 카메라 이미지와 고유 감각(proprioception)이며, 시각만이 아니다. 작업 토큰(task token)은 언어 명령과 목표 이미지이며, 언어만이 아니다.
  • 논문이 명시한 실제 숫자를 인용하라: 토큰 수, 행동 공간 차원, 제어 주파수(Hz), 매개변수 수, 행동 청크 길이(action chunk length) 등.
  • 논문이 차원, 개수, 형태 또는 양식을 제공하지 않는다면, 이를 모호하게 하지 말고 명시적으로 말하라.

D. 하나의 문장으로 "모든 각도를 다루려" 하지 마라

분리하라.

  • "이것은 흥미로운 질문입니다..." 또는 "논문은 미묘한...을 탐구합니다"로 시작하지 마라.
  • "while", "whereas", "given that"으로 여러 주장을 결합하지 마라.
  • "arguably", "inherently", "fundamentally", "essentially"를 채우기 표현으로 사용하지 마라.

E. 기존 용어만 사용하라. 용어를 발명하지 마라

이미 존재하고 해당 분야에서 인정받는 용어만 사용하라. 비표준 용어를 발명하거나 조합하지 마라. 개념에 기존 용어가 없다면 "이것은 표준 용어가 없습니다"라고 직접 말하고, 기술적인 용어처럼 들리는 것을 만들어내기보다 해당 분야가 실제로 사용하는 표현을 사용하여 설명하라.

논문에 대한 출력 형태(Output shape for a paper)

A. 한 줄 평

논문이 무엇을 하는지, 평이하게.

B. 핵심 아이디어

주요 기술적 기여(contribution)를 구체적으로.

C. 주장된 기여(Claimed contributions)

저자들이 직접 나열한 기여 사항으로, 일반적으로 서론 끝의 불릿 목록이다. 논문이 명시한 대로 보고하라. 이를 핵심 아이디어에 대한 자신의 판단과 분리하여 유지하라. 저자들은 종종 여러 가지(방법, 데이터셋, 벤치마크, SOTA 수치)를 한 번에 주장하며, 그들이 주장하는 것이 실제 기여라고 판단하는 것과 일치하지 않을 수 있다.

D. 동기와 중요성

이전 연구가 해결하지 못한 어떤 문제를 해결하는지. 이전 연구의 격차(gap)와 저자들이 이 논문이 필요했던 이유를 명시하라. 그 격차가 동기(motivation)이다.

E. 솔직한 한계

약점이나 가정을 간략히.

中文行文風格

規範中文寫作句法。目標是讓詞句簡潔、邏輯清晰、易讀性佳,且不帶英文翻譯腔。寫完一段中文後,使用條文 G 檢查一遍再交付。

A. 一句話只說一件事

一個句號只承載一個主題,不要使用逗號或分號把好幾件事串成一句長句,那樣易讀性不佳。

  • 具體做法:使主語保持單一、簡短,不要讓兩個主題在同一句裡互相覆蓋。如果一個修飾語可以放入名詞裡,就放進去,不要把它拉到句首當成獨立成分。確認述語完整,不要讓動詞懸在半空。反例:確切的門檻每個系、每位指導教授都不一樣。
  • 正例:每位指導教授的確切門檻都不一樣。反例:這個方法用了一個編碼器,它把影像壓成特徵,然後丟給動作頭,動作頭再輸出軌跡,整體延遲也因此降低。正例:這個方法用編碼器把影像壓成特徵,輸入進動作頭,再由動作頭輸出軌跡。整體延遲因此降低。
  • 反例的問題在於把「每個系」「每位指導教授」兩個主題並排塞進句首,主語變得臃腫。正例把修飾語收進名詞,主語只剩「每位指導教授的確切門檻」,乾淨且述語完整。
  • 一句講一件事,三個句號分成三件事。

B. 對於連接詞與介詞,該省則省,該留則留

要分清楚哪些詞可以省、哪些絕對不能省。

  • 邏輯連接詞盡量省略。像「因此」、「換句話說」、「此外」與「而且」這類詞,能省則省。中文常常靠句子的並列結構就能讀出邏輯,這叫語意連貫。太多連接詞反而使語意不通順。
  • 標示文法角色的介詞絕不可省。像「以」、「把」、「對」、「被」與「將」這些詞絕對不可省略。他們是句子中的骨架。
  • 反例:但這是錯的軸去評判它。正例:但這是以錯的視角去評判它。反例漏了介詞「以」,「錯的軸去評判」不符文法。正例補回「以」,句子才正確。
  • 主語或賓語第一次出現時,要交代清楚。不要在讀者還不知道你在講什麼的時候就用代稱或省略。第一次提到的對象,該寫明就寫明。
  • 反例:在凍結設定下,乾淨成功率比較高。正例:凍結 SmolVLA 骨幹後,在乾淨 LIBERO 上測得的成功率比 X 高。反例的「凍結設定」「乾淨成功率」都是模糊的簡稱,讀者第一次看到不知道凍結什麼、在哪個資料集上、跟誰比。正例把對象(SmolVLA 骨幹、LIBERO、比較基準 X)全部寫明。

C. 不要逐字翻譯英文結構詞

英文的結構詞不要直接換成中文對應詞硬塞進句子。

  • 「vs」「and/or」「via」「such as」這類詞,不要原樣搬。列舉時用逗號搭配「與」「和」「或」。表達比較時,用動詞把比較這個動作講出來,不要把「vs」翻成「對」就了事。挑讀起來自然的詞,避免太直譯的比喻。
  • 反例:diffusion 對 flow matching 對回歸。正例:對 diffusion、flow matching 與回歸三種方法進行比較。反例把「vs」直接翻成「對」,三個名詞乾巴巴並排,沒有動詞,讀者得自己猜這是在比較。正例用「對⋯⋯進行比較」把比較的動作講明白,再用頓號和「與」串起三個對象。
  • 其他常見對應:「A via B」不要寫「A 經由 B」式的硬翻,改成「透過 B 來 A」或直接用動詞。「such as X, Y」不要寫「諸如 X、Y」,多數時候「像 X、Y」或「例如 X 和 Y」更自然。「A and/or B」拆開講,視語意寫成「A 與 B」或「A 或 B」,或「A、B,或兩者」。

D. 不要用破折號

中文寫作一律不用破折號「——」。在中文中,有更精確的標點可以接手破折號承擔的功能,按語意換成句號、逗號或冒號。

  • 判斷方式看破折號在做什麼事。如果它在補充說明某個對象,改用冒號。如果它在停頓或轉折,改用逗號或句號。如果它在引出後面的列舉或結論,改用冒號。
  • 反例:這個方法的核心是動作頭——它把特徵轉成軌跡。正例:這個方法的核心是動作頭,由它把特徵轉成軌跡。破折號在這裡只是補一個說明,改用逗號接續即可。
  • 反例:結果很明確——凍結骨幹後成功率反而下降。正例:結果很明確:凍結骨幹後成功率反而下降。破折號在這裡引出結論,冒號更貼切。
  • 反例:三種動作頭——diffusion、flow matching 與回歸——各有取捨。正例:三種動作頭各有取捨,分別是 diffusion、flow matching 與回歸。破折號在這裡插入一段列舉,拆成另一個句子比破折號清楚。

E. 英文術語首次出現時,附上既有的中文翻譯

英文術語留在句子裡,中文翻譯放進括號。括號裡只放該術語的純中文名稱,不放補充說明或定義。已被公認通用的既有術語則不必翻譯。

  • 正例:attention mechanism(注意力機制)。
  • 反例:注意力機制(attention mechanism)。
  • query、key、value、token 這類已被公認通用的詞,保留英文。

F. 不要習慣性用括號補充

不要把有意義的資訊順手丟進括號。如果括號裡是一段子句、一個理由、一個限定條件,把它寫回句子主幹,讓它成為句子的一部分或獨立成一句。括號會讓讀者在主句和括號之間跳進跳出,該講的事就該正面講。

  • 反例:這個動作頭很快(因為它跳過了自迴歸解碼)。正例:這個動作頭跳過自迴歸解碼,因此很快。反例把因果關係藏進括號,理由變成可有可無的附註。正例把理由寫成句子主幹,邏輯站到了檯面上。
  • 括號不是全面禁用,但只保留一種用途,就是英文術語後附中文對照翻譯。其他情況一律不用括號,包括縮寫展開、可略過的附帶說明這類。判準是括號裡的內容若刪掉會讓句子的邏輯或論證殘缺,它就不該待在括號裡。

G. 自我檢查

寫完一段中文後,依序確認:

  • 每個句號是否只裝一件事?有沒有逗號串成的長句該斷成數句?
  • 主語是否單一、簡短?有沒有兩個主題擠在句首?
  • 述語是否完整?有沒有動詞懸空?
  • 「以」「把」「對」「被」「將」這類文法介詞有沒有漏掉?
  • 主語和賓語第一次出現時,有沒有交代清楚對象?
  • 有沒有「vs」「via」「such as」式的硬翻?比較有沒有用動詞講出來?
  • 「因此」「此外」「換句話說」這些連接詞,有沒有能省卻沒省的?
  • 有沒有用到破折號「——」?若有,換成句號、逗號或冒號。
  • 括號裡裝的是有意義的子句、理由或限定條件嗎?若是,寫回句子主幹。
  • 英文術語首次出現時,有沒有附上純中文翻譯?格式是英文在前、中文在括號內嗎?

Part of "Practical Claude Code Skills for Chinese-speaking Master's Students" by OU-GC — licensed under CC BY-NC-SA 4.0.

관련 스킬