Skip to content

feat: /idd-ask — grounded QA over the issue corpus (surfacing family 4th member)#266

Merged
kiki830621 merged 1 commit into
mainfrom
idd/72-idd-ask-skill
Jul 18, 2026
Merged

feat: /idd-ask — grounded QA over the issue corpus (surfacing family 4th member)#266
kiki830621 merged 1 commit into
mainfrom
idd/72-idd-ask-skill

Conversation

@kiki830621

Copy link
Copy Markdown
Member

Refs #72

/idd-ask — issue 知識庫 grounded 問答(surfacing family 第 4 員)

Spectra change idd-ask-skill(opt-out → propose,診斷既定:「鏡像 /spectra-ask」)。

契約要點

  • 問答鏈:question → decide-to-search gate(greeting/meta 不搜;bug 貌問題不觸發 diagnose)→ retrieval delegate idd-find backend(family 鐵律:不重造唯讀查詢)→ top-N 全文(預設 5、上限 10 — token 成本界限明文)→ grounded 合成
  • Grounding 契約(spectra-ask 規矩移植):首行 blockquote 原問題;claim 必附引用;source priority closed-with-PR > open > orphaned comment、分歧 surface 不靜默擇一;結尾 ### Referenced Issues語料查無 → 誠實說查無,不從訓練記憶腦補
  • 與 find 分工:find = 「在哪」(ranked hits,低成本);ask = 「為什麼」(合成答案,高成本有界)— 互補成「先問、不滿意再自己翻」鏈
  • [design] Document 'surfacing-only primitive' skill family pattern (idd-list / idd-clarify / future idd-find?) (sibling concern from #139) #140 增員程序首戰:三題判準誠實記錄(Q3 delegate 消費者弱命中 — ask 類消費者本來就是人,spectra-ask 同構先例支撐 judgment),family 成員表 +1

Verification

新 suite idd-ask(RED 0/17 → GREEN 17/0);全 sweep 37 suites 0 fail;artifacts validate ✓(analyze 僅 1 個刻意 RFC-2119 MAY SUGGEST)。issue 結案不由本 PR 觸發 — merge 後走 close ritual。

…4th member)

Mirrors /spectra-ask for IDD's knowledge base (issues + comments + linked
PRs, open+closed): natural-language question -> decide-to-search gate
(greetings/meta skip; bug-shaped questions NEVER trigger diagnose) ->
retrieval delegating idd-find's search backend (family rule: never rebuild a
read-only query) -> full-text read of top-N hits (default 5, --limit capped
at 10 — the honest token-cost boundary) -> grounded synthesis: first line
blockquotes the question, every claim carries an issue/comment citation,
source priority closed-with-PR > open > orphaned comment with conflicts
surfaced, ending with Referenced Issues. Corpus silence is reported, never
filled from training memory. First live run of the #140 fourth-member
procedure: three-question gate recorded honestly (Q3 delegate-consumer is a
weak hit — ask-type skills serve humans, per the spectra-ask isomorph) and
the family member table updated. Discoverability: plugin CLAUDE.md row +
usecase-routing scenario 30. TDD: new suite idd-ask RED 0/17 -> GREEN 17/0;
sweep 37 suites 0 fail; Spectra change idd-ask-skill 4/4 tasks, validate
clean.

Refs #72
@kiki830621
kiki830621 merged commit f7a82e9 into main Jul 18, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant