09站06次動手01個案例走到底
研究副駕駛 教練證CO-PILOT LICENSE
講者 Vista(鄭緯筌)
NAMEVista(鄭緯筌)
ROLE研究者基地主理人・AI 應用培訓師
ROUTE長期在大學、研究機構與學術社群分享 AI 賦能研究與寫作
RULEAI 是手段,留下能複利的研究產出與思考能力才是目的
輔助
不代寫CO-PILOT
41所合作校院與研究機構
83場學術場域授課場次
21本出版著作
1.7萬博碩士生練功團成員
路況報告

你現在用 AI,大概卡在這三個地方

用完
就丟

問完就關掉

整理得再好,留在對話框裡,
下週就找不到了。

每次
重講

每次都從頭交代

研究題目、領域、格式偏好,
每開一次新對話就重講一次。

不敢
用

不敢放進論文

怕被說代寫,怕引用是假的,
乾脆不用或偷偷用。

問題出在哪

問答式的用法,每一圈都從零開始

01打開對話框問一句 02複製答案挑看起來對的 03貼回 Word格式自己修 04關掉視窗對話留在雲端某處 回不去的那條線:下一次,你要從頭再講一次
今天要換的位置

同一件事:把十篇論文整理成比較表

問答你問,它答
01十篇摘要一篇篇複製,貼進對話框
02表格只存在對話框裡
03貼進 Word,格式跑掉再手動修
04下週再來十篇,整個重來
交辦你給目標,它做完
01自己打開資料夾,逐篇讀 PDF 全文
02比較表存成檔案,放在你的研究資料夾
03欄位照你上次寫好的規則
04下週同一句話,同一個格式

今天整堂課只練一件事:從問答換成交辦。

今天的同行者CASE STUDY
NAME小安
STATUS教育研究所碩士班二年級,正在寫論文計畫書
TOPIC家長使用智慧型手機,會不會影響幼兒的親子互動品質?
FOLDER~/Desktop/ai-research
PDFpaper-A.pdf 一篇剛下載、還沒讀完的論文

小安卡在哪

文獻找了一百篇,
說不出該讀哪十篇

讀完的筆記散在
四個地方

計畫書第一段,
寫了三個禮拜

小安與後面出現的示範論文都是虛構的教學案例。示範都用小安,練習時換成你自己的題目。

今天的路線

九站,每一站帶走一樣東西

前兩站先把觀念講清楚,第三站開始,每一站結束時你的資料夾都會多一個檔案。

站名底下是那一站結束時,你資料夾裡會多出來的檔案。第 9 站帶走的是你自己寫的第一支 Skill。

怎麼走

每一站都是同一個節奏,第二站起你就會預期

1卡在哪先講痛點 2一張圖講懂它在做什麼 3看小安做完整示範一次 4換你動手黃色那一頁 檢查點資料夾多了什麼 !道路救援三個常見卡關 前三步是我講、你看;後三步是你做、我走動看畫面。卡住了先翻道路救援那一頁。
路標說明

看到這三種頁面,就知道現在該做什麼

黃色:換你動手

上面寫著這次要產出的檔名。看到它,就打開你的終端機。

檢查點:資料夾+三個勾

左邊是你的資料夾應該長的樣子,右邊三件事全打勾才算完成。

道路救援:卡住先看

每個練習最常見的三種卡關,症狀對得上就照著修。

上車前

你的桌上,現在要有這六樣

01

一臺筆電

macOS 或 Windows 都可以,而且你有安裝軟體的權限。學校或公司配發的機器先確認。

02

Claude 付費帳號

至少成功登入過一次。兩步驟驗證的手機帶在身邊,帳號問題現場救不了。

03

一篇你的論文 PDF

正在讀或想讀的那篇。數位 PDF 最好,掃描檔它讀不到字。

04

一句研究主題

講得出來就好,模糊也沒關係。今天的練習會一路幫你把它磨清楚。

05

一個筆記本

紙本也可以。記下你卡住的地方,回家照附錄的卡關總表排除。

06

還沒有題目也沒關係

用你手上那篇 PDF 的標題當主題。練習要驗的是流程,不是題目。

出發前檢查

這四件事,最好在上課前就做完

  • Claude 帳號登入過一次

    確認付費方案已生效,驗證信收得到。

  • 三個網址打得開

    claude.ai、github.com、npmjs.com、pypi.org。學校網路擋掉的話,現場改用手機熱點。

  • 提早申請 S2 金鑰

    第 4 站找文獻會用到。人工審核、用 E-mail 寄送,要等幾天。申請方法在附錄 A。

  • 看一下有沒有 Node.js 與 Python

    終端機打 node -v、python3 --version。沒有也能上課,第 4 站會教你交辦 Claude 代裝。

上課時你會拿到這份簡報的網址與密碼。所有指令與交辦句,都可以直接從簡報頁面選取複製,不用對著投影幕手打。

方向盤一直在你手上。
今天學的,是怎麼讓副駕駛
幫你看地圖。

它找路、報路況、提醒你看儀表板;往哪裡開,永遠是你決定。

LEG 1 / 9
01

三個名詞:
Agent、Skill、複利

這一站沒有學術內容。但這三個詞不先講清楚,後面每一站你都會不知道自己在裝什麼。

先問一句

你現在,是怎麼用 AI 的?

多數人打開對話框,問一句

  • 複製答案,貼回 Word
  • 問完就關掉,下次再從頭解釋
  • 檔案要自己一篇篇複製貼上
  • 結果好不好,全看那一次運氣

它不知道對話框外面的事

  • 你的資料夾裡有哪些論文
  • 你上個月已經決定的格式
  • 你的領域、你的題目、你的禁忌
  • 它上一次做錯了什麼

模型夠聰明,卡住的原因在它拿不到你的東西。

詞一 AI Agent

同一個模型,差在能不能動手

聊天機器人
AI Agent(今天用 Claude Code)
你給它
一個問題
一個目標,加上材料放在哪
它做什麼
回一段文字
自己拆步驟、開檔、查資料、寫檔
你的檔案
只看得到你貼進去的片段
讀得到你指定的整個資料夾
產出在哪
對話框裡,關掉就沒了
一個檔案,留在你的電腦裡
圖解

差別只有一件事:有沒有手腳

聊天機器人 你 問題文字 對話框 它的世界,就到對話框為止 AI AGENT 你 目標 Agent 讀檔 寫檔 跑指令 它的手伸得進你的資料夾
它怎麼做事

一個會自己繞完的圓環

你只做一件事 交辦一個目標 它自己繞到做完 1看:打開材料 2想:拆步驟 3做:查、寫、存檔 4自己檢查

繞完一圈,
還有一步只有你能做:

打開檔案,看到內容。它說「已完成」不算完成,你親眼看過才算。

它會自己連續做很多事,所以你比用聊天機器人時,更需要知道它做了什麼。

看小安怎麼說

同一個需求,問跟交辦長得不一樣

給聊天機器人
幫我摘要這篇論文。
  1. 它讀不到你的 PDF,你要先複製全文貼上
  2. 摘要長怎樣,看它當天心情
  3. 結果留在對話框裡
交辦給 Agent
  1. 讀 paper-A.pdf
  2. 用繁體中文寫三行摘要:問題、方法、發現
  3. 再寫一行你覺得它最弱的地方
  4. 每一行都標出處的頁碼
  5. 存成 summary.md,放在這個資料夾

右邊五行包含第 3 站要教的交辦四個零件:目標、材料、格式、存成檔案,再加一條查證要求。示範論文 paper-A.pdf 是虛構的,請勿引用。

詞一,一句話收

你給 Agent 的,
是目標,不是問題。

問題只換得到一段回答。目標加上材料、格式與存放位置,換得到一個留在你電腦裡的檔案。

詞二 Skill

一支 Skill,就是一個資料夾

paper-navigator/ SKILL.md必要 scripts/可選 references/可選 assets/可選 一份寫給 AI 看的說明書 就是 Markdown 純文字。你打得開、讀得懂、改得動。 它不是外掛,不是 App,也不是訂閱服務 沒有程式也沒有編譯。scripts 那些可選的小程式, 是說明書裡交代 AI 在需要時去跑的。
打開來看

SKILL.md 分上下兩半

SKILL.md節錄改寫・示意
---
name: paper-navigator
description: Find and read academic papers.
  Judge relevance against an authored rubric…
---

# 寫給 AI 看的工作流程
1. 先確認使用者要一篇、一份清單還是一整片
2. 先寫一份評分表(core/secondary),再開始搜尋
3. 每一篇都要附原文引句才算符合

上半:名片

只有 name 與 description 兩個必填。AI 平常只看這一段,用來判斷這次該不該叫它。

下半:SOP

你怎麼交代助理,就怎麼寫。沒有語法要學,只是讀者換成 AI。

生活比喻

AI 是新來的助理,Skill 是你留的交接手冊

沒有手冊

每次都從頭講

格式、順序、禁忌、要附什麼,交辦十次就講十次。

累的是你,結果還每次不一樣。

有了手冊

講一次就寫下來

之後它自己翻手冊做事,做出來的東西每次一樣。

你只要說「照手冊做」。

手冊會長大

錯一次補一條

它哪裡做錯,你就在手冊上補一條規矩。下一次那個錯就不會再出現。

這就是第三個名詞:複利。

它怎麼知道要用哪一支

先看名片,對得上才打開整本手冊

你說幫我找小安題目的相關論文 每一支的名片(description) paper-writing寫論文段落 paper-navigator找與讀論文 deeppapernote單篇深讀筆記 paper-review投稿前自審 SKILL.md 全文 這時才讀完整流程 所以 description 寫得好不好,決定它叫不叫得出來。第 9 站你會自己寫一次。
詞三 複利

為什麼 Skill 會產生複利,prompt 範本不會

存一堆 prompt 範本寫成 Skill
存在哪記事本、書籤、雲端文件你的電腦,AI 讀得到的位置
怎麼啟動你要記得它存在,找出來,貼上AI 看名片自己判斷要不要用
會不會忘了用會,這是最大的問題不會
改進之後下次要記得貼新版改一次,之後每次都是新版
能不能給別人貼給他,他還是會忘記用給他一個資料夾就好
三個詞串起來

關鍵不在哪一格,在那條回頭的線

Skill一份說明書 Agent照說明書做事 研究產出留在資料夾的檔案 你把有效的做法,寫回 Skill 詞二詞一每一次研究

每跑完一次就補一條規則,下一次研究的地板就比這一次高。這就是複利。

別搞混

Skill 跟這三個東西,不一樣

vs GPTs

綁在一家平臺

GPTs 是某一家平臺上的設定。Skill 是你電腦裡的檔案,換工具就搬資料夾。

vs CLAUDE.md

永遠生效的規矩

指令檔每次都會讀。Skill 是需要時才打開的專項流程,全塞進指令檔,AI 每次都要讀一堆無關的東西。

vs MCP

接資料的插座

MCP 負責接上外部資料,例如你的 Zotero。Skill 負責怎麼做事。兩者互補,不是替代。

放回小安身上

三個名詞,在小安的論文裡長這樣

它是什麼在小安身上
Agent讀得到檔案、寫得出檔案、跑得動指令的 AI打開 paper-A.pdf,讀完寫成 summary.md
Skill一個資料夾,一份寫給 AI 的說明書裝一支 paper-navigator,找文獻時照小安的評分表打分
複利把有效做法寫回說明書,下一次更好閱讀卡的欄位定好之後,第 30 篇跟第 1 篇格式一樣,可以並排比較

這三列,就是接下來七站的縮影:第 3 站用 Agent,第 4 站起用 Skill,第 9 站寫你自己的 Skill。paper-A.pdf 是示範用虛構論文,非真實文獻,請勿引用。

第 1 站小結

三個名詞,一句話收

本站帶走 一個判斷這件事,我是要「問」它,還是要「交辦」給它? 下一站:先把位置站對,再開機。
  1. Agent 是有手腳的 AI

    讀得到你的檔案、寫得出檔案。你給的是目標,不是問題。

  2. Skill 是一份說明書

    一個資料夾加一份 SKILL.md,只有 name 與 description 必填。

  3. 複利來自回頭那條線

    每次做完,把有效的做法寫回說明書,下一次地板更高。

LEG 2 / 9
02

副駕駛的界線

開機之前,先把位置站對:哪些可以交給 AI,哪些一步都不能讓,用了又要怎麼說。

The point of doing research is not to produce papers. It is to produce understanding.

做研究的目的不是產出論文,是產出理解。

Simon Peyton Jones,Microsoft Research,〈How to Write a Great Research Paper〉

把理解外包出去的每一個動作,都在削弱研究本身。這一站的每一條界線,都從這句話來。

先看儀表板

同樣用 AI,差在誰在判斷

副駕駛 助理 代筆 AI 主導程度 低高

副駕駛

同車、同視野。它提醒你儀表板的異常,轉不轉彎、踩不踩煞車,永遠是你決定。

助理

交辦之後不看過程,直接收下結果。出事時說不出哪一步錯、為什麼這樣做。

代筆

讓 AI 生出你沒讀過、沒想過的內容,直接掛你的名字。這堂課不教這一種。

邊界

副駕駛與代寫,差在這五件事

副駕駛
代寫
順序
你先想過,AI 補強或挑戰你
AI 先產出,你事後湊理由
判斷
每一段都由你判斷、改寫、簽名
說不出為什麼這樣寫,只是照抄
辯護
審稿人追問細節,你答得出來
審稿人一問細節就露餡
紀錄
揭露協作,方法留下紀錄
協作痕跡刻意抹掉
長期
判斷力愈用愈強
判斷力愈用愈弱

判斷標準只有兩條:對外可辯護,對內能產生複利。

三種誤用

把 AI 放錯位置,最常見的三種樣子

01當成代筆

幫我寫一段

樣態 丟一句「幫我寫一段文獻回顧」,輸出直接貼進論文。

徵兆 你讀不出這一段為什麼放在這裡。

改法:先列出要對話的三組文獻,再讓 AI 補論述的接縫。

02當成引用生成器

幫我補幾篇

樣態 請 AI 補幾篇支持論點的文獻,照抄書目。

徵兆 DOI 打進 Google Scholar,查無此文。

改法:每一筆回 Crossref 或 Google Scholar 查證,查不到就標「未驗證」。

03當成投稿加速器

換個說法再投

樣態 同一份稿子讓 AI 改寫,同時投好幾家。

徵兆 你說不出兩個版本的貢獻差在哪。

改法:用投稿策略決定投哪一家,不是用產能決定投幾家。

禁制標誌

學術界 AI 使用的三條紅線

引用

偽造引用

讓 AI 生出你沒讀過的文獻,
或直接採用沒查證的書目與 DOI。

資料

偽造資料

讓 AI 生成、補齊或美化數據、
受訪者引言與統計結果。

隱瞞

不揭露 AI 協作

達到實質協助的程度卻不說明,
或刻意抹除協作痕跡。

前兩條是造假,第三條是不誠實。三條都不是灰色地帶。

判斷標準

研究的八個節點,落在光譜的哪裡

← 表達與探索:AI 可以主導 判斷與立場:你要主導 → 2文獻蒐集初篩與分層 7論文寫作其中的語言潤飾 3文獻掌握整理成筆記與矩陣 8投稿修改審稿意見回應初稿 1研究提問最後選哪一題 4方法設計質性或量化的取捨 6分析詮釋能不能談因果 5資料蒐集原始個資:紅線 圓圈裡的數字是研究流程的順序:1 提問、2 蒐集、3 掌握、4 方法、5 資料、6 分析、7 寫作、8 投稿 別問 AI 能不能做,要問這件事屬於表達,還是屬於判斷。
四個等級

AI 適用度,分四個等級

高適用AI 可以主導
  • 大量文獻的初篩與分層
  • 格式轉換、書目與表格整理
  • 語言潤飾與術語一致性
中適用AI 提初稿,你定稿
  • 文獻回顧的結構與分類
  • 論述段落的初稿
  • 審稿意見的分類與回應初稿
低適用你主導,AI 只做檢查
  • 研究問題的最終選定
  • 理論框架的取捨
  • 關鍵發現的詮釋
不宜介入紅線,一步都不跨
  • 原始個資與受試者資料上傳
  • 關鍵發現的因果宣稱
  • 偽造審稿回應或誇大修改
揭露

哪些要揭露,哪些不用

!實質協助:要揭露

  • 生成論述段落或章節初稿
  • 從文獻產生比較表或分類架構
  • 參與研究設計或分析策略的決定
  • 生成程式碼,並用來產出結果
  • 改寫既有文字,成為論文內容

✓語言潤飾:多數期刊不要求

  • 拼字與文法檢查
  • 句子通順度調整
  • 被動語態與冗詞清理
  • 術語用字一致性校對
  • 格式與參考文獻樣式轉換

界線在 AI 有沒有參與產生內容與判斷。拿不準就揭露,並查該刊的作者須知。

揭露範本

照這個寫,不要自己發明

AI Use Disclosure Statement英文範本

During the preparation of this manuscript, the authors used [Claude / ChatGPT / other]1 for [drafting sections of the Introduction / generating comparative tables from cited papers]1. After using this tool, the authors reviewed and edited2 the content as needed and take full responsibility3 for the content of the publication.

中文意思 準備本稿件時,作者使用[工具名稱]進行[具體用途]。使用後,作者已視需要審閱並修改內容,並對本出版內容負完全責任。

01

AI 做了什麼

兩個方括號:哪個工具、做了哪件事。換成你真正做過的,不要照抄。

02

你做了什麼

reviewed and edited:你審過、改過,確認之後才用。

03

責任在誰

take full responsibility:每一句都由作者負責。避免只寫 AI-generated 這種模糊字。

IRB

受試者資料,另一條線

訪談錄音、逐字稿 問卷原始回應 可辨識個人的資料 雲端 AI 不要做:原始資料直接上傳 先去識別姓名、校名、地名換成代號 留在本機處理 做質性研究的人,優先走這條

這跟模型好不好無關,是研究倫理審查的範圍。不確定就先問 IRB。

放回小安身上

小安的計畫書:誰坐哪個位置

副駕駛座:交給 AI它找路、報路況,你看過才算數

  • 找候選文獻,每篇附原文引句第 4 站
  • 照固定欄位做閱讀卡,每格標頁碼第 5 站
  • 扮審稿人,先替計畫書挑毛病第 6 站
  • 句級清理、術語前後一致第 7 站

駕駛座:小安自己來方向盤不交出去

  • 選定研究問題,決定主張要收多窄
  • 判斷每篇文獻跟題目到底有沒有關係
  • 詮釋發現:橫斷面資料,不寫成因果
  • 錄影與家長資料留在本機,去識別才處理
  • 寫 AI 揭露聲明,簽自己的名字
把思考權留在手上

一路上的四個原則

01先想再問問之前,先寫自己的答案沒有自己的版本,就沒有基準 02每段驗證每段都答得出證據在哪答不出來,就不要用 03留下 SOP有效的流程寫成 skill下一次不必重講,愈用愈準 04定期斷奶隔一陣子自己做一次確認判斷力還在
第 2 站小結

位置站對了,才開機

本站帶走 三條紅線
+一份揭露範本偽造引用、偽造資料、不揭露,一條都不碰。
下一站:開機上路,裝好環境,第一次交辦。
  1. 判斷屬於你

    愈靠近表達與探索,AI 可以主導;愈靠近判斷與立場,你要主導。

  2. 用了就照範本揭露

    寫清楚 AI 做了什麼、你做了什麼、責任在誰。投稿前查該刊的作者須知。

  3. 受試者資料不進雲端

    先去識別,或整套留在本機。拿不準就先問 IRB。

LEG 3 / 9
03

開機上路:
裝好環境,第一次交辦

這一站結束時,你的資料夾裡會多一個你沒親手打過字的檔案。

先選介面

四種介面,兩個問題就選得出來

Q1產出要不要變成你電腦裡的檔案? 要 Q2想避開終端機嗎? 不想 本課推薦終端機macOS:終端機Windows:PowerShell錯誤訊息完整、指令留得下來 不用 瀏覽器版 claude.ai只要一段回覆,這個就夠 想 桌面 App 的 Code 分頁同一個 Claude Code 第四種Claude Code on Web跑在雲端,讀不到你桌面的 PDF 今天的練習,產出都要變成你電腦裡的檔案,所以一定走右邊那條。
為什麼是終端機

本課用終端機,只為了兩個理由

01理由一

錯誤訊息完整

skill 叫不動、路徑打錯,終端機把原始訊息整段印出來。你知道要查什麼,也能整段擷圖問人。

02理由二

指令留得下來

每一步都是一行字,複製下來就是紀錄。下個月貼回去就能重跑,要教同學,把那幾行傳過去就好。

App不想碰終端機

桌面 App 也可以

Claude 桌面 App 的 Code 分頁,是同一個 Claude Code 換上圖形介面。課堂做的事,一件都不會少。

兩者能做的事一樣。

破除迷思

關於終端機的三個誤解

寫程式

要先會寫程式?

不用。你在裡面打的大多是中文交辦,
要記的指令只有三四個,都能照抄。

打錯字

打錯會弄壞電腦?

不會。打錯只會多一行找不到指令。
今天用到的指令,沒有一個會刪東西。

黑底

黑底白字很難?

那只是配色。Claude Code 在裡面
有排版、有顏色,用方向鍵選選項。

步驟總覽

五步開機,畫面上的指令照抄就好

一臺電腦只做一次 每開一個新研究就做一次 1安裝curl/irm 2確認裝好claude --version 3第一次登入claude 4建工作資料夾mkdir、cd 5第一次交辦summary.md 每一步都有一頁,做完一步確認一步。哪一步卡住,就停在那一步舉手。
步驟 1/5

打開終端機

  1. macOS:終端機

    按 ⌘+空白鍵叫出 Spotlight,打「終端機」或 Terminal,按 Enter。

  2. Windows:PowerShell

    按開始功能表,打 PowerShell,點開它。不是「命令提示字元」。

  3. 看到提示字元就對了

    游標在閃的那一行,就是等你打字的地方。

提示字元長這樣
macOS 終端機 你的名字@你的電腦 ~ % Windows PowerShell PS C:\Users\你的名字> 名字與電腦名稱每個人不同。最後那個符號後面,就是你打字的地方。
步驟 2/5

安裝 Claude Code:挑你的系統,貼一行

macOSLinux 也用這一行
終端機
curl -fsSL https://claude.ai/install.sh | bash
Windows在 PowerShell 裡貼
PowerShell
irm https://claude.ai/install.ps1 | iex

貼上、按 Enter,然後等:畫面不會跑進度條,看起來像當掉,其實在下載。
回到提示字元、又可以打字了,就是裝完了。

步驟 3/5

確認裝好:開新視窗再問一次

開一個新視窗舊視窗不認得新指令 claude --version 印出一串版本號看到數字就是裝好了,往下一步 找不到 claude 這個指令訊息裡有 not found 或 not recognizedPATH 還沒生效:整個關掉終端機,重開再打 Windows 選配:另裝 Git for Windows 的話,Claude Code 會改用 Git Bash;沒裝就用 PowerShell,今天的練習都做得到。
步驟 4/5

第一次啟動:用你的 Claude 帳號登入

  1. 打 claude,按 Enter

    在哪個資料夾打都可以,這一步只為了登入。

  2. 照畫面一步步選

    用方向鍵選、Enter 確認。登入方式選用 Claude 帳號,就是你付費的那一個。

  3. 瀏覽器跳出來,按授權

    授權完回到終端機。要離開時打 /exit。

第一次啟動(畫面大意)
~ % claude
  1. 請你挑一個畫面配色
  2. 請你選登入方式:用 Claude 帳號
  3. 瀏覽器開啟登入頁,你按授權
  4. 回到終端機,幾個說明畫面按 Enter 繼續
  5. 出現可以打字的輸入框:開好了
實際畫面是英文,順序與措辭依版本略有不同。
終端機的基本功

今天只要記三個指令,加上第四個

01pwd

我在哪

印出你現在站在哪個資料夾。終端機永遠站在某一個資料夾裡。

02cd

走過去

後面接資料夾路徑。~ 代表你的家目錄。

03ls

看看有什麼

列出這個資料夾裡的檔案。檢查點就靠它。

+ 第四個claude

叫它開工

在哪個資料夾打,它就在那裡工作。之後打的,都是中文交辦。

Windows 對照

用 Windows,差別只在斜線方向

