feature: /idd-ask skill — query GitHub issues knowledge base (mirror /spectra-ask)

[kiki830621]

Problem

Original text (user invocation of /idd-issue 2026-05-11):
「我發現需要一個 /idd-ask 有點像是 /spectra-ask 的功能」

目前 IDD plugin 有 14 個 skill（idd-all、idd-close、idd-comment、idd-config、idd-diagnose、idd-edit、idd-implement、idd-issue、idd-list、idd-plan、idd-report、idd-update、idd-verify、idd-all-chain），但沒有一個 skill 是純粹回答「issue 知識庫」的查詢問題。

相對地，Spectra 有 /spectra-ask：grounded 在 openspec/ 文件之上，純查詢、不改任何 state。它的價值是「我想知道之前怎麼決定的，但不想自己 grep」。

IDD 的對應知識庫是 GitHub issues + comments + linked PRs（diagnoses、decisions、closing summaries 都沉澱在這裡）。目前要查歷史只能：

• gh issue list --search "..."（沒語意搜尋、不會跨 comment）
• 手動翻 issue body 找 diagnosis comment
• 跑 /idd-list 但那是 triage view，不是知識回答

Type

feature

Expected

新 skill /idd-ask <question> 行為類似 /spectra-ask：

1. 接收問題（自然語言，中英混雜 OK；無 question 時 infer from conversation context）
2. 決定要不要搜（greeting / meta-tool 問題不搜）
3. 搜尋 issue 知識庫（建議 gh issue list --search + gh search issues + 抓 top-N issue 的 body & comments；或建 local cache + embedding 搜尋，類似 spectra vector_not_compiled 但用 issue corpus）
4. 讀取命中的 issue（含 comments）
5. 回答，grounded 在 issue 內容：
   • 第一行 blockquote 引用使用者原問題（同 spectra-ask 規矩）
   • 答案只引用 issue / comment 內容，不腦補
6. 附 ### Referenced Issues 區段：列出 #N (title) — issue URL，方便人工 follow-up

關鍵設計約束：

• 只讀（不 create / edit / comment / close）— 跟 /idd-list 區隔（list 是 triage、ask 是 QA）
• 不觸發 /idd-diagnose — 即使問題長得像 bug report
• source priority 類比 spectra：closed-with-PR issue > open issue > orphaned comment（已關 + 已 ship 的是 ground truth；open 是「進行中、可能還會變」）
• 跨 repo：尊重 walked-up config + --target flag（同其他 idd-* skill）；可選 --target group:<label> 在 group 內搜

Actual

