MyR2D2 🤖

你的隨行 astromech droid — Claude skillset（繁中本體、中英雙語觸發）

繁體中文（本頁）| English

R2-D2 從來不是主角，但每一集都靠它：把 Death Star 圖紙帶出來、滾過沙漠找到 Obi-Wan、在 X-wing 後座默默修飛船管能源。

MyR2D2 就是這個定位 —— 10 支 skills，管的都是「不做不會死、但做了整個工作流才活得下去」的事:

這套東西怎麼開發的

Claude 的 session 是失憶的：對話一關，沒寫進磁碟的東西全部蒸發。這套 skills 的共同主題就是對抗失憶——上表每一支，管的都是失憶鏈上的一段。全部是在真實日常使用中踩坑迭代出來的，不是理論設計。

開發流程自己也吃同一套規矩：每版出貨前，先把產出送給另一個模型家族審一輪（同一個模型再檢查一次，只會確認它本來就相信的事）。ai-review 這支就是這樣做出來的——三輪跨模型二審抓出 21 個缺陷、其中 13 個是前一輪修法自己帶出來的，41 項回歸測試隨包出貨。這些都查得到：測試方法與證據見 docs/TEST_PLAN.md，每一版修了什麼見 Releases。

相容性矩陣

先看這張表，確認你的工具能用哪幾支：

* ＝安裝／發現層實測，執行層為規則推論（見 docs/TEST_PLAN.md CROSS-05）。 ¹ 五鐵則通用、模型名自行對換；§1「進階兜底」（settings.json／env）僅 Claude Code 生效，其他工具跳過。 ² 日誌三支的資料來源是 Claude Code 自家的 transcript（~/.claude/projects/）——skill 格式裝得進其他工具，但那裡沒有這份資料，故標 ❌。 ³ 「即時門鈴」（推球後直接傳訊喚醒對面 session）為選用增強，僅 Claude Code v2.1.224+ 的 cross-session messaging 生效（官方支援 macOS／Linux；送往 bypass-permissions session 的訊息會先押著等人工核准）；其他工具偵測不到就自動跳過，純檔案交接不受影響。 ⁴ ai-review 需要一個二審後端（預設 Codex CLI，可用 AI_REVIEW_CMD 換掉）＋能跑 POSIX shell 的環境。沒有後端／沒登入時回報 skipped_* 並照常回 0，不會中斷流程；額度或網路類失敗預設回 2，加 --soft-fail 可讓它也回 0。腳本刻意不釘死模型（釘了會過期），若後端預設模型不在你的方案內，用 --model 指定。腳本已在 macOS 的 sh／dash／bash／ksh／zsh 實測，Linux 由 CI（ubuntu-latest）每次 push 實跑；Windows 與免費方案帳號仍未實測。

• Gemini CLI／Codex CLI：安裝與發現層已實測——含 Gemini 的 trusted-folder 關卡（skill 沒出現時，先信任專案資料夾）；執行層未實測。
• ChatGPT：無 CLI／無檔案系統，唯一路徑＝手動貼入（見 adapters）。
• Cursor／Copilot 等其他 npx skills 目標：未實測。

ChatGPT / Codex 的移植方法（首選 npx skills、備援 AGENTS.md 併入、三個坑）見 adapters/openai/。

安裝

怎麼選：CLI 使用者 → npx 或 Plugin｜想手動控制 → 手動複製｜只用網頁版 Chat → 免安裝簡版｜claude.ai Cowork → 最後一段。

skills.sh（npx skills）——推薦，一行裝完

（skills.sh badge 的數字＝累計安裝次數，不是 skill 支數。）

npx skills add tingyulu/MyR2D2

npx skills 支援 Claude Code 與其他多種 agent（gemini-cli、codex、cursor…，完整清單見上游 README）。本 repo 已實測 gemini-cli／codex 的安裝層（方法與證據見 docs/TEST_PLAN.md），其餘目標未實測。預設裝到專案層 ./.claude/skills/；要裝成全域才加 -g。想只裝其中幾支用 --skill。

Claude Code CLI — Plugin（深度整合）

/plugin marketplace add tingyulu/MyR2D2
/plugin install myr2d2@myr2d2

skill 掛在 myr2d2: 命名空間下（/myr2d2:dropoff…）——與你機器上既有的同名 skill 結構上不衝突，且可經 marketplace 集中更新。

Claude Code CLI — 手動複製