你要做的事macOS 終端機Windows PowerShell
打開它Spotlight 搜「終端機」開始功能表搜「PowerShell」
看位置、看內容pwd lspwd ls 一樣
換資料夾cd ~/Desktop/ai-researchcd ~\Desktop\ai-research 斜線反過來
叫出 Claudeclaudeclaude 一樣
設環境變數今天用不到。第 4 站要用,做法見附錄 A

Windows 的桌面若開了 OneDrive 備份,實際位置可能在 OneDrive 資料夾底下。檔案總管裡找不到 ai-research 時,先打 /exit 離開 claude(或另開一個終端機視窗),再打 pwd 看它建在哪。

步驟 5/5

建工作資料夾,把 PDF 放進去

  1. 建資料夾、走進去

    右邊前兩行照打。資料夾名字不要有空白。

  2. 把 PDF 放進去

    用 Finder 或檔案總管,把你的論文 PDF 拖進桌面上的 ai-research。打 ls 看得到它才算放好。

  3. 在這裡叫出 claude

    第一次在這個資料夾開它,它會問你信不信任這裡的檔案。這是你自己建的,選同意。

照抄,一行一個 Enter
macOS mkdir -p ~/Desktop/ai-research cd ~/Desktop/ai-research (先把 PDF 拖進這個資料夾) ls claude Windows PowerShell mkdir ~\Desktop\ai-research cd ~\Desktop\ai-research Windows 接著一樣打 ls,再打 claude。
為什麼要先建資料夾

在哪裡開它,那裡就是它的工作範圍

在桌面開 claude 報帳單據 其他論文 照片 私人文件 ai-research 下載的檔案 工作範圍:整個桌面 在 ai-research 開 claude 照片 其他論文 ai-research/ paper-A.pdf summary.md 工作範圍:只有這個資料夾

它寫檔預設只在你開它的那個資料夾,和底下的子資料夾裡;要動外面的東西,會先問你。
paper-A.pdf 是示範用虛構論文,非真實文獻,請勿引用。

第一次交辦之前

一句好的交辦,有四個零件

01目標要它做到什麼 02材料它要讀哪個檔 03格式長什麼樣子 04存成檔案叫什麼、放哪裡 小安這次三行摘要+最弱的地方 小安這次paper-A.pdf 小安這次繁體中文每一行標頁碼 小安這次存成 summary.md放在這個資料夾 少了第四個零件,結果就只留在對話框裡,跟聊天機器人沒有兩樣。

paper-A.pdf 是示範用虛構論文,非真實文獻,請勿引用。

看小安做

小安的第一次交辦,一字不漏

~/Desktop/ai-research claude
請讀這個資料夾裡的 paper-A.pdf02,用繁體中文寫三行摘要:研究問題、方法、主要發現01,再寫一行你覺得這篇最弱的地方01。每一行後面標出處的頁碼03。寫完存成 summary.md,放在這個資料夾04。 整段打在同一行,打完才按 Enter:中途按 Enter,它會直接送出半句話。上標數字對應上一頁的四個零件,不用打。
01

按下 Enter,它先說明打算怎麼做、要讀哪個檔。

02

讀完 PDF,整理出摘要、找弱點、對頁碼。

03

要建立 summary.md 之前,停下來問你。下一頁看怎麼回。

paper-A.pdf 是示範用虛構論文,非真實文獻,請勿引用。

它會先問你

權限詢問:看懂再按

權限詢問(畫面大意)
它要建立檔案:summary.md 底下會列出它打算寫進去的內容 要允許嗎?
  1. 1允許這一次
  2. 2允許,這次對話裡同類動作不再問
  3. 3不允許,並告訴它要怎麼改
實際畫面是英文,措辭依版本略有不同。用方向鍵或數字選,按 Enter。

它要動手之前,
會先停下來問你

建立或修改檔案、跑指令,都會先問;讀這個資料夾裡的檔案,通常不問。

對一下兩件事:動的是哪個檔案?是不是你交辦的事?

看不懂就選 3。問它「你要做什麼?為什麼?」它會解釋,你再決定。

換你動手

第一次交辦

用你自己的 PDF,照小安那段交辦跑一次,讓資料夾長出第一個檔案。

產出summary.md
練習 01 任務卡

三步,做完才算

  1. 換成你的檔名

    PDF 已經在 ai-research 裡。檔名有空白或很長,先改短,例如 my-paper.pdf。

  2. 最後一句一定是存檔

    整段打在同一行再按 Enter。它問能不能建立檔案時,看清楚是 summary.md 再允許。

  3. 打開來看

    在 claude 裡說「把 summary.md 的內容顯示給我看」;想自己開,Finder 右鍵 → 打開檔案的應用程式 → 文字編輯(Windows 用記事本)。

照抄,黃色那段換成你的檔名
請讀這個資料夾裡的 my-paper.pdf,用繁體中文寫三行摘要:研究問題、方法、主要發現,再寫一行你覺得這篇最弱的地方。每一行後面標出處的頁碼。寫完存成 summary.md,放在這個資料夾。 它問能不能建立 summary.md 時,看清楚檔名,選允許。
檢查點

你的資料夾,現在多了一個檔案

~/Desktop/ai-research/
  • PDF[你的檔名].pdf
  • MDsummary.mdNEW
  • 檔案在

    Finder 或檔案總管看得到 summary.md。想用終端機確認,先打 /exit 離開 claude(或另開一個終端機視窗),再打 ls。

  • 內容是你那篇

    研究問題、方法對得上你的 PDF,不是它想像出來的。

  • 講得出出處頁碼

    隨便挑一行,翻到它標的那一頁,對得上。

道路救援

卡住了?先對症狀

!
打 claude 說找不到畫面上有 not found 或 not recognized
開一個新視窗再打。還是不行,看安裝最後印出的訊息,提到 PATH 的那幾行照做,或整段擷圖給助教。
!
登入卡住瀏覽器沒跳出來,或授權完沒反應
複製終端機上的登入網址,貼到瀏覽器打開。確認登入的是付費帳號;學校網路擋住,就換手機熱點。
!
它說存好了,你找不到資料夾裡沒有 summary.md
直接問它:「summary.md 的完整路徑是什麼?」多半是在別的資料夾開了 claude。先打 /exit 離開 claude,回到步驟 5,用 cd 走進 ai-research 再開。
一個重要的態度

它說「完成」不算,
你打開看到才算。

接下來每一站的檢查點,第一條都是檔案在不在;第二條是內容對不對得上原文。

回頭看

剛剛那一次,你用了 Agent 的兩隻手

paper-A.pdf 01 讀檔打開 PDF,讀全文 Agent在中間整理:摘要、弱點、頁碼 02 寫檔建立 summary.md這一步它先問過你 summary.md 你剛剛用了讀檔與寫檔兩隻手;第三隻跑指令,下一站裝 skill 時會用到。

paper-A.pdf 是示範用虛構論文,非真實文獻,請勿引用。

第 3 站小結

資料夾裡,有了第一個檔案

本站帶走 summary.md你的資料夾裡,第 1 個 AI 產出、你親手打開核對過的檔案。 下一站:同樣是交辦,加一支 skill。
  1. 環境裝好了

    打 claude --version 印得出版本號。之後每一站,都從 cd 走進資料夾、打 claude 開始。

  2. 交辦有四個零件

    目標、材料、格式、存成檔案。少了最後一個,結果就只留在對話框。

  3. 看懂再按,打開才算

    權限詢問看清楚再允許;它說完成之後,親手打開檔案對頁碼。

下一站預告

同樣的事,加一支 skill 會差在哪

LEG 4 下一站 找文獻 paper-navigator EXIT 4
這一站交辦,每次寫齊四個零件

格式、規則都靠你那一段話。下次再做,就要再寫一次。

下一站加一支 skill,流程寫在說明書裡

你只給題目與評分表,它照表逐篇判斷,每篇附上原文引句。

LEG 4 / 9
04

找文獻:
paper-navigator

搜得到不難,難的是說得出為什麼留下這幾篇。這一站裝你的第一支 Skill。

卡在哪

搜得到一百篇,
說不出為什麼是這幾篇。

Google Scholar 會給你一長串結果,但不會告訴你哪幾篇跟你的題目真的有關。這一站要練的,是讓每一篇留下來的論文,都附得出理由。

一張圖

從撒網到留下理由,一路往下收

01 撒網 02 評分 03 排序 04 留下理由 一百篇關鍵字+引用網 照你的評分表逐篇逐條比對 All-core 在前排序靠判斷 附引句說得出哪一句 candidates.md 排序三到五篇其餘列在「也相關」,每篇附理由 每往右一格,留下的愈少,但每一篇都更說得出為什麼
為什麼是它

第一支 Skill 裝它,三個理由

01

文獻線的入口

讀文獻、寫文獻回顧,材料都從這裡來。入口一致,紀錄才一致。

02

產出一眼看得懂

就是一份論文清單,分好等級、附上理由。對不對,你自己就判斷得出來。

03

沒金鑰也跑得動

沒有 Semantic Scholar 金鑰時,它會改去 arXiv 找。先跑得起來,金鑰到了再補。

裝第一支 Skill

兩種裝法,挑一種就好

A交辦給 Claude 幫你裝
在 claude 裡貼上
請幫我把 GitHub 上 EvoScientist/EvoSkills 裡的 paper-navigator 安裝到 ~/.claude/skills/,裝好告訴我完整路徑。

沒有 Node.js 的人走這條。它會徵求你同意下載與寫檔,看懂再按。

B自己打指令
在終端機貼上
先打 /exit 離開 claude(或另開一個終端機視窗) npx skills add EvoScientist/EvoSkills -g -a claude-code -s paper-navigator

需要 Node.js。第一次會問 Ok to proceed? (y),看到就按 y、Enter。

出處:github.com/EvoScientist/EvoSkills 授權 Apache-2.0。課程只給連結,請到原始 repo 安裝。

裝好之後必做

重開一次,確認它看得到

開一個新的終端機視窗
cd ~/Desktop/ai-research claude /skills
  1. 先關掉正在跑的 claude,直接關掉終端機視窗最保險
  2. 開新視窗,走進工作資料夾,再啟動 claude
  3. 打 /skills,看它列出哪些 Skill

/skills

清單裡出現 paper-navigator,就裝好了。

看不到的話,先確認真的重開過;再看資料夾名稱是不是 paper-navigator,中間是減號。

它的相依

有沒有 S2 金鑰,找到的東西差很多

主做法:交辦請幫我安裝 paper-navigator 需要的 Python 套件 deepxiv-sdk 和 httpx。備案:自己打python3 -m pip install deepxiv-sdk httpx
它要找論文撒網那一步 有 S2_API_KEY Semantic Scholar跨領域都找得到,還能追引用網、推薦相似論文 沒有金鑰 退回 arXiv引用網追蹤與相似論文推薦停用 社會科學題目也找得到 多半是電腦科學、物理教育、心理題目會找得很偏

所以金鑰要在課前申請(附錄 A)。退回 arXiv 這條路要用 DeepXiv 的免費 token,第一次跑時請 Claude 照 SKILL.md 幫你設定。自己打備案前,先打 /exit 離開 claude(或另開一個終端機視窗)。

它最不一樣的地方

先訂評分表,再照表判斷

評分表 C1 core C2 core C3 secondary 論文 1✓ ✓ ~ 論文 2✓ ~ ✗ 論文 3✗ “ 回應幼兒的 次數愈少 1先訂標準你寫好交給它;沒給,它會自己訂 2逐篇逐條標記✓ 符合 ~ 部分 ✗ 不符 3每個 ✓ 附原文引句從摘要裡摘出來的一小段

什麼叫相關,標準由你訂;它負責照表判斷,再把證據拿出來。

引句取自示範用虛構論文,非真實文獻,請勿引用。

評分表長怎樣

兩到四條準則,每條只講一件事

RUBRICSKILL.md 第二步的格式
RUBRIC for "<你的題目,逐字>"
Criteria (2 to 4, atomic;
  mark each [core] or [secondary])
  C1 [core]      <一定要有>
  C2 [core]      <一定要有>
  C3 [secondary] <有更好>
Disqualifiers: [<一看到就剔除>]

core 一定要有

每一條 core 都打勾的論文,才進最高級 All-core。

secondary 有更好

會標記,但不決定分級。沒有權重,也不算分數。

排除條件 踩到就出局

不知道怎麼寫

三格法:現象 × 結果 × 對象