目前查 IDD 歷史只能手動 gh issue list + gh issue view，沒有 skill 層提供 grounded、引用化的回答。三個月後回來看 kiki830621/2026-winston 或 PsychQuant/* 的 issue history，AI 沒辦法快速幫 user 還原當時的 decision rationale。

Impact

• 個人 workflow：減少手動 grep issue archive 的時間，特別是「上次某個 bug 怎麼修的」「為什麼 X 做法被否決」這類問題
• AI 互動品質：AI 答 IDD 相關問題時可以強制 grounded 在實際 issue 紀錄，不會 hallucinate
• Skill ecosystem completeness：補上 IDD 對應 spectra-ask 的 query-only skill，七種 process skill（issue/diagnose/plan/implement/verify/close/update）+ 一個 read-only ask，mental model 對稱

設計提示（不限制實作）

可考慮的搜尋後端：

1. MVP：gh issue list --search + gh issue view --comments + LLM-side ranking（純 gh CLI，零基礎建設成本）
2. Phase 2：local issue corpus cache（.claude/.idd/issue-cache/<repo>/<num>.md）+ embedding 搜尋（同 spectra 的方向）
3. Phase 3：跨 repo group search（一個 query 掃 primary + tracking repos）

可能踩到的設計坑（讓實作者注意）：

• comment 數一多 issue body 會超過 LLM context — 需要 chunk + 摘要 / per-comment relevance scoring
• closed issue 的 closing summary 是最高訊息密度，要特別 weight
• 跟 /idd-list 的 boundary 模糊 — /idd-list 是「列出有什麼 issue」，/idd-ask 是「回答某個問題」；UI 提示要明確區分

Out of scope

• 不做：跨 GitHub org 搜尋（單 repo / group 已涵蓋大宗）
• 不做：write side（這是專門的 query skill）
• 不做：取代 /idd-list（兩者並存）

---

Current Status

Phase: closed
Last updated: 2026-07-06 by /idd-diagnose (via /idd-all batch drain)

Key Decisions

• Complexity = Spectra（opt-out → propose）：鏡像 /spectra-ask 定向
• A_parallel_safe；排 Wave C 尾（與 feat: make /idd-list and /idd-issue GitHub Discussions-aware (intake blind spot) #221 相鄰）
• Next: spectra-propose（由 /idd-all Phase 3b 接續）

[kiki830621]

Diagnosis

Type

feature（新 skill /idd-ask — issue 知識庫查詢，鏡像 /spectra-ask）

Root Cause / Analysis

知識庫查詢缺口確認：IDD 的決策沉澱（diagnoses/decisions/closing summaries）散在 issues+comments+PRs，現有工具（gh search / idd-list）都不是「問答」介面。鏡像對象 /spectra-ask 在 repo 內有完整先例（grounded、read-only、引用來源）— 方向由鏡像關係定死。

實作面：gh issue list/view --json + gh search issues（含 closed）作 retrieval，AI 端 synthesis + 逐 claim 附 issue/comment URL 引用；read-only（不改任何 state、不 post）。

Impact

• 新 skills/idd-ask/（SKILL.md）+ README/usecase-routing 註冊
• 純 read-only — 無 egress、無 gate 需求

Strategy

• SKILL.md：retrieval 策略（open+closed、comment 掃描、關鍵詞 + label 組合）+ 回答格式（claim 必附引用 URL）+ 明確 read-only 契約
• 與 /idd-list 的分工文件化（triage view vs 知識問答）
• README / usecase-routing 增列

Conflict Class

A_parallel_safe — 全新 skill 目錄。

Complexity

Spectra（opt-out → 直接 propose）

Layer 2 命中：新 published skill surface。Opt-out 成立：方向由「鏡像 /spectra-ask」完全定案（同 repo 內有具體先例可抄結構），零 naming/scope open questions。
[Unattended batch：SDD chain（propose → apply）；排 Wave C 尾與 #221 相鄰]

Risks

• 大 repo 的 retrieval token 成本 — SKILL.md 定 limit + 分頁策略

Residue

語意搜尋（embedding）不做 — gh search 詞法檢索是誠實邊界（#139 另案追語意版）。

Vagueness Pre-check

• V1: 2 — 鏡像對象明確
• V4: 2 — 完成 = skill + 註冊 + 分工文件
• Triggered: no

[Layer V: V1=2 V4=2, not triggered; unattended mode]

Sister Concerns Filed (mid-diagnose, v2.47.0+ #528)

(none — #139 語意搜尋既存)

---

Source: /idd-all batch drain (unattended), 2026-07-06

[kiki830621]

Implementation Complete

PR: #266（idd/72-idd-ask-skill）
Spectra change: idd-ask-skill（proposal / design D1–D5 / spec delta（idd-ask ADDED ×2）/ tasks 4/4，validate ✓；merge 後 archive）
Commit: 見 PR

Checklist

• 新 skills/idd-ask/SKILL.md — decide-to-search gate、retrieval delegate idd-find backend（不重造）、top-N 全文（5/上限 10）、grounded 合成契約（blockquote 原問題 / claim 必附引用 / source priority / 分歧 surface / ### Referenced Issues / 查無誠實）、read-only allowed-tools、bug 貌問題不觸發 diagnose、unattended fallback
• 與 /idd-list、/idd-find 分工文件化（skill 內分工表 + family 成員表）
• references/surfacing-primitives.md 成員表 +1（[design] Document 'surfacing-only primitive' skill family pattern (idd-list / idd-clarify / future idd-find?) (sibling concern from #139) #140 增員三題誠實記錄：Q3 弱命中 + spectra-ask 同構 judgment）
• plugin CLAUDE.md 輔助表 + usecase-routing 情境 30
• 新 suite idd-ask（RED 0/17 → GREEN 17/0）；全 sweep 37 suites 0 fail

Residue（依 diagnosis）

Embedding 語意搜尋不做（與 idd-find 同誠實邊界）；--target group:<label> group 內搜尋（v1 單 repo）。

[kiki830621]

Closing Summary

Problem（2026-05-11 原話：「我發現需要一個 /idd-ask 有點像是 /spectra-ask 的功能」）：IDD 的知識庫（issues + comments + linked PRs）沒有 grounded 問答入口 — 三個月後想還原 decision rationale，只能手動 gh issue list + 逐一翻，AI 沒有 skill 層路徑、容易憑訓練記憶腦補歷史。

Solution（Spectra change idd-ask-skill，opt-out → propose）：新 /idd-ask <question> — surfacing family 第 4 員。question → decide-to-search gate（greeting/meta 不搜；bug 貌問題不觸發 diagnose）→ retrieval delegate idd-find backend（family 鐵律「不重造唯讀查詢」首次用於 primitive 之間）→ top-N 全文（預設 5、上限 10）→ grounded 合成：首行 blockquote 原問題、claim 必附引用、source priority（closed-with-PR > open > orphaned comment）、分歧 surface、### Referenced Issues、查無誠實說查無。read-only allowed-tools 鎖定。

過程紀錄：#140 增員三題程序首戰 — Q3（delegate 消費者）弱命中，以「ask 類消費者本來就是人」（spectra-ask 同構先例）judgment 開員，先例已寫回 family 文件供未來參考。

Verification：新 suite idd-ask（RED 0/17 → GREEN 17/0）；全 sweep 37 suites 0 fail；artifacts validate ✓；PR #266 review + merged。

Changes：新 skills/idd-ask/SKILL.md、references/surfacing-primitives.md（成員表 +1）、plugin CLAUDE.md、references/usecase-routing.md（情境 30）、新 suite、Spectra artifacts（隨後 archive）。

Residue（依 diagnosis）：embedding 語意搜尋不做（與 idd-find 同誠實邊界）；--target group:<label> group 內搜尋（v1 單 repo）。皆無 tracking issue — 與 find 的 residue 同軌，日後語意版立案時一併涵蓋。

Distribution sync：v2.99.0（本 session 隨後發版）。

[kiki830621]

📊 For Reviewer / Collaborator

現在：/idd-ask 落地（issue 知識庫 grounded 問答，surfacing family 第 4 員），PR #266 merged
Blocking：無
你該做什麼：無 — 已結案（詳見 Closing Summary）

last-updated by idd-close at closed, 2026-07-18