CLAUDE CODE SKILL · 隨身讀

任何知識,變成手機上的一疊卡片

把手上現成的筆記、表格、清單交給 Claude,得到一個可以搜尋、分類、加書籤、寫心得的手機閱讀網頁。 一個 HTML 檔就是全部——存在手機上斷網也能讀,傳到手機用瀏覽器就能開,想要網址也可以部署上雲端。

單檔 HTML 零外部相依 檔案版離線可用 不必連網 Markdown/CSV/Excel/JSON 實測 Claude 製作時間少 59%
01

能做什麼

資料丟進去,出來的是一疊可以帶著走的索引卡

讀書筆記 ☆🎲⋯ 搜尋… 篩選 標籤 習慣 練習模式 原子習慣5 張 讓提示顯而易見 第 6 章 ★✓ 兩分鐘法則 ☆○ 顯示答案 我的筆記明天起床先讀一頁… 身分認同導向 心理 ☆○ 原子習慣5 快思慢想4 從 0 到 13

讀的人拿到的功能

類別功能
找全文搜尋(連自己寫的筆記也搜)、底部分頁與各頁命中數、多組篩選(同組任一、跨組同時符合)、點卡片裡的標籤直接篩選
記書籤、已讀(自己點 ○ 標記)、每張卡的個人筆記(打字自動存)、匯出/匯入(換手機時搬資料)
複習練習模式(在「篩選」→「模式」打開,預設關閉;打開後展開卡片先遮住,點「顯示答案」才出現,設定會記住)、隨機抽一張(優先抽還沒標已讀的)、今日一卡
看主題(跟隨系統/淺色/深色)、字級四段,都在右上「⋯」;出處可折疊
指定卡片網址版可以在網址後加 #r=卡片代號,打開就直接跳到那張卡;用 🎲 或今日一卡打開時網址列會自動帶上。介面上沒有「分享」按鈕。

做的時候還可以指定:英文介面、整理版與原文並列(需要資料本身帶原文)、張數單位(家、則、字)。

示意圖:頂欄只留書籤、隨機、設定三顆按鈕,把空間留給標題;卡片左側色帶依一組篩選值上色。

吃得進的資料

📝 Markdown 內建轉換

  • 一個檔或整個資料夾(含 Obsidian vault)
  • 檔案只有一個 # 時,底下每個 ## 一張卡;有多個 # 就每個 # 一張卡(## 變卡內小標)
  • 分頁依序取:檔頭的 section → 檔內第一個 # → 檔名
  • 上層標題底下、第一張卡之前的說明文字自成一張卡,不會被略過
  • #標籤 與檔頭 tags 變成篩選,也在卡片裡可點
  • > 引文 收進可折疊的出處;圖片不會帶進來(見 06)

📊 CSV/Excel 內建轉換

  • 一列一張卡,指定標題欄、分頁欄、篩選欄;第一列要是欄名
  • Excel 直接另存的 CSV(cp950)自動辨識;.xlsx 預設只讀第一個工作表
  • 一格多值的欄位(以逗號、頓號分隔)可當標籤
  • 整格是 http(s):// 開頭的完整網址才會變連結(www. 開頭的不算)

🧩 JSON/其他 Claude 寫轉換

  • 資料庫匯出、API 回應、專案自己的格式
  • Claude 寫一支小程式轉成通用格式
  • 程式存在資料旁邊,資料更新一鍵重建
  • 欄位可以是段落、標籤、連結、小清單
02

背後怎麼做