現象家長自己的手機使用誰、做了什麼 × 結果親子互動品質回應性、共玩、對話輪替你在乎它影響了什麼 × 對象0 到 6 歲幼兒研究的是誰 C1 [core] C2 [core] C3 [secondary] 前兩格多半是 core,對象常是 secondary。 最後再想一條「一看到就排除」的條件,例如:只研究孩子自己的螢幕時間。
看小安寫

小安的評分表:三條準則,一條排除

C1研究的是家長或主要照顧者自己的手機使用不是孩子的螢幕時間,這是整個題目的重心[core]
C2結果變項是親子互動品質回應性、共玩、對話輪替,三者有一就算[core]
C3研究對象是 0 到 6 歲幼兒國小以上的研究不是不要,只是排在後面[secondary]
排除只研究孩子自己的螢幕時間摘要裡一看到就剔除,不管其他條件Disqualifier
最常見的失敗

寫了三條,其實只有兩條

改前

C1 [core] 研究家長的手機使用C2 [core] 研究家長的智慧型裝置使用C3 [secondary] 跟親子有關

C1 和 C2 講的是同一件事;C3 太鬆,什麼論文都沾得上邊。結果是:真正在乎的「親子互動品質」沒有一條管。

改後

C1 [core] 家長自己的手機使用C2 [core] 結果變項是親子互動品質C3 [secondary] 0 到 6 歲幼兒

SKILL.md 的規定:每條準則只講一件事(atomic),而且彼此不重疊。寫完自問:拿掉任何一條,結果會不會變?

看小安交辦

題目、評分表、引句、檔名,一次講清楚

小安在 claude 裡貼上
  1. 用 paper-navigator 幫我找文獻。
  2. 題目:家長使用智慧型手機,會不會影響幼兒的親子互動品質?
  3. 評分表:C1 [core] 研究的是家長或主要照顧者自己的手機使用(不是孩子的螢幕時間);C2 [core] 結果變項是親子互動品質(回應性、共玩、對話輪替);C3 [secondary] 研究對象是 0 到 6 歲幼兒。
  4. 排除:只研究孩子自己的螢幕時間。
  5. 每一篇的每一條判斷,都附摘要裡的原文引句。
  6. 分成 All-core、Partial、Irrelevant 三級,存成 candidates.md。

第 1 行點名 Skill,第 6 行指定檔名。第 3 站學的交辦四個零件:目標、材料、格式、存成檔案,一個都沒少。

它回來的東西

三個等級:All-core、Partial、Irrelevant

候選(虛構)C1 [core]C2 [core]C3 [secondary]分級
甲〈家長手機使用與親子共玩中的回應性〉✓「家長在遊戲中拿起手機」✓「回應幼兒的次數愈少」✓「2 到 4 歲幼兒」All-core每條 core 都 ✓
乙〈母親社群媒體使用與親子關係滿意度〉✓「母親每日使用社群媒體」~滿意度不等於互動品質✗國小高年級Partial只有部分 core ✓
丙〈學齡前兒童每日螢幕時間與詞彙量〉✗量的是孩子的螢幕時間踩到排除條件,其他不必再看Irrelevant下一輪直接剔除

示範用虛構資料,非真實文獻,請勿引用。三篇候選都是為教學編的。

引句或零分(Quote-or-zero)

說不出哪一句符合,就不算符合

它說甲 符合 C2 附上的引句「回應幼兒的次數愈少」 算數 它說乙 符合 C2 附上的引句摘要裡找不到支持這條的句子 不算符合

它擋的不是假論文,是對真論文下的假判斷。

示範用虛構資料,非真實文獻,請勿引用。引句規定見 SKILL.md 第五條紅線:80 字元內,取自摘要、TLDR 或內文片段。

找到之後怎麼讀

三層閱讀法:時間要按層分配

L1 L2 L3 L1 能重做方法細節、補充材料都讀;只給你要建立在其上的那幾篇 L2 看懂取捨看懂它為什麼這樣做;文獻回顧裡大多數論文在這一層 L3 快掃標題、摘要、圖、結論,先決定要不要往上讀

最常見的錯:每一篇都深讀,讀到第八篇就放棄了。

換你動手

替你的題目
找文獻

先用三格法寫評分表,再交辦 paper-navigator,讓每一篇留下來的論文都附得出引句。

產出candidates.md
練習 02 任務卡

三步,做完會多一個檔案

  1. 用三格法寫評分表

    現象 × 結果 × 對象。兩到四條,標 [core] 或 [secondary],再加一條排除條件。

  2. 貼上右邊的交辦

    在工作資料夾啟動 claude,把底線換成你的題目與評分表。

  3. 打開 candidates.md 看

    在 claude 裡說「把 candidates.md 的內容顯示給我看」;想自己開,Finder 右鍵 → 打開檔案的應用程式 → 文字編輯(Windows 用記事本)。

交辦範本
  1. 用 paper-navigator 幫我找文獻。
  2. 題目:____
  3. 評分表:C1 [core] __;C2 [core] __;C3 [secondary] __。
  4. 排除:__
  5. 每一篇的每一條判斷,都附摘要裡的原文引句。
  6. 分成 All-core、Partial、Irrelevant 三級,存成 candidates.md。
檢查點

你的資料夾,現在多了一個檔案

~/Desktop/ai-research/
  • MDsummary.mdLEG 3
  • MDcandidates.mdNEW
  • 每一篇都有引句

    每個 ✓ 底下都有一段原文。沒有引句的 ✓,當作沒寫。

  • 評分表是你寫的

    candidates.md 開頭的評分表,是你寫的那幾條(它沒有自己另訂);每一篇都分好級。

  • 抽一篇去查得到

    隨手挑一篇,標題貼進 Google Scholar,真的有這篇論文。

道路救援

卡住了,先對症狀

!
它沒有用那支 Skill回答裡完全沒提到 paper-navigator
句首明確寫「用 paper-navigator」;還是不行,打 /skills 確認它有載入。
!
找到的全是電腦科學清單裡都是 arXiv 上的資訊類論文
沒有 S2 金鑰時它退回 arXiv,這是預期中的結果。金鑰下來、設定好之後再跑一次(附錄 A)。
!
卡很久沒動靜畫面停在查詢那一步
沒有金鑰時大約每三秒才准查一次,而且不能平行,慢是正常的。等它跑完,或請它先少查幾篇。
!
跳出安裝視窗macOS 要你安裝「命令列開發者工具」
按安裝,等它裝完,再把剛才的交辦貼一次。
Vista 心法

每次探索,
都留一份查詢紀錄。

查了什麼詞、用了哪一份評分表、排除了什麼、為什麼。交辦時多加一句「在檔案最後列出你查過的關鍵字」。這份紀錄,就是你論文 Method 段的初稿。

該用與別用

什麼時候叫它,什麼時候改走別條路

該用要一份有理由的清單

  • 題目還在探索期,想知道有哪些代表作
  • 要從幾篇種子論文往前往後追(需要 S2 金鑰)
  • 要一份分好級、附引句的候選清單
  • 要決定哪幾篇值得往上讀到 L2、L1

別用改走這幾條

  • 只要深讀手上這一篇:下一站
  • 要寫整片文獻回顧:第 9 站工具箱地圖的 research-survey
  • 只是找一筆引用:直接 Google Scholar

它是文獻線的入口:後面讀與寫的材料,都從這份清單出發。

第 4 站小結

帶走一份說得出理由的清單

本站帶走 candidates.md每一篇都有分級、都有引句 你的資料夾:2 個檔案。下一站:挑一篇,讀懂並留下來。
  1. 評分表是你的標準

    core 一定要有,secondary 有更好,排除條件踩到就出局。

  2. 引句或零分

    說不出哪一句符合,就不算符合。這條擋的是對真論文的假判斷。

  3. 時間要分配

    多數論文 L3 快掃,L1 只留給你要建立在其上的那幾篇。

下一站預告

找到了,接著要讀懂並留下來

candidates.md 挑一篇 All-core paper-A.pdf 照閱讀卡範本 notes/paper-A.md 研究問題方法主要發現 限制跟我的關係我為什麼讀它 下一站不裝新工具,靠一份固定欄位的範本,把讀懂的東西留成一張卡

paper-A 是示範用虛構論文,非真實文獻,請勿引用。

LEG 5 / 9
05

讀文獻:
讀懂並留下來

讀懂一篇是當下的事。把它留成一張下次還用得上的卡片,才會開始累積。

卡在哪

讀完了,卻沒留下能再用的東西

讀完一篇論文 信箱裡的一封信寄給自己的重點 雲端某份文件檔名叫「新文件」 下載資料夾的擷圖不知道是哪篇的圖 PDF 上的螢光筆畫了,沒寫為什麼 三個月後要寫文獻回顧,一句也找不回來
一張圖

一篇論文,變成一張排得進表格的卡

PDF notes/ 一篇論文讀完就散 一張閱讀卡六個固定欄位 一個資料夾一篇一張,放同一處 跨篇比較矩陣同一欄並排,缺口浮出來 複利從第二張卡開始:欄位一樣,才排得成一張表
閱讀卡範本

一張閱讀卡,六個欄位

01

研究問題

它想回答什麼,用一句話寫。

02

方法

怎麼做、對象是誰、多少樣本。

03

主要發現

一到三句,有數字就留數字。

04

限制

作者自己承認的,加上你看到的。

05

跟我的關係

支持、反駁,還是補了我的哪一格。

06

我為什麼讀它

三個月後的你,最需要這一欄。

為什麼要固定欄位

同一組欄位,才比得起來

方法
樣本
設計
paper-A
錄影編碼
120 組
橫斷面
paper-B
家長自陳
300 位
橫斷面
paper-C
家長自陳
沒寫
橫斷面
paper-D
家長自陳
85 組
縱貫

缺口,是排出來的

每張卡都有「方法」這一欄,你才看得出:大多數靠家長自陳,只有一篇錄影。

紅框那一格空著,是因為那張卡當初沒有固定欄位。

paper-A 到 paper-D 都是示範用虛構論文,非真實文獻,請勿引用。

看小安交辦

照範本讀,每一欄附頁碼

小安在 claude 裡貼上
  1. 讀 paper-A.pdf,照下面的閱讀卡範本做一張卡。
  2. 欄位:研究問題、方法、主要發現、限制、跟我的關係、我為什麼讀它。
  3. 每一欄都附原文頁碼;原文沒寫的,寫「原文未提」。
  4. 「跟我的關係」請對照我的題目:家長使用智慧型手機,會不會影響幼兒的親子互動品質?
  5. 用繁體中文寫,存成 notes/paper-A.md。

這一站沒有裝新的 Skill。範本就寫在交辦裡,第 9 站再把它變成一支 Skill。

paper-A 是示範用虛構論文,非真實文獻,請勿引用。

它交回來的卡

notes/paper-A.md 長這樣

paper-A.md~/Desktop/ai-research/notes/
# 家長手機使用與親子共玩中的回應性
研究問題:家長在共玩時使用手機,是否降低回應幼兒的頻率(p.2)
方法:觀察研究,120 組 2 到 4 歲幼兒與家長,錄影自由遊戲,編碼家長回應次數(p.4)
主要發現:拿起手機的時間愈長,回應幼兒的次數愈少(p.6)
限制:橫斷面設計,無法談因果;手機時間部分來自家長自陳(p.9)
跟我的關係:直接支持我的題目;它量的是時間長短,我想量回應延遲(p.6)
我為什麼讀它:少數用錄影量家長回應的研究,方法可以借(p.4)

六欄,六個頁碼

每一欄都翻得回原文。這是下一頁要講的護身符。

後兩欄是它的草稿。你要改成自己的話,這兩欄寫的是你自己的判斷。

示範用虛構論文,非真實文獻,請勿引用。頁碼也是虛構的。

頁碼就是護身符

每一格,都要翻得回原文

notes/paper-A.md 主要發現 拿起手機的時間愈長, 回應幼兒的次數愈少 限制 橫斷面設計,無法談因果 p.9 p.6 paper-A.pdf p.6 …拿起手機的時間愈長,回應幼兒的次數愈少… 翻回去,對得上才收下 它也會讀錯;頁碼讓你馬上查得到

示範用虛構論文,非真實文獻,請勿引用。

想要更深:deeppapernote

一次只讀一篇,讀成一份深讀筆記

