Technical Research
SkillDev toolsTakes over the plan package's `spec.md`, produces the plan-side `research.md`, and acts as the truth owner to update `specs/truth/techstack.md`. Every run must inventory the techstack truth's ADD / MODIFY / DELETE / NOOP, and upon completion delegate `/truth-delta` to update this plan's `truth-delta
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 Technical Research skill
What this skill tells your AI
The instructions your AI receives, as published by waterball-software-academy/aixbdd in .agents/skills/technical-research/SKILL.md and read by ahel’s review.
technical-research 同時產出研究過程與技術堆疊真相:research.md 留在 plan package,specs/truth/techstack.md 是整個系統目前唯一 techstack truth。
SOP
Phase 1 -- 對齊 plan 與 techstack truth
- READ 讀取使用者需求、呼叫者要求、目標 plan package 的
spec.md、既有research.md、truth-delta.md、specs/truth/techstack.md與必要 codebase 邊界。 - READ 讀取
templates/research.md、templates/research.example.md、templates/techstack.md與templates/techstack.example.md,確認 research 與 techstack 的責任邊界。 - READ 讀取
rules/Research輸出定位與spec後接續判準.md,確認research.md寫入 plan package、techstack.md寫入specs/truth/techstack.md。 - READ 讀取
.agents/constitution/CONSTITUTION.md、.agents/constitution/shared.md、.agents/constitution/skills/technical-research/research.md與.agents/constitution/skills/technical-research/techstack.md。
Phase 2 -- 收斂研究缺口與 truth 變更風險
- READ 讀取
rules/AIxBDD必問問題與起始專案介面澄清判準.md,對過spec.md、既有techstack.md與使用者這輪原話,標出尚未拍板的必問題。 - DELEGATE 若 BDD techstack、測試策略、或起始專案下系統有哪些端尚未拍板,呼叫
/clarify;未問完前停止,不進入 Phase 3。 - THINK 必問題已拍板後,再從
spec.md與現有 techstack truth 整理其餘要拍板的核心決策、候選方案、已知限制、比較面向與成功條件。 - READ 若需要判斷其餘缺口是否升級 clarify,讀取
rules/Clarify升級門檻與研究提問預算判準.md。 - DELEGATE 若其餘缺口會改變決策集合、候選方案、技術邊界,或高影響修改/刪除既有 techstack truth,呼叫
/clarify;未收斂前停止。
Phase 3 -- 產出 research 與更新 techstack truth
- READ 需要確認 research 與 techstack 最小必要資訊時,讀取
rules/研究artifact最小必要資訊判準.md與rules/techstack-artifact最小必要資訊判準.md。 - WRITE 將 decision-driven 研究內容寫入
specs/plans/NNN-<slug>/research.md。 - WRITE 依現有 truth 與本輪決策更新
specs/truth/techstack.md,使其代表目前系統完整技術堆疊,不保留「以某 plan 為準」的分散說法。 - THINK 將 techstack truth 改動整理為語意單元層級的 ADD / MODIFY / DELETE / NOOP 列。
Phase 4 -- 更新 truth-delta 並交付
- DELEGATE 呼叫
/truth-delta,傳入 plan package、truth root、owner/technical-research與本輪 techstack truth 改動列。 - WRITE 向使用者回報
research.md、specs/truth/techstack.md、truth-delta.md、主要技術決策與殘餘風險。
Signals
- GitHub stars
- 81
- Forks
- 18
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
technical-research-waterball-software-academy- Source
- github.com/waterball-software-academy/aixbdd