Clarify Over Specs
SkillDev tools在 `/specify` 產出 `spec.md` 後,主動掃描整份 spec 的高影響需求缺口;若仍有會影響規格正確性、驗收標準或 readiness 的問題,先委派 `/clarify` 訪談使用者,再把答案回寫到 spec、清理矛盾並回刷 checklist。Use when the user asks for post-spec requirement clarification, wants a generated spec professionally reviewed before `/plan`, or needs a spec-level clarify pass after `/specify`.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Clarify Over Specs skill
What this skill tells your AI
The instructions your AI receives, as published by waterball-software-academy/aixbdd in .agents/skills/clarify-over-specs/SKILL.md and read by ahel’s review.
在 spec.md 已存在的前提下,對既有 spec artifact 進行主動式需求澄清。先對齊目標 spec.md 與 checklists/requirements.md,再以全 spec 掃描方式盤點高影響缺口,只把真正會改變規格正確性、驗收標準、故事邊界、資料模型、NFR 邊界或後續 readiness 判定的問題升級給 /clarify;資訊收斂後,將答案整合回 spec、清理矛盾與術語漂移,並同步更新 checklist 與完成回報。
SOP
Phase 1 -- 對齊目標 spec 與回寫範圍
- READ 讀取使用者需求、呼叫者要求、當前上下文、任何顯式覆寫參數,以及目前 feature 的
spec.md與checklists/requirements.md;確認本次要澄清的 spec 目標、是否存在 checklist、是否需要詳記完成回報。若找不到目標spec.md,停止並要求使用者先執行/specify或明確指定目標 spec 路徑。 - THINK 若需要決定目標
SPEC_FILE、CHECKLIST_FILE與覆寫優先順序,先讀取rules/目標spec定位與覆寫優先順序判準.md,再依其要求收斂本次目標檔案與回寫範圍。
Phase 2 -- 掃描全 spec 高影響缺口與 clarify 策略
- THINK 先從整份
spec.md盤點會影響需求正確性、驗收可驗證性、故事切分、資料模型、NFR 邊界、術語一致性或 readiness 判定的模糊、矛盾、缺漏與未拍板決策。 - THINK 若需要判斷哪些缺口必須升級為
/clarify、哪些可直接保留為 deferred 風險或留在 spec 中明示,先讀取rules/spec高影響缺口掃描與提問排序判準.md,再依其要求收斂本輪最高影響的 1 至 3 個缺口、指定提問面向,以及本輪不應追問的低影響細節。 - DELEGATE 若仍存在會改變 spec 正確性、正式驗收標準、跨故事需求邊界、關鍵資料約束、NFR 承諾或 readiness 判定的高影響缺口,呼叫
/clarify先訪談使用者,指定優先提問面向為本輪已收斂的缺口,並要求本輪只處理 1 至 3 題;未收斂前停止,不自行假設答案。
Phase 3 -- 將澄清結果整合回 spec
- READ 讀取
/clarify產出的已確認決策、使用者補充與剩餘風險,確認哪些答案需要回寫到spec.md,哪些缺口仍應保留為 deferred 或NEEDS CLARIFICATION。 - THINK 若需要判斷答案應寫回哪些 section、哪些舊敘述應被替換或刪除、哪些術語需要統一,先讀取
rules/spec回寫位置與矛盾清理判準.md,再依其要求收斂本次要更新的 section、矛盾清理方式與術語統一策略。 - WRITE 依思考結果更新
SPEC_FILE,把已確認答案整合進對應 section,清理被新答案推翻的舊敘述與術語漂移;若仍有高影響缺口未解,明示保留狀態與後續建議,不以腦補補完。
Phase 4 -- 回驗 spec 與 checklist
- THINK 若需要判斷哪些 checklist 項應切換狀態、哪些 section 已達到 ready、以及完成回報應呈現哪些更新結果,先讀取
rules/checklist回刷與完成報告判準.md,再依其要求收斂本次 checklist 更新、ready 判定、deferred 風險與完成回報重點。 - WRITE 若
CHECKLIST_FILE存在,依思考結果只更新實際狀態有變化的 checkbox,保留其餘內容不動;若本次沒有 checklist,跳過此步但保留對 ready 狀態的明示說明。 - READ 回頭檢查
SPEC_FILE、CHECKLIST_FILE(若存在)與本輪已確認答案是否一致,且沒有遺留被本輪答案推翻的舊敘述、重複規格或衝突結論;若不一致,立即修正。
Phase 5 -- 交付結果與後續 handoff
- WRITE 先讀取
templates/clarify-over-specs-report.md與templates/clarify-over-specs-report.example.md,再依其要求向使用者回報本次目標SPEC_FILE、是否進入/clarify、實際處理的高影響缺口、更新 section、checklist 變化、仍 deferred 的風險,以及建議下一步應直接進/plan或稍後再執行一次/clarify-over-specs。
Signals
- GitHub stars
- 81
- Forks
- 18
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
clarify-over-specs- Source
- github.com/waterball-software-academy/aixbdd