PDF一次一篇 取得 PDF 抽出原文 規劃圖表 寫筆記 逐項檢查 存檔 每一階段都有關卡,沒過不往下走 一份深讀筆記 核心資訊原文摘要 貢獻一句話總結 方法與機制流程關鍵結果 限制 圖表佔位 先留位置,確定對得上 才換成真的圖

小節依論文類型調整,順序由它的寫作規格決定。出處:github.com/917Dhj/DeepPaperNote,MIT 授權。

最值得學的規矩

證據不夠就停下來,不准假裝完成

  • fail-closed: if PDF or evidence quality is insufficient, stopPDF 或證據不夠,就停下來跟你要更好的材料。
  • say "complete" only when the required workflow is actually complete整個流程真的跑完,才准說「完成」;只寫好草稿,就只能說草稿。
  • do not treat slowness, inconvenience, or temporary uncertainty as permission to bypass a required stage不准因為慢、麻煩或一時不確定,就跳過必要的階段。

英文為 SKILL.md 原意摘錄。這幾條跟論文無關,抄進你自己的交辦或 Skill,一樣管用。

用它之前

裝它之前,先知道這三件事

01

要 Python 3.10 以上

加上 PyMuPDF。電腦預設的 python3 太舊時,它會自己找新一點的;找不到就停下來告訴你。

02

輸出語言只有兩種

zh-CN(簡體中文)或 en(英文)。沒有繁體中文這個選項。

03

一篇要跑很多階段

每一階段都有檢查,花的用量遠多於一張閱讀卡。只用在核心的 3 到 10 篇。

安裝與第一次啟動

裝好之後,它會先問你兩件事

在終端機貼上
先打 /exit 離開 claude(或另開一個終端機視窗) npx skills add 917Dhj/DeepPaperNote -g -a claude-code -s deeppapernote
  1. 第一次會問 Ok to proceed? (y),看到就按 y、Enter
  2. 沒有 Node.js:在 claude 裡貼上「請幫我把 GitHub 上 917Dhj/DeepPaperNote 裡的 deeppapernote 安裝到 ~/.claude/skills/,裝好告訴我完整路徑。」
  3. 裝好後重開 claude,打 /skills 確認
Q1

存檔模式

workspace:存在目前的工作資料夾。
obsidian:存進你的 Obsidian vault。

Q2

輸出語言

zh-CN 或 en。選了之後,整份筆記從頭到尾都用這個語言檢查。

出處:github.com/917Dhj/DeepPaperNote 授權 MIT。交辦時點名「用 deeppapernote」,告訴它 PDF 的檔名。

怎麼選

大多數論文用卡片,核心幾篇才深讀

deeppapernote
閱讀卡範本(今天練這個)
適合
你會一再引用的核心 3 到 10 篇
文獻回顧裡大多數的論文
產出
一份長筆記,固定小節加圖表佔位
一張六欄的卡,每欄附頁碼
要裝什麼
一支 Skill、Python 3.10 以上、PyMuPDF
什麼都不用裝,一段交辦
語言
簡體中文或英文
你指定的語言,例如繁體中文
之後
照原樣使用
第 9 站變成你自己的 Skill
筆記放哪

一個資料夾就夠,Obsidian 是瀏覽器

ai-research/ summary.mdcandidates.mdnotes/ paper-A.mdpaper-B.mdpaper-C.md 同一批 .md 檔 卡片之間的連結,一眼看得到 它讀的是你本機的資料夾;沒有它,資料夾一樣能用

Obsidian:obsidian.md,個人使用免費。deeppapernote 選 obsidian 模式時,筆記會直接寫進你的 vault。
paper-A、paper-B、paper-C 都是示範用虛構論文,非真實文獻,請勿引用。

換你動手

為你的 PDF
做一張閱讀卡

照六欄範本交辦,每一欄附頁碼,存進 notes 資料夾。

產出notes/[你的檔名].md
練習 03 任務卡

範本整段貼,只換底線與方括號

  1. PDF 放進工作資料夾

    就是第 3 站那篇也可以。確認在 ~/Desktop/ai-research 裡。

  2. 貼上右邊的範本

    換成你的檔名與題目。檔名用英文或數字,不要空格。

  3. 抽一格翻回原文

    在 claude 裡說「把 notes/[你的檔名].md 的內容顯示給我看」;想自己開,Finder 右鍵 → 打開檔案的應用程式 → 文字編輯(Windows 用記事本)。挑一欄照頁碼翻回 PDF。

閱讀卡範本
  1. 讀 [檔名].pdf,照下面的閱讀卡範本做一張卡。
  2. 欄位:研究問題、方法、主要發現、限制、跟我的關係、我為什麼讀它。
  3. 每一欄都附原文頁碼;原文沒寫的,寫「原文未提」。
  4. 「跟我的關係」請對照我的題目:____
  5. 用繁體中文寫,存成 notes/[檔名].md。
檢查點

資料夾裡,長出了 notes/

~/Desktop/ai-research/
  • MDsummary.mdLEG 3
  • MDcandidates.mdLEG 4
  • MDnotes/[你的檔名].mdNEW
  • 六欄都有

    研究問題到我為什麼讀它,一欄都沒少,順序也一樣。

  • 每欄都有頁碼

    沒有頁碼的欄位,要寫「原文未提」,不能空著。

  • 抽一格對得上

    你挑一欄翻回 PDF,那一頁真的有寫這件事。

道路救援

卡住了,先對症狀

!
它寫成一大段摘要交回來的東西沒有分欄
再交辦一次:「照六個欄位逐欄寫,每欄附頁碼」,欄位名稱一字不改貼上。
!
它說讀不到字內容是亂碼,或它說這是圖片
那是掃描檔。換一份數位版 PDF,從期刊網站或圖書館資料庫重新下載。
!
中文變成簡體卡片裡出現簡體字或對岸用語
交辦裡寫明「用繁體中文、臺灣用語」,再請它把整張卡改寫一次。
第 5 站小結

讀懂一篇,留下一張卡

本站帶走 notes/paper-A.md你的是 notes/[你的檔名].md 你的資料夾:3 個檔案。這份閱讀卡範本,到第 9 站會變成你自己的 Skill。
  1. 固定欄位才能比

    六個欄位每張都一樣,卡片才排得成一張表,缺口才看得見。

  2. 頁碼是護身符

    每一欄都翻得回原文。它說的不算,對得上才收下。

  3. 深讀留給核心幾篇

    deeppapernote 一次一篇、階段很多,只用在你會一再引用的那幾篇。

中途休息站

前五站,
走完了。

你的資料夾已經有 summary.md、candidates.md 和 notes/。下半場從動筆之前開始。

LEG 6 / 9
06

動筆之前:
先想清楚要說什麼

這一站不寫任何一句正文。先讓自己被拒一次,再定故事線,最後收出一個守得住的主張。

卡在哪

寫不出來,
常常是還沒想清楚
要說什麼。

小安的計畫書第一段,寫了又刪、刪了又寫。卡住的不是文筆:故事是什麼、主張多大、要拿什麼資料撐,三件事都還沒定。這一站先把這三件事定下來,一句正文都不寫。

寫作線全貌

寫作線四支,順序不能亂

你在這裡 1 paper-planning 第 6 站:先規劃 2 paper-writing 第 7 站:照順序寫 3 sciwrite 第 7 站:一句一句改 4 paper-review 第 8 站:投稿前自審 倒過來做,前面做的都會被後面洗掉:句子改得再漂亮,段落一刪就白做。
paper-planning 是什麼

paper-planning:寫作前的四步

01STORY

故事線

任務、挑戰、洞察、貢獻、優勢,五個要素先講清楚。

02EXPERIMENT

研究設計

要做哪些比較,才撐得住你的主張。原文寫實驗,你讀成研究設計。

03FIGURE

先畫架構圖

動筆前先畫流程圖草圖。畫不出來,代表還沒想清楚。

04TIMELINE

時程

倒推每一節何時寫。Introduction 與 Method 初稿要早點交給指導教授。

四步做完,它一句正文都不寫;正文是下一站的事。

最反直覺的一招

動筆之前,先寫自己的拒稿信

多數人的順序 想一個故事 寫正文 投稿 才知道哪裡會被打 paper-planning 的順序 先寫五條拒稿理由 每條對應要補哪裡 再定故事與設計 最後才寫正文 原文:Draft the top-5 likely rejection comments, then plan experiments that directly preempt each one.

「好像哪裡怪怪的」沒辦法動手;五條拒稿理由,是五條可以補的待辦。

看小安怎麼做

小安先被拒一次,五條各有去處

REVIEWER 2 REJECT
  1. 只有相關,沒有因果

    要補:研究問題與限制,主張收成「關聯」,限制段先講

  2. 手機時間靠自陳,測量效度存疑

    要補:研究方法,改用錄影編碼

  3. 樣本只來自都會區中產家庭

    要補:研究對象,寫清楚抽樣範圍與推論邊界

  4. 「互動品質」定義太寬

    要補:操作型定義,只量回應的延遲與次數

  5. 沒說跟既有 technoference 研究差在哪

    要補:文獻探討,加一段跟既有研究的對照

一張圖講懂

故事線是五個要素串成的鏈

T Task 任務這篇處理什麼問題 C Challenge 挑戰現有做法為什麼解不好 I Insight 洞察你看到的那個關鍵觀察 C Contribution 貢獻你具體提出什麼 A Advantage 優勢為什麼比較好 倒著想:先確定問題與貢獻,再回頭想怎麼引出挑戰。順著寫:T → C → I → C → A。
看小安怎麼做

小安的五要素,每格一句

T

任務TASK

檢視家長手機使用與親子互動品質的關係

C

挑戰CHALLENGE

既有研究多量孩子的螢幕時間,很少量家長;家長手機時間多靠自陳,偏誤大

I

洞察INSIGHT

手機干擾的關鍵不在總時數,而在「孩子發出邀請時,家長回應延遲了多久」

C

貢獻CONTRIBUTION

用錄影編碼的「回應延遲」取代自陳時數

A

優勢ADVANTAGE

測得到干擾發生的那一刻,而不只是一天用了多久

先窄後寬

先凍結一個守得住的最小主張

寬的主張 家長用手機,會傷害親子關係 五條拒稿理由,條條打得中 窄的主張 孩子發出邀請時,家長拿著手機,回應次數較少、延遲較長 只講錄影量得到的次數與延遲

原文:Define the smallest defensible core claim first. Expand only after evidence is strong. 大的方向留到討論,主張先收到最窄。

翻譯一下

原本寫給電腦科學,換個詞就能用

原文的意思
社會科學讀成
實驗
跑模型、比分數
研究設計:蒐集哪些資料,才撐得住主張
比較實驗
跟其他方法比效能
跟既有研究或對照組比,差在哪
消融研究
拿掉一個模組,看效果掉多少
分析比較:換一種測量、拿掉一個變項,結論還站得住嗎
基準方法
目前最強的做法
既有研究的做法與發現
流程圖
模型的架構圖
研究架構圖:變項怎麼連起來
安裝

裝 paper-planning,一句就好

兩種裝法,挑一種
方法 A 交辦給 Claude 幫你裝(在 claude 裡貼上;沒有 Node.js 的人走這條) 請幫我把 GitHub 上 EvoScientist/EvoSkills 裡的 paper-planning 安裝到 ~/.claude/skills/,裝好告訴我完整路徑。 方法 B 自己打指令:先打 /exit 離開 claude(或另開一個終端機視窗);npx 第一次會問 Ok to proceed? (y),看到就按 y、Enter npx skills add EvoScientist/EvoSkills -g -a claude-code -s paper-planning
指令跑完或它說裝好了 重開 claude新裝的才讀得到 /skills叫出清單 看到它就成功paper-planning 出處:EvoScientist/EvoSkills,Apache-2.0 授權。它只讀寫檔案與思考,不跑任何腳本,不用另外裝套件。
換你動手

先被拒一次,
再寫五要素

拿你自己的題目,讓它扮演會給你拒稿的審稿人。

產出story.md
練習 04 任務卡

三步,拒稿理由先讀

  1. 換成你的題目

    還沒有題目,就用你手上那篇 PDF 的標題。

  2. 貼上交辦,先讀拒稿理由

    讀了不舒服是正常的。五要素裡填不出來的那一格,就是你要補的地方。

  3. 打開 story.md 看內容

    在 claude 裡說「把 story.md 的內容顯示給我看」;想自己開,Finder 右鍵 → 打開檔案的應用程式 → 文字編輯(Windows 用記事本)。

