Specify
SkillDev toolsConverts natural-language feature requirements into a new plan package. Each run creates the next `specs/plans/NNN-<slug>/`, producing `spec.md` and `checklists/requirements.md` and initializing `truth-delta.md`; it must not rewrite existing plan packages or write to `specs/truth/**`.
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 Specify skill
What this skill tells your AI
The instructions your AI receives, as published by waterball-software-academy/aixbdd in .agents/skills/specify/SKILL.md and read by ahel’s review.
specify 是每次迭代的 plan 起點。它只描述「這次要改什麼」,不直接修改系統 truth。即使本次需求是修改或刪除既有行為,也建立新的 plan package,讓舊 plan 保持歷史,讓 specs/truth/** 代表目前系統真相。
SOP
Phase 1 -- 建立新的 plan package
- READ 讀取使用者需求、呼叫者要求、目前
specs/plans/下既有編號與specs/truth/**的高層現況,確認本次功能主題、範圍、語言要求與明示限制。 - READ 讀取
templates/spec.template.md、templates/spec.example.md、templates/requirements-checklist.md與templates/requirements-checklist.example.md,確認 spec 與 checklist 的固定結構。 - READ 讀取
rules/Feature目錄命名與輸出定位判準.md,確認下一個NNN-<slug>plan package 命名方式與輸出定位。 - READ 讀取
.agents/constitution/CONSTITUTION.md、.agents/constitution/shared.md、.agents/constitution/skills/specify/spec.md與.agents/constitution/skills/specify/requirements-checklist.md,並將其中規則視為高於本地 artifact 規範的約束。 - WRITE 建立
specs/plans/NNN-<slug>/與checklists/,並初始化truth-delta.md骨架;本 phase 不建立或修改specs/truth/**。
Phase 2 -- 收斂需求缺口與 clarify 策略
- THINK 從需求與現有 truth 整理主要使用者目標、核心流程、顯性限制、品質期望、可能的 ADD / MODIFY / DELETE 意圖與可辨識範圍邊界。
- READ 若需要判斷哪些缺口必須升級為 clarify,讀取
rules/Clarify升級門檻與提問預算判準.md。 - DELEGATE 若缺口會改變使用者故事切分、需求歸戶、主要流程、正式驗收標準,或會高影響修改/刪除既有 truth 行為,呼叫
/clarify先訪談使用者;未收斂前停止,不自行假設答案。
Phase 3 -- 重建 spec 語意骨架
- READ 需要切分故事或需求歸戶時,讀取
rules/使用者故事切分與優先級判準.md與rules/FR與NFR歸戶到UserStory與全域需求判準.md。 - THINK 依已載入規則收斂可獨立驗證的 User Stories、Priority、驗收情境、故事專屬 FR / NFR、全域需求、邊界情況、關鍵實體、成功標準與假設。
- THINK 對涉及既有 truth 的需求,明確標示它預期是新增、修改或刪除現有系統行為,但不在本 skill 寫入 truth。
Phase 4 -- 產出 plan artifacts 並自檢
- WRITE 將 spec 寫入
specs/plans/NNN-<slug>/spec.md,將 checklist 寫入specs/plans/NNN-<slug>/checklists/requirements.md。 - READ 讀取
rules/spec完整性與一致性自檢判準.md,檢查使用者故事、FR / NFR、驗收情境、邊界情況、成功標準、假設與剩餘 clarify 缺口是否一致;若不符合,立即修正。
Phase 5 -- 交付後續 handoff
- WRITE 向使用者回報 plan package、spec、checklist、truth-delta 路徑、本次是否進入
/clarify、仍保留的NEEDS CLARIFICATION或假設,以及此 plan 是否可進入/spec-by-example或/technical-research。
Signals
- GitHub stars
- 81
- Forks
- 18
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
specify-waterball-software-academy- Source
- github.com/waterball-software-academy/aixbdd