System Analysis
SkillDev toolsBased on the plan package's `spec.md`, `research.md`, `truth-delta.md`, and `specs/truth/**`, inventory the system interfaces and analysis waves involved in this requirement, produce the plan-side `plan.md`, and pass the plan package, truth root, and truth-delta path to `/api-plan`, `/data-plan`, an
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 System Analysis skill
What this skill tells your AI
The instructions your AI receives, as published by waterball-software-academy/aixbdd in .agents/skills/system-analysis/SKILL.md and read by ahel’s review.
system-analysis 是 planner orchestration skill。它本身不修改 truth,但必須把本輪 plan 與既有 truth 的差異帶給後續 owner,避免 API、data、UI 分析各自推理不同版本。
SOP
Phase 1 -- 對齊 plan、truth 與控制平面
- READ 讀取使用者需求、呼叫者要求、目標 plan package 的
spec.md、research.md、truth-delta.md、既有plan.md、specs/truth/techstack.md與相關specs/truth/**。 - READ 讀取
templates/plan.md與templates/plan.example.md,確認plan.md的固定結構與完成樣貌。 - READ 讀取
.agents/constitution/CONSTITUTION.md、.agents/constitution/shared.md與.agents/constitution/skills/system-analysis/plan.md。 - WRITE 若 plan package 尚未有
plan.md父層,建立必要目錄;本 skill 不建立或修改specs/truth/**。
Phase 2 -- 收斂系統介面盤點與 clarify 策略
- THINK 從需求原文、
spec.md、research.md、truth-delta.md與現有 truth 整理本次需求部位、外部依賴、資料責任、UI 責任與技術端點。 - READ 需要判斷介面邊界時,讀取
rules/系統介面盤點與端點歸類判準.md。 - DELEGATE 若缺口會改變系統介面數量、端點類型、介面邊界、truth owner 責任或 Wave 切分,呼叫
/clarify;未收斂前停止。
Phase 3 -- 規劃分析 Wave 並產出 plan
- READ 需要判斷先後與平行分組時,讀取
rules/Wave依賴排序與平行分組判準.md。 - THINK 依介面依賴、truth 變更風險與可平行程度安排 Wave,確認每個介面至少被一個後續 planner 承接。
- WRITE 將系統介面盤點、Wave、分析重點與委派理由寫入
specs/plans/NNN-<slug>/plan.md。
Phase 4 -- 委派 planner 並交付
- READ 需要判斷 planner 對應時,讀取
rules/分析介面委派與planner對應判準.md。 - DELEGATE 依 Wave 順序將 API 介面交給
/api-plan、資料介面交給/data-plan、UI 介面交給/ui-plan;每次 handoff 都必須包含 plan package path、truth root、truth-delta path、介面名稱與分析重點。 - WRITE 向使用者回報
plan.md、系統介面數量、Wave 數量、委派到哪些 planner,以及是否可進入/dsl-refine或/tasks。
Signals
- GitHub stars
- 81
- Forks
- 18
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
system-analysis- Source
- github.com/waterball-software-academy/aixbdd