交辦(照打,換成你的題目)
  1. 用 paper-planning 幫我規劃這篇論文:(你的題目)
  2. 先不要寫任何正文
  3. 假設這篇被拒了,用審稿人的語氣寫五條最可能的拒稿理由,每條標出我該補強哪一節
  4. 再寫故事線五要素:Task、Challenge、Insight、Contribution、Advantage,每格一句可以檢驗的句子
  5. 最後寫一句我守得住的最小主張
  6. 存成 story.md
檢查點

資料夾多了 story.md

~/Desktop/ai-research
  • 03summary.md
  • 04candidates.md
  • 05notes/[你的檔名].md
  • 06story.mdNEW
  • 五條拒稿理由,各對應一節

    每條後面都寫著要補哪裡:方法、文獻、限制。

  • 五要素每格一句

    有具體的對象或變項,不是「具有重要意義」這種口號。

  • 你守得住那個主張

    有人問「你怎麼證明」,你說得出要用哪一份資料回答。

道路救援

卡住了,先看這三種

!
它直接寫起正文story.md 裡出現一整段 Introduction
再說一次「只做規劃,不要寫任何正文」。句首寫「用 paper-planning」,確定是它在做。
!
拒稿理由太客氣「本研究或可再加強……」
要求它用會給拒稿的審稿人語氣,每條一句,直接講缺陷在哪。
!
五要素寫成口號「本研究具有重要貢獻」
要求每格一句可以被檢驗的句子:有對象、有變項、有做法。
第 6 站小結

動筆之前,你帶走一張藍圖

本站帶走 story.md五條拒稿理由、故事線五要素、一句最小主張。 資料夾現在有 4 個檔案。下一站:照著 story.md 動筆,再一句一句改。
  1. 先想清楚,再動筆

    paper-planning 不寫正文,它幫你決定要說什麼。

  2. 先被拒一次

    五條拒稿理由,就是五條可以動手補的待辦。

  3. 主張收窄才守得住

    先凍結一個有證據撐的最小主張,證據夠了再往外擴。

LEG 7 / 9
07

寫與改:
順序對了,字才改得動

先照 paper-writing 的順序寫,再用 sciwrite 一句一句清乾淨。AI 腔,另外處理。

卡在哪

從引言第一句寫起,第三段就卡死

第一句很順 第一段還行 第二段開始卡 第三段寫不下去 此路不通 引言要宣稱的貢獻,取決於你的方法實際做到什麼。 方法還沒寫,引言就寫不下去。卡住的是順序,文筆沒有問題。
paper-writing 的 11 步

11 步,順序就是重點

1畫流程圖草圖 2設計故事與實驗 3寫 Method 4修引言與方法 5寫 Experiments 6精修圖 7寫 Related Work 8自我審查 9寫摘要與結論 10選標題 11反覆修訂 黃色三格跟多數人的習慣相反:先畫圖,Method 先寫成,摘要到第 9 步才寫。
三條反直覺

三格黃色,跟你的習慣正好相反

09ABSTRACT

摘要到第 9 步才寫

摘要是全篇的壓縮。全篇還在變,摘要寫了也要重寫。

03METHOD

Method 比引言先寫成

引言在第 2 步只列寫作計畫,第 3 步寫 Method,第 4 步才回頭修引言。引言要宣稱的,看方法做到什麼。

01FIGURE

第一步是畫圖

先畫流程圖草圖,社會科學就是研究架構圖。畫不出來,方法就還沒想清楚。

看小安怎麼寫

引言第一段,照這個順序走

小安的計畫書 引言第一段(教學示範)

1家長陪孩子玩時滑手機,已是許多家庭的日常;這會不會影響親子互動,是幼兒教育關心的問題。2既有研究多量孩子自己的螢幕時間,較少量家長。3少數量了家長的研究,多靠家長自陳一天用多久,偏誤大,也看不到干擾發生的那一刻。4本研究以錄影編碼孩子發出邀請到家長回應之間的延遲,取代自陳時數。5這讓我們測得到干擾發生的那一刻,而不只是一天用了多久。

反模式:不要寫成「先給一個天真的做法,再給我們的改進」,研究會看起來只是小修小補。
1 任務

這篇處理什麼問題

2 既有做法

前人量了什麼

3 挑戰

為什麼還解不好

4 我們的做法

你提出什麼

5 優勢

為什麼比較好

一個自我檢查

三句話測驗:講不清楚,就還沒想清楚

1

我們現在知道什麼

小安想確立的是:共玩時家長拿著手機,回應孩子的邀請比較慢。

2

我們還不知道什麼

小安:這是因果還是相關,橫斷面設計回答不了。

3

為什麼重要

小安:給家長的建議可以更具體:孩子叫你的那一刻,先放下手機。

想像要向聰明但不同領域的人解釋這篇。三句寫不乾淨,結論就還沒好。這三題是 Vista 自己的寫作習慣,不在 paper-writing 裡;想讓 AI 幫你檢查,把三題直接寫進交辦。

安裝兩支

裝好之後,sciwrite 不叫 sciwrite

兩支都要裝,兩種裝法挑一種
方法 A 交辦給 Claude 幫你裝(在 claude 裡貼上,一次一句) 請幫我把 GitHub 上 EvoScientist/EvoSkills 裡的 paper-writing 安裝到 ~/.claude/skills/,裝好告訴我完整路徑。 請幫我把 GitHub 上 labarba/sciwrite 安裝到 ~/.claude/skills/,裝好告訴我它在 /skills 裡叫什麼名字。 方法 B 自己打指令:先打 /exit 離開 claude(或另開一個終端機視窗);npx 第一次會問 Ok to proceed? (y),看到就按 y、Enter npx skills add EvoScientist/EvoSkills -g -a claude-code -s paper-writing npx skills add labarba/sciwrite -g -a claude-code

清單裡找 manuscript-writing-review,交辦也寫它。

sciwrite 是什麼

每個字,
都要掙到它的位置。

sciwrite 是句級寫作體檢。方法論來自 Stanford 的 Kristin Sainani 開的課 Writing in the Sciences;作者 Lorena A. Barba 把它寫成 skill,以 CC BY 4.0 授權:可以改、可以分享,但要署名,並註明改過哪裡。

原文:every word must earn its place; every sentence must be stripped to its cleanest components.

一張圖講懂

五道稽核,依序跑

1 清累贅Due to the fact that→ Because 2 主動語態與動詞Provides a review of→ Reviews 3 句子結構主詞離動詞太遠就標出來 4 術語一致香蕉就叫香蕉不換同義詞 5 數字與引用摘要的 N對得上表 1 嗎 一道只看一個面向,依序跑完。每個問題都標嚴重度:CRITICAL、MAJOR、MINOR。 它的對照表是英文;中文的「進行……之探討」是同一種病:被悶死的動詞。
它的界線

你為每個論點負責,它只為每個字負責

只動
字句不動你的論點、數字和引用。

不做它不碰的

  • 改你的論點與研究內容:覺得有問題,只標記不動手
  • 替你改數字和引用:第 5 道只檢查對不對得上
  • 評估方法、結果與統計
  • 整理引用格式

會做它守的規矩

  • 每個建議都附原文與具體改法
  • 尊重學門慣例:有些領域的方法段就是用被動
  • 保留你的聲音:句子清楚就不硬改
  • 不確定目標期刊時,先問你
看小安的那一句

摘要第一句,分兩步改

改前 44 字

本研究旨在針對家長使用智慧型手機之行為對於幼兒親子互動品質所可能產生之影響進行深入之探討。

真正的動作只有「探討」,被「進行深入之」悶成了名詞。

步驟一 sciwrite 只動字

本研究探討家長使用智慧型手機對幼兒親子互動品質的影響。

刪累贅、救回動詞。主張原封不動,還是「互動品質」。

步驟二 小安自己收窄

本研究探討家長使用智慧型手機時,是否降低回應幼兒的頻率。

換成第 6 站凍結的主張。這一步是小安的判斷,sciwrite 不會替你做。

怎麼餵它

不要整篇丟,一次一段

摘要引言第一段結論第一段 一次只丟一段 整篇丟進去,回來的是一份長報告,問題多到你逐條判斷不完。 interactive 模式 一段一段來,附改前改後與理由,每段停下來等你確認才往下。 Vista 的做法:先挑左邊三段 審稿人第一眼讀的就是這三段,其他的等定稿再說。
四種模式

四種模式,挑一種就好

full-review全篇
  • 你說「review my manuscript」
  • 五道全跑,給一份結構化報告
  • 話說得不清楚時,它預設用這個
section-review單節
  • 你說「review the Introduction」
  • 只對一節跑五道
  • 適合一節一節交給它
targeted指定項目
  • 你說「fix passive voice」
  • 只跑你點名的那一兩道
  • 它改太多時,換成這個
interactive互動
  • 你說「walk me through improving this」
  • 一段一段,附改前改後與理由
  • 每段等你確認,練習用這個
另一種病:AI 腔

academic-humanizer:三樣不准改

數字

數字一個不動

它只動語言,內容原樣保留。
數字一改,就是造假。

結果

結果一條不加

宣稱比證據強,它把動詞降級,
不會替你補出結果。

引用

引用原樣保留

每一筆引用都留著,
它只檢查宣稱有沒有掛到出處。

它也不是用來規避 AI 揭露的:用了它,你仍要照期刊規定揭露。

需要時再裝,指令見最後的安裝清單。

兩支怎麼分

兩支改稿工具,看病從哪來

你的稿子讀起來不順 sciwrite 人類學術寫作的老毛病 累贅片語、被悶死的動詞、被動語態、換來換去的術語 academic-humanizer AI 協作留下的腔調 delve、pivotal 這類 AI 詞彙、動詞比證據強、公式化開場 兩支會打架:sciwrite 允許用破折號做強調,humanizer 要全刪。這時由你裁決。
改稿的順序

由大到小,句子最後才改

架構STEP 1

故事線與章節順序對不對,拿 story.md 來對照。

段落STEP 2

一段只講一件事,第一句就說這段要講什麼。

句子STEP 3

最後才輪到 sciwrite。段落一刪,改好的句子就白改了。

換你動手

拿你自己的一段,
跑一次句級體檢

只挑一段,逐條看理由,自己決定收不收。

產出abstract-v2.md
練習 05 任務卡

三步,只挑一段

  1. 挑一段你自己寫的

    摘要、引言第一段或結論第一段,三選一。沒有論文的人,用研究計畫的摘要。

  2. 貼上交辦

    interactive 模式會一段一段給改前改後與理由,等你確認。

  3. 逐條回覆收或不收

    每一條你回覆收或不收;全部決定完,再說「照我收下的版本存成 abstract-v2.md」。

交辦(照打,最後貼上你的那一段)
  1. 用 manuscript-writing-review 的 interactive 模式,幫我改下面這一段
  2. 只改字,不要改我的論點、數字和引用
  3. 每一處修改都附上理由
  4. 改前與改後並列
  5. 先讓我逐條決定收或不收,我說存檔時再存成 abstract-v2.md
  6. (貼上你的那一段)
檢查點

資料夾多了 abstract-v2.md

~/Desktop/ai-research
  • 03summary.md
  • 04candidates.md
  • 05notes/[你的檔名].md
  • 06story.md
  • 07abstract-v2.mdNEW
  • 改前改後並列

    在 claude 裡說「把 abstract-v2.md 的內容顯示給我看」;想自己開,Finder 右鍵 → 打開檔案的應用程式 → 文字編輯(Windows 用記事本)。

  • 每處修改都有理由

    每一條都說得出屬於哪一道:累贅、動詞、句構、術語、數字。

  • 你逐條決定收或不收

    收的打勾,不收的寫一句理由。最後的版本是你決定的。

道路救援

卡住了,先看這三種

!
它把整段重寫了改後的句子你認不出來
改用指定項目模式,例如「只跑清累贅與主動語態兩道,其他不要動」。
!
叫不出 sciwrite它說找不到這支 skill
它的名字是 manuscript-writing-review。剛裝完先重開 claude,打 /skills 確認,交辦時寫這個名字。
!
改完意思變了「可能影響」變成了「影響」
退回:「這句意思變了,只能動字,請改回原本的主張強度。」
每一處你收下的修改,
你都說得出為什麼嗎?

