Answer Me 是什麼、實際怎麼運作

repo2/
├── skills/answer-me/            ← 技能本體（安裝的就是這個資料夾）
│   ├── SKILL.md                 行為規則：目標、格式、組織、用詞、證據、製作、驗證、交付
│   ├── agents/openai.yaml       顯示名稱與簡介（display_name / short_description）
│   ├── references/html-style.md HTML 預設樣式、版型選擇與從模板到成品的步驟
│   └── assets/
│       ├── article.html         文章式起始模板（預設）
│       └── slides.html          簡報式起始模板（明確要求逐頁時）
├── README.md / CONTEXT.md / AGENTS.md   使用說明、領域用語、agent 指引
├── docs/adr/0001–0005           已接受的設計決策
├── docs/checks.md               檢查命令與驗證範圍
├── scripts/check.py             快速檢查（metadata + 相對連結）
├── scripts/install-hooks.sh     啟用 .githooks
├── .githooks/pre-commit         以 --staged 模式呼叫 check.py
├── tests/test_checks.py         檢查器與 hook 的單元測試
├── tests/answer-me/             演練輸入、歷史輸出、離線瀏覽器檢查
└── .scratch/                    規劃票與各次變更的驗證紀錄

來源：README.md「手動安裝」「技能內容」「文件導覽」；技能目錄與 repo 內 skills/answer-me/ 經 diff -r 比對內容相同。

1. 觸發與載入

   技能 frontmatter 的 description 寫明用於「幫我理解」「解釋如何運作」「看懂這次變更」，並說單一事實查詢直接簡短回答。agent 平台依此決定是否載入技能。

   SKILL.md 第 1–4 行。平台如何比對 description 不在本 repo 內，屬推論。
   本次：你明確寫了「使用 answer-me」，不依賴自動觸發。

2. 找出理解目標

   分成兩種用途：概念學習（陌生概念、文章、系統）與成果審視（agent 的方案、diff、測試結果）。探索 repo 時要沿一條代表流程追到負責的程式，不能只列目錄；審視成果時要區分「測試檔存在」「測試曾執行」「測試通過」。

   SKILL.md「找出理解目標」第 10–15 行；用語定義見 CONTEXT.md。
   本次：屬概念學習。因為技能沒有可執行的請求路徑，代表流程改為「agent 處理一次請求」的規則鏈，也就是本節。

3. 確認交付格式

   對話尚未指定格式時，主動問一次要 HTML、Markdown 文件，還是直接在對話中回答，並推薦其中一項。已指定就沿用，不再問。

   SKILL.md「確認交付格式」第 17–21 行。
   本次：已指定 HTML、文章式，所以沒有詢問。

4. 依理解障礙組織內容

   先整理核心答案、子問題與各自依據，每節回答一個子問題。再依關係選形式：步驟與分支用流程圖，包含關係用樹狀圖，方案比較用對齊的比較表；只有在操作確實有助理解時才做互動。

   SKILL.md「依理解障礙組織內容」第 23–41 行的選型表。
   本次：目錄用樹狀圖、處理步驟用本流程、分支用比較表；沒有參數可調，所以不加互動。

5. 寫清楚、保留證據

   沿用來源術語、寫出動作主體、短句但保留「可能」「建議」等強度；在關鍵主張旁附檔案位置或測試紀錄，並區分來源事實、推論、示意數據與實際觀測值。

   SKILL.md「寫清楚技術解說」第 43–52 行、「保留證據」第 54–60 行。

6. 製作成品

   選 HTML 時先讀樣式指引，把模板複製到交付位置再替換內容，保留技能包內的原始模板。CSS、JavaScript、SVG 與資料全部內嵌；Google Fonts 是唯一允許的外部載入，失敗時退回本機字型。show-me、archify 等製作能力可選，不是必要依賴。

   SKILL.md「製作與可選能力」第 62–82 行；references/html-style.md「從模板到成品」。
   本次：從 assets/article.html 起步，沿用預設配色與元件，示例內容全部替換。

7. 驗證與交付

   HTML 要實際以本機檔案開啟，在離線或封鎖網路的情況下檢查呈現；有互動時要操作主要控制項。驗證後在桌面自動開啟一次（macOS 用 open），除非使用者要求不要開，或沒有桌面環境。開啟成功不等於驗證通過。

   SKILL.md「驗證與交付」第 84 行起。
   本次：以 headless Chrome 離線開啟本檔檢查桌面與 390 px 版面；依你的要求沒有自動開啟，只交付連結。

來源：SKILL.md「確認交付格式」「驗證與交付」；tests/answer-me/README.md「Output-format evaluations」表格。自動開啟規則於 2026-10-04 加入，見 .scratch/html-auto-open/verification.md；該紀錄自述「不要開啟、無桌面與命令失敗分支已做文字核對，尚未逐一執行」。

0005 的數字是 ADR 引述的作者紀錄（.scratch/skill-language-ab/verification.md），本文未重跑該評估。