DSL Refine
SkillFiles & storageTruth owner skill. Takes the plan package's acceptance Gherkin and system-analysis artifacts, breaks business Journeys into interface-level executable feature files and DSL, and updates `specs/truth/features/backend/**` and `specs/truth/features/frontend/**`. When done, delegates to `/truth-delta` t
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 DSL Refine skill
What this skill tells your AI
The instructions your AI receives, as published by waterball-software-academy/aixbdd in .agents/skills/dsl-refine/SKILL.md and read by ahel’s review.
dsl-refine 是 interface feature 與 DSL 的 truth owner。Acceptance Gherkin 留在 plan package;拆解後可執行的前後端介面 feature/dsl 則寫入 specs/truth/features/**,代表目前系統測試規格真相。
SOP
Phase 1 -- 對齊 acceptance、系統介面與 feature truth
- READ 讀取使用者要求、目標 plan package 的
features/acceptance/**、plan.md、truth-delta.md、specs/truth/techstack.md、相關 UI plan,以及受影響介面的既有功能模組、feature、模組 DSL 與介面根共用 DSL。 - THINK 從
plan.md、truth-delta 與現有 feature truth 辨識本次涉及的前端、後端或其他系統介面,以及各介面既有 feature/dsl 是否需要 ADD / MODIFY / DELETE。 - WRITE 向使用者回報本輪辨識出的介面、預計新增/修改/刪除的 truth feature files 與 DSL 範圍。
Phase 2 -- 分派 acceptance 規則並處理高影響變更
- READ 讀取
rules/介面Gherkin原子化與單一Act判準.md,確認介面 Gherkin 原子化與單一 Act 邊界。 - THINK 逐一盤點 acceptance 的 Rule、Example、關鍵 Given / When / Then 與
# [need clarification],分派到相關介面,確認每條 acceptance 規則至少由一個 interface truth 承接。 - DELEGATE 若高影響 MODIFY / DELETE 會改寫既有 interface 行為、移除既有驗收或削弱 DSL 驗證契約,且尚未有明確使用者決策,呼叫
/clarify;未收斂前停止。
Phase 3 -- 更新 interface feature truth
- READ 讀取
../gherkin-and-dsl/SKILL.md與../gherkin-and-dsl/STANDARDS.md,承接其已掛載的 Gherkin、DSL 與唯一歸屬判準。 - WRITE 依已載入規則在唯一權威位置建立、修改、移動或刪除受影響的 interface feature 與 DSL rows。
- DELEGATE 呼叫
/gherkin-and-dsl檢查受影響介面,取得拓樸機械稽核、DSL 唯一歸屬、acceptance 覆蓋與 Gherkin 結構結果;若不符合,立即修正。 - THINK 將 feature/dsl truth 改動整理為語意單元層級的 ADD / MODIFY / DELETE / NOOP 列。
Phase 4 -- 更新 truth-delta 並交付
- DELEGATE 呼叫
/truth-delta,傳入 plan package、truth root、owner/dsl-refine、受影響模組、feature、模組 DSL、相關共用 DSL rows 與本輪 truth 改動列;DSL row 僅搬移權威位置而未改語意時,明示舊位置、新位置與「語意不變」。 - WRITE 向使用者回報更新的 interface feature/dsl truth、truth-delta 更新結果、已澄清決策、剩餘阻塞缺口,以及是否可交給
/tasks或/bdd。
Signals
- GitHub stars
- 81
- Forks
- 18
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
dsl-refine- Source
- github.com/waterball-software-academy/aixbdd