倫理檢查點:說不出來的,先不要收。
論文上署的是你的名字,負責的也是你。

第 7 站小結

先寫順,再改清楚

本站帶走 abstract-v2.md一段改前改後,每處附理由,收不收由你決定。 資料夾現在有 5 個檔案。下一站:投稿之前,先讓自己被審一次。
  1. 照順序寫

    先畫圖,Method 先寫成,摘要到第 9 步才寫。

  2. 一次改一段

    sciwrite 只動字;交辦時寫 manuscript-writing-review。

  3. AI 腔另外洗

    academic-humanizer 不改數字、結果與引用,也不能拿來規避揭露。

LEG 8 / 9
08

投稿之前:
先被自己拒一次

審稿人會問的問題,最好由你先問完。這一站只示範,不練習。

卡在哪

友善的同學看不出問題,審稿人一眼就看出來

友善的同學 「寫得很順啊,看不出問題。」 他想幫你,所以往好的地方看 審稿人 只有相關,沒有因果 手機時間靠自陳 互動品質定義太寬 同一份稿子,三個地方被圈起來 他的工作,就是找拒絕的理由
paper-review 是什麼

投稿前,模擬一位會拒稿的審稿人

1不看清單當自己是懷疑你的專家從頭讀到尾每個疑點記下位置 2五面向清單補上廣度抓常見的拒稿模式 3機械式掃描前後數字對不對得上摘要承諾的,結論有沒有交 合併三輪聯集重複的才刪沒證實的疑點也留著 順序不能反:先打開清單,你就只看得到清單上寫的問題。
第二輪的清單

五個面向,各用一句拒稿口吻開場

1

貢獻充分性

「這篇沒有帶給讀者新的知識。」

2

寫作清晰度

「細節不夠,別人重做不出來;某一步沒交代為什麼需要它。」

3

結果品質

「只比過去的做法好一點;或者好一些,但還是不夠好。」

4

測試完整性

「少了關鍵的比較對象與指標,資料也太簡單。」

5

方法設計

「設定不切實際,方法不夠穩健,代價大過好處。」

原文寫給電腦科學。換成社會科學時,「比較對象」讀成既有研究,「消融實驗」讀成分析比較,跟第 6 站的翻譯表一樣。

最常被直接拒的一種

摘要與引言的每一個主張,問三題

小安計畫書第一章的一句 既有研究多半測量 孩子的螢幕時間, 很少測量家長。 1事實正確嗎原文真的這樣說 2有證據嗎引了哪幾篇 3證據在哪一頁翻得到才算 留下標出處 刪掉或改弱 沒有直接證據的強主張,刪掉比辯護更划算。審稿人會因為一句撐不住的話拒掉整篇。
看小安的自審報告

review.md:結論、五面向、前三優先

review.md~/Desktop/ai-research/
# 計畫書自審(三輪合併)
## 結論
主張走得比證據遠,投出去會被要求大修。
## 五個面向
貢獻充分性 跟既有 technoference 研究差在哪,沒寫
寫作清晰度 「互動品質」三章各有一種說法
結果品質  計畫書階段還沒有結果,先略過
測試完整性 回應延遲怎麼編碼、誰來編,沒交代
方法設計  樣本只來自都會區中產家庭
## 前三優先修改
1. 寫出回應延遲的編碼規則,附一個例子(第 3 章)
2. 補一段跟 technoference 研究的差異(第 2 章)
3. 摘要的「影響」改成「關聯」,因果放進限制

先看結論那一句

會不會被拒、為什麼,一句話講完。

再看前三優先

只挑三件,每件都指到第幾章。沒有結果的面向就寫沒有,不硬湊。

小安的計畫書與這份自審報告,都是虛構的教學示範。

收到審稿意見之後 paper-rebuttal

每一條意見先上色,字數照顏色分

答辯書的字數預算 60% 30% 10% 紅:左右分數的關鍵疑慮這一條沒解決,分數就不會動。最先回,放最多證據。 橘:可以解決的疑慮用具體資料或修改內容回應 灰:小問題簡短致謝,確認已改 綠:正面評語不用花字數回應。記下來,留給支持你的審稿人當彈藥。 每一條照三段寫:我理解這個疑慮、我的回應與證據、我改了哪一節。
paper-rebuttal 最反直覺的一條

答辯書真正的讀者,
是支持你的那位審稿人。

他會在討論階段替你說話,常常直接引用你的原句。所以關鍵論點要寫成可以直接複製貼上的句子,先講這篇做得好的地方,再談弱點。

被拒了,回哪一站

常見的拒稿理由,都對得回前面某一站

「貢獻不清楚」06動筆之前回去重寫五要素,先凍結一個守得住的最小主張(story.md)
「寫得不清楚」07寫與改一次一段跑句級體檢,從摘要第一句開始(abstract-v2.md)
「文獻不足」04找文獻補評分表,再找一輪,每篇附引句(candidates.md)
「引用跟原文對不上」05讀文獻拿閱讀卡上的頁碼,一格一格翻回原文(notes/)
「主張超過證據」08投稿之前主張稽核問三題,撐不住的那一句刪掉
安裝

paper-review 與 paper-rebuttal,一起裝

跟第 4 站
一樣兩種裝法

方法 A 交辦給 Claude 幫你裝,沒有 Node.js 走這條。方法 B 自己打 npx 指令。

裝完重開 claude,打 /skills,兩支都看得到就成功。

終端機
方法 A 交辦給 Claude 幫你裝(在 claude 裡貼上)
  1. 請幫我把 GitHub 上 EvoScientist/EvoSkills 裡的 paper-review 與 paper-rebuttal 安裝到 ~/.claude/skills/,裝好告訴我完整路徑。
方法 B 自己打指令:先打 /exit 離開 claude(或另開一個終端機視窗) npx skills add EvoScientist/EvoSkills -g -a claude-code -s paper-review npx skills add EvoScientist/EvoSkills -g -a claude-code -s paper-rebuttal 第一次會問 Ok to proceed? (y),按 y 再按 Enter。
為什麼這一站沒有黃色頁

自審要對著一份完整的稿子

這一站
不練習

paper-review 開始之前,會先確認稿子每一節都寫完、主張都有證據、有限制一節、圖表已定稿。沒寫完,它會請你先寫完。

所以回家拿你真的要投的那一篇,在投稿前跑一次:

交辦給 Agent
  1. 用 paper-review 自審我的稿子 draft.md,三輪都要跑,結果存成 review.md

稿子是 Word 檔:先另存成 PDF,放進 ai-research,交辦時把 draft.md 換成那個檔名。看結果:在 claude 裡說「把 review.md 的內容顯示給我看」;想自己開,Finder 右鍵 → 打開檔案的應用程式 → 文字編輯(Windows 用記事本)。

第 8 站小結

資料夾裡,第六個檔案

~/Desktop/ai-research
  • MDsummary.md03
  • MDcandidates.md04
  • MDnotes/[你的檔名].md05
  • MDstory.md06
  • MDabstract-v2.md07
  • MDreview.md回家做
  1. 先被自己拒一次

    三輪自審:不看清單通讀、五面向、機械式掃描。

  2. 每個主張問三題

    事實對嗎、有證據嗎、在哪一頁。撐不住就刪。

  3. 答辯照顏色分字數

    紅六成、橘三成、灰一成,綠色留給支持你的人。

review.md 是小安的示範。你的那一份,會在投稿前長出來。下一站:把這些檔案串成一條路。

LEG 9 / 9
09

串成一條路:
寫你的第一支 Skill

前面每一站都在用別人寫的說明書。這一站,你把自己的做法寫下來。

回頭看

走到這裡,你的資料夾長這樣

~/Desktop/ai-research
  • MDsummary.md03
  • MDcandidates.md04
  • MDnotes/[你的檔名].md05
  • MDstory.md06
  • MDabstract-v2.md07
  • MDreview.md回家做
  • MD~/.claude/skills/reading-card/SKILL.mdNEW
7

七個檔案,一站一個

前六個是研究產出,留在你的研究資料夾。最後一個不一樣:它放在 ~/.claude/skills/,是你這一站要寫的說明書。

一條工作流

每一站的產出,就是下一站的材料

04candidates.md找文獻 05notes/paper-A.md讀文獻 06story.md動筆之前 07abstract-v2.md寫與改 08review.md投稿之前 挑出要精讀的卡片變成證據決定要寫什麼改好的拿去審 少了哪一個,下一站就要從頭講。檔案留得住,路才接得起來。
複利真正發生在哪

每轉一圈,說明書多一條規則

每轉一圈 多一條規則 下一圈的地板更高 1交辦:讀一篇 2產出一張卡 3檢查:翻回頁碼 4寫回SKILL.md

複利不在產出,
在第 4 步。

多數人做到第 3 步就停了:發現錯,手動改掉,下一次再錯一次。

第 4 步只要補一行字。補了之後,那個錯就不會再出現。

你手上已經有了

第 5 站的閱讀卡範本,就是一支 Skill 的草稿

現在:每次都要貼一整段

照閱讀卡範本讀 paper-A.pdf,六個欄位:研究問題、方法、主要發現、限制、跟我的關係、我為什麼讀它,每一欄附頁碼,用繁體中文,存成 notes/paper-A.md。

漏一欄、打錯一個字,這張卡就跟其他卡對不起來。

寫成 Skill 之後

用 reading-card 讀 paper-A.pdf。

欄位、頁碼、語言、存檔位置,都寫在 SKILL.md 裡。你只講一句話,每一次都一樣。

paper-A.pdf 是示範用虛構論文,非真實文獻,請勿引用。

最小單位

一個資料夾、一份 SKILL.md、兩個必填欄位

~/.claude/skills/ reading-card/ SKILL.md必要 SKILL.md 最上面這一段 --- name: reading-card description: 它做什麼、何時叫它 --- name 建議跟資料夾同名 用小寫英文與連字號,不要空白 description AI 靠這一句決定要不要叫它 下一頁講怎麼寫 scripts、references 這些都可以沒有。今天這一支,只有一個檔案。
description 怎麼寫

它靠這一句名片,決定要不要叫你這一支

叫不出來的寫法
description: 閱讀卡
  • 沒說它做什麼
  • 沒說什麼時候該叫它
  • 你說「幫我精讀這篇」,它對不上
叫得出來的寫法
description: 替一篇論文 PDF 做閱讀卡。使用者說「做閱讀卡」「用 reading-card 讀這篇」或要精讀筆記時使用。
  • 第一句講它做什麼
  • 第二句列出你平常會講的話
  • 可以學 paper-review 的寫法:寫 Use when,也寫 Do NOT use
看小安的第一支 Skill

reading-card/SKILL.md,完整檔案

SKILL.md~/.claude/skills/reading-card/
---
name: reading-card
description: 替一篇論文 PDF 做閱讀卡。使用者說「做閱讀卡」「用 reading-card 讀這篇」或要精讀筆記時使用。
---
# 閱讀卡
讀使用者指定的 PDF,照下面六欄寫,存成 notes/<PDF 檔名>.md。
1. 研究問題
2. 方法
3. 主要發現
4. 限制
5. 跟我的關係
6. 我為什麼讀它
## 規則
- 照順序寫,一欄都不能少
- 每一欄都附原文頁碼
- 一律用繁體中文
- 「跟我的關係」對照我的題目:(你的題目)
- 原文沒寫的欄位寫「原文未提」

上段:名片

只有 name 與 description 兩個必填。

中段:六欄

就是第 5 站的閱讀卡,寫成編號清單。

下段:規則

它錯一次,你就在這裡補一條。

換你動手

寫你的第一支 Skill

把第 5 站的閱讀卡範本,存成一份 AI 自己會翻的說明書。

產出~/.claude/skills/reading-card/SKILL.md
練習 06 任務卡

五步,寫好、重開、確認

  1. 建資料夾

    在終端機打右邊第一行。

  2. 請 Claude 寫檔

    進 claude,交辦右邊那句。範本可直接從簡報頁面選取複製。

  3. 改成你的欄位

    欄位與規則換成你的,名片留著。

  4. 重開 claude

    打 /exit 再打 claude,或關掉視窗開新的。

  5. 確認

    打 /skills,看得到 reading-card。