你只要下指令;Claude 會照這個流程走,每一步都有腳本

  1. 先想「一張卡是什麼」

    一張卡=一個能單獨讀懂的概念(一個重點、一則問答、一個單字、一家公司)。分頁 2~6 個、篩選 1~4 組。資料結構明顯就直接做,有歧義才問你。

  2. 轉成通用格式md_to_reader.py/csv_to_reader.py

    所有來源都先轉成同一份 reader.json。轉完會打開看前幾張卡,不對就調整。

  3. 建置build_reader.py

    產出單一 HTML。格式有錯(id 重複、分類不在清單內)會直接停下並指出哪張卡;卡片數比上次少超過 10% 也會擋下,避免把壞掉的空殼當成品。資料沒變,重建出來一個位元都不差。

  4. 交付前檢查check_reader.py

    核對卡片數、確認沒有任何外部資源、內嵌資料安全;電腦有裝 Node.js 時再把每張卡實際渲染一次(沒有就略過並提醒);本機路徑或金鑰之類的敏感字樣會提醒。

  5. 交付或部署deploy_pages.py

    預設給你一個檔案。要網址就部署到 Cloudflare Pages:先掃敏感字樣,命中就不上傳;部署等於公開,Claude 會先跟你確認。第一次部署前,你要先有 Cloudflare 帳號、裝好 Node.js,並執行一次 npx wrangler login 在瀏覽器按「允許」。

  6. 之後更新

    資料改了就重跑同一套指令。書籤和筆記靠「卡片代號」對應:Markdown 由檔案路徑+卡片標題算出,表格預設用標題欄。卡片內文怎麼改都沒關係;改了某張卡的標題或檔名,那張卡的書籤筆記就對不上。表格有代號之類不會變的欄位時,可以請 Claude 拿它當卡片代號。整份閱讀版改名的話,除非第一次就固定「儲存代號」,否則全部書籤筆記都會對不上。

03

適合的情境

核心判斷:「一堆現成的條目,想在手機上查、翻、讀」

情境一張卡是分頁篩選好用的功能
讀書筆記一個重點書名標籤、難度個人筆記、今日一卡
客服 FAQ一問一答產品線問題類型搜尋、檔案版離線查
單字卡一個字單元程度、詞性練習模式、隨機抽
公司 SOP一個步驟或情境流程角色、頻率部署成網址貼到 LINE 群組
交易規則手冊一條規則主題篇方向、時間框架、來源出處折疊、原文並列
指令速查表一條指令工具用途標籤點標籤篩同類
產業/公司資料表一家公司產業上中下游官網可點
考試重點一個考點科目章節練習模式、隨機抽

不適用——這些交給別的工具比較好:

投影片圖表儀表板多頁式官網手機 App(原生)操作 Anki/Notion修改既有網站的 CSS
04

怎麼下指令

不必說「隨身讀」——說「手機上看」「離線查」「做成卡片」就會用到它

開始之前

  1. 在 Claude Code 裡對 Claude 說(終端機,或桌面 App 的 Code 分頁)。這個 skill 裝在這台電腦的 Claude Code 裡,claude.ai 網頁聊天叫不到。
  2. 電腦要有 Python 3。直接讀 .xlsx 要多裝 openpyxl,沒裝會停下並提示;也可以先在 Excel 另存成 CSV。
  3. 這台電腦已經裝好,任何資料夾都能用。換一台電腦,要先把 repo 裡的 skills/隨身讀 整個資料夾複製到那台電腦使用者資料夾底下的 .claude/skills/(步驟見 skills/隨身讀/README.md)。
  4. 要網址才需要 Node.js 和 Cloudflare 帳號(見 02 第 5 步)。
1
資料在哪
檔案或資料夾路徑
2
一張卡是什麼 可省
不說的話,Claude 看完資料會提方案
3
怎麼分、怎麼篩
例:依產品線分頁、依難度篩
4
特殊需求 可省
英文介面、練習模式要露出哪些欄、單位(家、則、字);之後可能改名就說「請固定儲存代號」
5
放哪、要不要網址
要網址就明說,部署前會再確認;之後會更新就說「把重建指令存在資料旁邊」

講得越清楚,第一版就越接近你要的;沒講的部分 Claude 會照資料的樣子自己決定,做完再改也很快。

05

範例

六種常見說法,以及會得到什麼

