answer-me

看懂陌生的東西，
也看懂 agent 做了什麼

給 Claude Code、Codex 等 agent 的技能：把概念、repo 與 agent 的成果，變成附來源的解說。

npx skills@latest add CarlLee1983/AnswerMe --skill answer-me -g

github.com/CarlLee1983/AnswerMe

  1. 使用 answer-me，根據 ticket_api，做成離線靜態 HTML，讓我看懂 TicketService 與 FakeRepo 之間誰先呼叫誰、首次與再次讀取同一張票的差別，以及找不到票時怎麼回覆。
  2. 找出理解目標
  3. 確認交付格式：離線 HTML（未指定時會先問一次 HTML／Markdown／對話）
  4. 依理解障礙選圖解：時序圖
  5. 主張旁附來源
  6. 離線驗證
  7. 交付 → examples/ticket.html
examples/ticket.html 首屏：TicketService 先查自己的 cache，沒有才問 FakeRepo

↑ 上面那句請求的實際產出，點開可讀完整頁。

實錄：同一句請求拿掉「做成離線靜態 HTML」。answer-me 先給核心摘要，再問一次要 HTML、Markdown 還是對話；選 HTML 後產出頁面。等待思考與生成的段落已加速。

示意對照 · 素材 ticket_api

差別在於能不能被核對

同一份 README 與 service.py，兩種回答。

一般回答1 句

TicketService 會快取票券，60 秒後過期。

// 照抄 README，沒看程式

answer-me附來源

README 寫快取 60 秒後過期，但 service.py 的 cache 只是普通 dict，沒有任何過期邏輯來源（service.py 第 16、24 行）。兩者衝突推論，現有材料無法判斷哪個是預期行為缺口。

  • 來源標在主張旁
  • 事實與推論分開
  • 證據缺口照實說

兩種用途

技能先判斷你卡在哪裡，再決定用文字、圖解或互動呈現。

陌生概念 · 文章 · 系統

概念學習

沿一條實際流程追到負責的程式，建立用得上的理解，而不是目錄清單。

方案 · diff · 測試結果

成果審視

說清前後行為與取捨，核對關鍵主張；agent 自稱成功不算證據。

範例

每頁都由 answer-me v0.1.3 只憑原始素材產生，並經人工核對。

model-article.html 首屏：多走路徑 A，平均耗時會變快還是變慢？
  • 概念學習
  • 文章式
  • 互動

互動模型：p 增加時 M 往哪走

調整 p、A、B，看平均時間 M 為什麼可能增加也可能減少；數值皆為示意模型，不是實測。

打開範例
model-slides.html 首屏：p 變大，平均時間 M 會變大還是變小？
  • 概念學習
  • 簡報式
  • 互動

同一個模型的逐頁講解

同一份素材做成適合讀書會講述的簡報，其中一頁可即時調整參數。

打開範例
ticket.html 首屏：TicketService 先查自己的 cache，沒有才問 FakeRepo
  • 成果審視
  • 文章式
  • 時序圖

程式碼走讀：TicketService 與 FakeRepo

誰先呼叫誰、首次與再次讀取的差別、找不到票時怎麼回覆；並指出 README 說快取 60 秒過期，程式卻沒有過期邏輯。

打開範例
project.html 首屏：Answer Me 是什麼、實際怎麼運作
  • 概念學習
  • 文章式

這個專案是什麼、實際怎麼運作

以 Answer Me 自己的 v0.1.3 repository 為素材，沿一次請求走過技能的步驟，並說明檢查與決策紀錄各管什麼。

打開範例

能力邊界

寫在前面，不寫在小字裡。

language
繁體中文為主，保留必要英文術語；明確要求時可用其他語言。
media
不製作旁白影片；媒介限於文字、圖解與互動 HTML。
html
單檔、離線可開，內嵌所需的樣式、程式與資料，不需要伺服器。
scope
解說不是 code review；完整審查或修改程式屬於另外的任務。

下一次看不懂，就叫它來解說

一行指令安裝，在 agent 裡說「使用 answer-me」。

npx skills@latest add CarlLee1983/AnswerMe --skill answer-me -g

先看範例