終端機
先打 /exit 離開 claude(或另開一個終端機視窗) mkdir -p ~/.claude/skills/reading-card cd ~/Desktop/ai-research claude
  1. 請在 ~/.claude/skills/reading-card/ 建立 SKILL.md,name 是 reading-card,description 寫「讀一篇論文 PDF,照六個固定欄位做繁體中文閱讀卡,每欄附頁碼」,內文照我第 5 站閱讀卡的六欄與規則。
寫好之後打 /exit,再進一次 claude /skills
試跑

試跑一次,一欄一欄對照

你說用 reading-card讀 paper-A.pdf,存成 notes/paper-A-v2.md SKILL.md 寫的六欄 1. 研究問題2. 方法3. 主要發現4. 限制5. 跟我的關係6. 我為什麼讀它 notes/paper-A-v2.md 研究問題第 2 頁 方法第 4 頁 主要發現第 6 頁 限制第 9 頁 跟我的關係第 6 頁 我為什麼讀它第 4 頁 另存 -v2,第 5 站那張不會被蓋掉。對三件事:用上 reading-card、欄位順序、每欄頁碼。

示範用虛構論文,非真實文獻,請勿引用。頁碼與第 5 站的閱讀卡一致。

檢查點 練習 06

三件事打勾,你的第一支 Skill 才算上路

~/Desktop/ai-research
  • MDsummary.md03
  • MDcandidates.md04
  • MDnotes/[你的檔名].md05
  • MDstory.md06
  • MDabstract-v2.md07
  • MDreview.md回家做
  • MDnotes/[你的檔名]-v2.mdNEW
  • MD~/.claude/skills/reading-card/SKILL.mdNEW
  • /skills 看得到它

    清單裡有 reading-card。看不到,先翻下一頁。

  • 卡片欄位跟你寫的一樣

    在 claude 裡說「把 notes/[你的檔名]-v2.md 的內容顯示給我看」;想自己開,Finder 右鍵 → 打開檔案的應用程式 → 文字編輯(Windows 用記事本)。名稱、順序、頁碼,一格一格對。

  • 改一條規則,再跑一次真的變了

    例如加一欄「可以引用的一句話」,重開再跑,新卡多了那一欄。

道路救援 練習 06

卡住了,先對症狀

/skills 看不到清單裡沒有你剛寫的那一支
先重開 claude。再確認路徑是 ~/.claude/skills/reading-card/SKILL.md,檔名 SKILL.md 要全大寫。
它沒自動叫出來交辦了,它照自己的方式讀
description 太籠統。把你會講的話寫進去;急用時句首直接寫「用 reading-card」。
它不照欄位少一欄,或自己多加欄位
欄位名稱跟範本一字不差,並加一條規則「照這個順序寫」。
讓它長大

它每做錯一次,你就補一條

它做錯了你在 SKILL.md 的規則補一條 ! 限制欄混進它自己的推測分不出哪句是作者說的 +1- 限制只寫作者自己承認的你的推測另外標「推論」 ! 頁碼寫成 PDF 檢視器的頁數翻回期刊原文對不上 +1- 頁碼用論文印出來的頁碼期刊版面上印的那個數字,翻得回原文 ! 方法欄寫成一整段三十張卡排在一起沒辦法比 +1- 方法不超過三行設計、樣本、測量,各一行 每一條都來自一次真的做錯。用久了,這份說明書會比任何人給你的範本都合身。
換你挑別人的 Skill

網路上的 Skill 一大堆,用這六個判斷標準挑

01

授權寫清楚了嗎

找不到授權檔就跳過。你不知道能不能用、能不能改、能不能給學生。

02

說得出為什麼這樣設計

好的會交代它解決什麼痛點。說不出來的,多半只是換了檔名的 prompt。

03

明說別用在什麼

只寫優點、不寫邊界,代表作者沒真的用過。

04

會不會唬爛你

好的會寫死「證據不夠就停下來」,不准交出降級的成品。

05

相依有多重

純文字的最好搬。要裝套件、申請金鑰的,先確認你真的需要。

06

維護模型合理嗎

純規則的半年沒動很正常;有程式、接 API 的半年沒動要小心。

工具箱地圖

今天沒走的六個出口,遇到了再下交流道

EXIT 1research-survey手上已有 30 篇以上,要寫一份完整的文獻回顧報告 EXIT 2paper-graph想看一個領域怎麼演化、缺口在哪;一定要有 S2 金鑰 EXIT 3research-ideation大方向清楚,具體題目想不出來;先畫完 paper-graph 再用 EXIT 4experiment 三支結果不如預期要診斷、流程要講好預算、要寫分析程式;質性也用得上 EXIT 5PaperBrain深讀筆記超過三十份,要跨篇比較;Vista 自製,要 Node.js 20 以上 EXIT 6換到 Codex想在 Codex 用同一批 skill;路徑改成 ~/.agents/skills/
工具箱的使用守則

不要一次全裝。
裝太多,名片會被截斷,
它反而叫錯。

AI 平常只看每一支的 description。裝得愈多,每一張名片分到的空間愈少。先把今天這幾支用熟,卡在哪一格,再去對應的出口。

第 9 站小結

九站走完,你有了自己的說明書

本站帶走 reading-card你自己寫的第一支 Skill 最後一站:抵達。帶什麼回家。
  1. 產出串成一條路

    每一站的檔案,都是下一站的材料。

  2. Skill 是寫下來的交辦

    一個資料夾、一份 SKILL.md、兩個必填欄位。

  3. 錯一次,補一條

    複利來自你寫回去的那一行。

抵達

如果今天只記得三件事

01

交辦,不是問答

給目標、給材料、講格式、要它存成檔案。產出留在你的資料夾,下週還找得到。

02

打開看到才算完成

它說「完成」不算。每一格都翻得回原文頁碼,才放進你的論文。

03

有效的做法寫回去

錯一次就在 SKILL.md 補一條。下一次研究的地板,就比這一次高。

回家三十天

回家之後,一次只加一條線

DAY 1-10只用文獻線paper-navigator 找reading-card 讀把手上的 15 篇跑一遍 DAY 11-20加上寫作線paper-planning 先想清楚paper-writing 寫一節sciwrite 只修關鍵段落 DAY 21-30補你卡住的那一格讀不完:deeppapernote要投稿:paper-review題目卡住:翻工具箱地圖 一次全用會噎住,而且你分不出哪一支真的有用。剩下的,等遇到那一格再裝。
安裝清單

今天用到的,加上你自己的那一支

站SkillGitHub 來源方法 B 自己打 npx 指令(要有 Node.js)
04paper-navigatorEvoScientist/EvoSkillsnpx skills add EvoScientist/EvoSkills -g -a claude-code -s paper-navigator
05deeppapernote917Dhj/DeepPaperNotenpx skills add 917Dhj/DeepPaperNote -g -a claude-code -s deeppapernote
06paper-planningEvoScientist/EvoSkillsnpx skills add EvoScientist/EvoSkills -g -a claude-code -s paper-planning
07paper-writingEvoScientist/EvoSkillsnpx skills add EvoScientist/EvoSkills -g -a claude-code -s paper-writing
07sciwrite裝好叫 manuscript-writing-reviewlabarba/sciwritenpx skills add labarba/sciwrite -g -a claude-code
08paper-reviewEvoScientist/EvoSkillsnpx skills add EvoScientist/EvoSkills -g -a claude-code -s paper-review
09reading-card你自己寫的自己寫mkdir -p ~/.claude/skills/reading-card 再請 Claude 寫 SKILL.md
07academic-humanizer需要時再裝AIScientists-Dev/
academic-humanizer
npx skills add AIScientists-Dev/academic-humanizer -g -a claude-code
08paper-rebuttal收到審稿意見再裝EvoScientist/EvoSkillsnpx skills add EvoScientist/EvoSkills -g -a claude-code -s paper-rebuttal

方法 B 先打 /exit 離開 claude(或另開一個終端機視窗)再貼指令;第一次會問 Ok to proceed? (y),按 y 再按 Enter;裝完重開 claude。

方法 A 交辦給 Claude 幫你裝:在 claude 裡貼「請幫我把 GitHub 上 EvoScientist/EvoSkills 裡的 paper-navigator 安裝到 ~/.claude/skills/,裝好告訴我完整路徑。」,換掉 GitHub 來源與 skill 名稱。

出處與授權

四個來源,四張車牌

LICENSEApache-2.0 EvoSkillsgithub.com/EvoScientist/EvoSkills附授權全文與版權聲明,改過的檔案要標示已變更 LICENSEMIT DeepPaperNotegithub.com/917Dhj/DeepPaperNote保留版權聲明與授權全文 LICENSECC BY 4.0 sciwritegithub.com/labarba/sciwrite署名作者 Lorena A. Barba、附授權連結、註明是否修改過 LICENSEMIT academic-humanizergithub.com/AIScientists-Dev/academic-humanizer保留版權聲明與授權全文 本課程只給連結,不重製、不打包散布:授權義務留在上游。 sciwrite 是唯一的 CC BY 4.0,連改它的名字都算修改,分享改過的版本時要註明。
附錄 A Semantic Scholar 金鑰

申請表只問三件事,寫得合理就過

Request an API key EMAIL學校或機構信箱 PROJECT USE英文 50 字以上 ENDPOINTSsearch、details REQUESTS/DAY1,000 以內 semanticscholar.org/product/api 1 2 3 4 拿到金鑰之後,設成永久環境變數 MACOSecho 'export S2_API_KEY="你的金鑰"' >> ~/.zshrc貼進終端機,關掉終端機再重開 WINDOWS POWERSHELLsetx S2_API_KEY "你的金鑰"再重開 PowerShell 或交辦「請幫我把 S2_API_KEY 設成永久環境變數」 設好之後,重開 claude 才會生效 1 用學校或機構信箱免費信箱網域,官方已不受理 2 用途用英文寫滿 50 字只寫 For academic research. 一定被退 3 只填需要的 endpoint只做文獻檢索,填這兩條就夠 4 流量誠實估,1,000 以內個人研究寫十萬次,只會讓人起疑 5 拿到金鑰不要公開,不貼 GitHub、不貼網頁 人工審核,用 E-mail 寄送,要等幾天。 沒有金鑰也跑得動,只是會退回 arXiv。
附錄 B 卡關總表

八個最常見的卡關,症狀對了就照著修

站症狀原因解法
03打 claude 說找不到指令PATH 還沒生效關掉終端機開新視窗,打 claude --version
03macOS 跳出「安裝命令列開發者工具」系統要補裝工具按「安裝」,裝完再繼續
04交辦了,它沒用 skill交辦沒點名句首寫「用 paper-navigator」
04找到的全是電腦科學沒有 S2 金鑰,退回 arXiv申請金鑰,見附錄 A
05PDF 讀不到字,或中文變簡體掃描檔無文字層;沒指定語言換數位版 PDF;寫明「用繁體中文」
05pip 打不動,或沒有 Python電腦缺套件或 Python交辦 Claude「請幫我安裝需要的套件」
07叫不出 sciwrite裝好的名字不一樣改叫 manuscript-writing-review
09/skills 看不到新的那支沒重開、路徑或檔名不對重開 claude;檔名是全大寫 SKILL.md
最常被問的兩題

Skill 會舊,流程不會

Q

這些 skill 會不會過時?

會,而且應該會。

它們都是純文字,你隨時可以改。不會過時的是今天練的流程:交辦、檢查、寫回去。

Q

我可以自己改嗎?

可以,也應該改。

觸發詞、輸出格式、檢查規則都能依你的領域改。改了留紀錄;sciwrite 改了還要註明。

這條流程是骨架。哪一格不順,就換那一格的工具。

回去之後

怎麼跟上:三個出口

EXIT 1 研究者基地researcher.tw課程、資源庫與文章都在這裡 EXIT 2 電子報iamvista.substack.com新工具與新做法,寄到你信箱 EXIT 3 個人網站vista.twVista(鄭緯筌)的文章與近況 回家卡住了,也歡迎到臉書社團「博碩士生練功團」問。
課後回饋

最後一件事,請幫我填一份回饋

拿起手機,
掃一下就到。

tally.so/r/NpNJqO

你的回饋會直接影響下一版怎麼排。特別想知道:哪一站太快、哪一站太慢、哪一個練習最有用。

課後回饋表單 QR Code,網址 tally.so/r/NpNJqO
課後回饋表單 QR Code 課後回饋 tally.so/r/NpNJqO