讀書筆記資料夾
我在 D:\Obsidian\讀書筆記\ 有五本書的心得(一本書一個檔),幫我做成手機隨身讀,一本書一個分頁,可以依標籤篩選,放到 D:\site\books\
每個 ## 一張卡,底部分頁是書名;#標籤 變成篩選,卡片裡的標籤點了就只看同一類。
Excel 表格
這是我整理的台股半導體產業鏈(D:\資料\產業鏈.csv,Excel 另存),想在手機上一家一家翻,按產業跟上中下游篩選,官網要能點
一家公司一張卡,張數單位改成「家」;編碼自動辨識。官網欄寫的是 https:// 開頭的完整網址時,會自動變成可點的連結。
單字卡
把 vocab.json 做成通勤背單字用的卡片,英文介面,練習模式時只露出詞性和程度,意思先遮住
英文介面,一個字一張卡。讀者在 Filter → Mode 打開 Practice mode 後,詞性、程度常駐顯示,意思與例句要點「Show answer」才出現。
單一大檔
SOP.md 很長,## 是流程、### 是步驟,做成手機可以依流程瀏覽、搜尋的版本,丟 LINE 群組大家點開就能看
以 ## 當分頁、### 當卡片;每個流程開頭的說明(適用範圍、負責人)自成該分頁的第一張卡。要群組裡人人點開就能看,最穩的是部署成網址再貼連結。
要一個網址
把 notes主手冊 的規則整理成卡片式閱讀頁,部署到 Cloudflare Pages,專案名 my-rules
建好、檢查、掃描敏感字樣,跟你確認內容可以公開後才部署(前提是你已登入 wrangler),通常得到 https://my-rules.pages.dev;名稱已被別人用走時 Cloudflare 會配帶後綴的網址,腳本會印出實際的那一個。
之後更新
D:\Obsidian\讀書筆記 的筆記改了,照旁邊存的指令重建隨身讀,並重新部署
照存下來的指令重跑;網址版重新部署後打開就是新版,卡片標題沒改的書籤筆記都還在。檔案版要把新的 index.html 重傳到手機,換檔前先用「⋯」複製匯出比較保險。
⚠️

06 · 限制與注意

💾書籤和筆記存在你打開它的那個瀏覽器裡。換手機、從檔案改成開網址、在 LINE 裡點開和用 Safari/Chrome 開,都算不同的地方。要搬的話,按右上「⋯」→「複製匯出」,把那段文字傳到另一邊,貼進同一個框再按「貼上後匯入」。無痕/私密視窗看起來存得住,但關掉就會消失,頁面不一定會提醒;要保留請用一般模式開。
📱檔案版要用瀏覽器開。內容靠網頁程式顯示,有些 App 的檔案預覽不執行程式,只會看到一行「需要開啟 JavaScript」——換成「用瀏覽器開啟」就好。要給一群人看,最穩的是部署成網址再貼連結。
📶網址版要連網才打得開。已經開著的分頁斷網後還能讀;要在沒訊號的地方查,請把檔案存到手機上用瀏覽器開(兩份的書籤筆記不互通)。
🔑閱讀版名稱可能會改,就要固定儲存代號。沒指定時,書籤筆記的儲存位置由名稱推算,改名後全部讀不到。第一次建置時說一句「請固定儲存代號」即可。
🔤閱讀版名稱別太長。最上面那一行在手機上最多放兩行(中文約 24 字),再長會被截掉;卡片標題不受這個限制。
🖼️圖片不會出現在卡片上。為了單檔、離線、任何地方都能開,頁面不載入外部圖片或字型。Markdown 裡單獨一行的圖片 ![說明](網址) 與 Obsidian 的 ![[圖片]] 轉換時都會略過。要保留請改寫成一般連結,例如 [看圖](https://…)。
🌐部署等於公開。專案名稱就是網址前半段,只能用英文小寫、數字和連字號。知道網址的人都看得到;Cloudflare 每次部署都留一個獨立網址,誤上傳的內容要到後台刪除那次部署才會真的消失。
🧭在 Claude 桌面版裡偶爾會被「搶走」。桌面版的 Artifact 也會做網頁,有時 Claude 會先走那條路。想確定用這個 skill,指令裡加一句「用隨身讀 skill」。