CARL GITHUB
AI 概念圖:火星黃昏的藍色夕陽下,一台停下的探勘車回望身後一條長長的車轍,沿途幾個微光信標標出走過的路,比喻回頭把 agent 走過的路逐段看懂。
回望車轍:把走過的路,逐段看懂。 AI 生成概念圖。

COMPREHENSION · AGENT OUTPUT

AnswerMe

看懂 agent 交出來的東西。

agent 做得比你看得快?這個 skill 先弄清楚你想懂什麼,再把陌生的概念,或 agent 交出的 diff 與測試結果,整理成有來源依據的解說,幫你處理理解債。

One concrete example

讀一段程式,
看懂呼叫順序。

這個示例標為「成果審視:程式碼走讀」:讀一段程式,看懂 TicketService 與 FakeRepo 的呼叫順序。下面的提示取自範例網站上這個範例實際使用的提示。在 agent 裡說「使用 answer-me」,就會用到這個 skill。

使用示例 · 不是本次執行紀錄

answer-me / 對話示例

使用 answer-me,根據 ticket_api,做成離線靜態 HTML,讓我看懂 TicketService 與 FakeRepo 之間誰先呼叫誰、首次與再次讀取同一張票的差別,以及找不到票時怎麼回覆。

結論:TicketService 先查自己的 cache,沒有才問 FakeRepo。

1呼叫順序
呼叫端只跟 TicketService 說話;它先檢查自己的 cache,沒有才呼叫 FakeRepo.find。FakeRepo 從不主動呼叫 TicketService,只回傳結果。
2三種情況
首次讀取:cache 沒有,呼叫 FakeRepo 一次,回 200。再次讀取:cache 命中,FakeRepo 不會被呼叫。找不到票:FakeRepo 回 None,轉成 404。
3依據
主張旁附程式行號與測試結果;從程式推論、測試沒有涵蓋的地方另外標明。
4來源衝突
README 寫快取 60 秒過期,但程式的 cache 是普通 dict,沒有過期邏輯。頁面依實際的程式路徑解說,並說明現有材料無法判斷哪一個代表預期行為,測試也沒有測過期。
5範圍
FakeRepo 是記憶體中的假資料來源,沒有真實資料庫或 HTTP 層;200 與 404 只是回傳 tuple 的第一個元素。

回報整理自範例網站上 ticket.html 的內容,是示意格式;素材 ticket_api 是虛構的,不是本次執行結果。

範例網站上共有五個範例。除專案解說一例以 AnswerMe 自己的 repo 為素材外,其餘範例的素材是虛構的;每個範例都標有產生它的版本,並經人工核對。

01 / When to use

什麼時候用?

適合 agent 產出的速度超過你理解的速度時使用,這筆落差就是理解債。它處理的是你對成果的掌握,不是程式本身的品質。

  • 概念學習 看懂陌生的概念、文章或 repo

    沿著一個具體流程,看它如何運作,並附上來源或相關程式位置。

  • 成果審視 看懂 agent 的方案、diff 與測試結果

    對照前後行為與取捨,說明證據能支持哪些結論。

  • 不適用 單一事實、完整 code review、修改程式

    單一事實查詢只得到簡短回答;完整 code review 與修改程式不在預設範圍。

02 / How it works

先弄懂問題,
再選呈現的形式。

它不是一收到材料就生成頁面,而是先確定你想懂什麼,再決定用文字、圖解或互動來講。預設使用繁體中文,保留必要的英文術語。

  1. 理解來源與問題

    先讀你提供的材料與提問,弄清楚要解釋什麼。

  2. 確認輸出格式

    你沒有指定時,先問要 HTML、Markdown 文件還是對話回答;已指定就直接製作。

  3. 組織解說

    依問題選文字、圖解或必要的互動;關鍵主張旁保留來源與驗證限制。依據程式畫的圖,節點與連線附檔案與行號。

  4. 製作

    HTML 是單一檔案,CSS、JavaScript 與 SVG 內嵌。一張圖以約 9 個節點、12 條連線為上限,超過就拆圖。

  5. 驗證與交付

    檢查內容、圖與互動後,交付實際檔案與路徑;HTML 驗證完成後,在 macOS 以 open 自動開啟一次。

你的問題,會得到什麼?
問題它的做法
陌生的概念、文章或 repo沿著一個具體流程解說,附上來源或相關程式位置。
agent 的方案、diff 或測試結果對照前後行為與取捨,說明證據能支持哪些結論,哪些只是推論。
單一事實查詢直接簡短回答,不做頁面。
完整 code review、修改程式不在預設範圍。

完整規則見 SKILL.md。文字解說會沿用來源的術語,保留例外、可能性與要求強度。

03 / Questions

常見問題

什麼時候直接回答,而不是做 HTML?

單一事實查詢直接簡短回答;已指定格式時直接照做。需要解說又沒指定格式時,會先問你要 HTML、Markdown 文件還是對話回答。

產出的 HTML 可以離線看嗎?

可以。互動 HTML 是單一檔案,CSS、JavaScript 與 SVG 都內嵌,閱讀與操作不需要 CDN、套件安裝或本機伺服器。唯一的例外是預設模板會載入 Google Fonts,載入失敗時退回本機字型。

它跟 code review 差在哪?

它幫你看懂:改了什麼、測試能證明哪些行為、哪些只是推論。完整 code review 與修改程式不在預設範圍。

產出的 HTML 會自動打開嗎?

會。HTML 驗證完成後,在可用的本機桌面環境自動開啟一次;macOS 使用 open。你可以要求不要自動開啟。

用對的跡象

  • 關鍵主張旁有來源與驗證限制,已確認的和推論的分得開。
  • 依據程式的圖,每個節點與連線都附檔案與行號。
  • 一張圖維持在約 9 個節點、12 條連線內,太大就拆圖。
  • 它會說出現有材料沒有涵蓋什麼,例如測試沒有測到的情況。

04 / My work

我在這個作品上的工作

這個 skill 的概念出自 Karpathy 在 2026-10-02 的貼文,我在 2026-10-04 先在 Codex 上做出第一版。製作時借鑑了幾個開源專案,各自借鑑什麼、沒有引入什麼,標在 README 的對應段落。我自己做的是範圍與決策、skill 本文、HTML 模板、檢查器與 CI,以及設計決策的 ADR。授權為 MIT。

05 / Boundaries

使用前需要知道

  • 行為驗證靠人工語意演練:用原始材料重新產出答案,再人工核對語意與成果。自動檢查只涵蓋 metadata、文件連結與保存的 HTML。
  • 保存下來的範例通過檢查,只代表那份歷史成果仍符合檢查條件,不代表目前版本會產生同樣品質的答案。
  • 「理解是否真的提升」從未量測。
  • 首版不做旁白影片。
  • 預設的 HTML 模板會載入 Google Fonts;載入失敗時退回本機字型,閱讀仍可離線。
  • 本頁示例的素材 ticket_api 是虛構的;範例網站上除專案解說一例以 AnswerMe 自己的 repo 為素材外,其餘範例的素材也是虛構的。

06 / Start here

帶回自己的專案

先閱讀完整流程,確認它和專案既有的規則與工具如何銜接,再按自己的情境安裝。

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

用 -a codex 或 -a claude-code 指定要安裝到哪個 agent;只供單一專案使用時,在該專案根目錄執行並移除 -g。

返回作品總覽

從你正在處理的問題,選下一個入口。