git clone https://github.com/tingyulu/MyR2D2.git
cp -rn MyR2D2/skills/* ~/.claude/skills/

⚠️ 用 -n（不覆蓋既有檔）：若你 ~/.claude/skills/ 底下已有同名資料夾，cp -r 會直接覆蓋且不提示。想更新既有的，先自己 diff 過再決定。

只用網頁版 Chat？免安裝簡版

不用 CLI、不裝任何東西：prompts/ 有可直接貼進對話（或 custom instructions）的簡版 prompt，規則類 skill 適用——damage-report（繁中｜EN；繁中完整版 781 字元、連 ChatGPT Free 都放得下，另有極簡版供更窄欄位）與 ai-review（繁中｜EN，貼進另一個 AI 就是跨模型二審）。

Cowork / claude.ai

先照「手動複製」段 git clone（或 GitHub 網頁 Code → Download ZIP）取得 repo，再把要用的 skill 資料夾（skills/<名稱>/）加進你的 Cowork 專案 skills（或專案目錄的 .claude/skills/）。

裝完打 /save-all、/dropoff、/pickup、/daily-debrief、/damage-report、/ai-review 等即可觸發，或用上面任一語言的自然語句。

更新

skill 裝進去的是當下快照，有新版不會自動通知。更新方式：

npx skills update

一行更新所有已裝 skill（來源記在安裝時的 lock 檔；-g／-p 限定全域／專案層）。Plugin 路徑裝的改用 /plugin 介面更新 marketplace。想在新版發布時收到通知：GitHub 上對本 repo Watch → Custom → Releases。

一組 skill、兩種語言習慣

Skill 本體是繁體中文（單一真相，不維護平行翻譯版）;觸發詞中英各一組對應，寫在每支 skill 的 description 裡:

• 中文習慣：「要重開機了」「交接給 X」「有沒有交接給我的」
• English habit: "about to reboot", "hand this off to X", "anything handed off to me?"

Claude 讀繁中指令、照樣用你的對話語言回覆 —— 英文使用者的體驗不打折，而 skill 永遠只有一份要維護。

各 skill 的依賴

dropoff/pickup 預設是零依賴的檔案版；如果你有自己的任務系統(CLI todo、Notion、Linear…),SKILL.md 內附「接上你自己的任務系統」的替換說明。

設計原則

1. 驗證優先於宣告 — 寫入要回讀驗證，完成要證據，不信字面成功訊息。
2. 脈絡自包含 — 交接卡假設讀者對前情一無所知。
3. 零依賴的最小公倍數 — 預設檔案版，進階才接外部系統。
4. 配額是共享資源 — 多代理派工的預設是省，全力跑是顯式開關。
5. 單一真相 — skill 只有一份（繁中），語言習慣靠雙語觸發詞對應，不維護平行翻譯版。

Repo 結構

MyR2D2/
├── .claude-plugin/                    ← plugin.json + marketplace.json(單一 plugin)
├── .github/workflows/                 ← CI(YAML 驗證、守門 grep、行為矩陣、harvest 測試)
├── skills/                            ← 10 支 skill(繁中本體、雙語觸發)
│   ├── save-all/  ├── dropoff/  ├── pickup/
│   ├── mission-log/  ├── daily-debrief/  ├── weekly-debrief/
│   ├── damage-report/  ├── ai-review/  ├── token-optimizer/
│   └── flight-to-calendar/
├── prompts/                           ← 免安裝簡版(貼進 Chat 就能用)
├── docs/                              ← 測試計畫、外部前提的查證記錄
├── adapters/openai/                   ← ChatGPT / Codex 移植包
├── README.md                          ← 本頁(中文為主)
└── README.en.md                       ← English

Attribution

• token-optimizer 改寫自 kieiken/ultracode-token-optimization(MIT)，泛化為全 Claude 環境版本。

作者

大叔（Eric Lu）——30 年產品人，現在是產品顧問、獵頭、職涯教練。這套 skills 是我自己每天在用的工作流，痛點解掉了就順手開源。

• 長文正本：uncleric.com（寫職涯，寫產品，也寫生活）
• 日常出沒：Threads @tingyulu｜LinkedIn
• 每週職缺快報電子報：大叔的人生相談室

License

MIT — 詳見 LICENSE。

MyR2D2 是粉絲致敬命名，與 Lucasfilm / Disney 無任何關聯；R2-D2 及 Star Wars 為其各自權利人之商標。