System Analysis

SkillDev tools

Based 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.

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 與控制平面

  1. READ 讀取使用者需求、呼叫者要求、目標 plan package 的 spec.mdresearch.mdtruth-delta.md、既有 plan.mdspecs/truth/techstack.md 與相關 specs/truth/**
  2. READ 讀取 templates/plan.mdtemplates/plan.example.md,確認 plan.md 的固定結構與完成樣貌。
  3. READ 讀取 .agents/constitution/CONSTITUTION.md.agents/constitution/shared.md.agents/constitution/skills/system-analysis/plan.md
  4. WRITE 若 plan package 尚未有 plan.md 父層,建立必要目錄;本 skill 不建立或修改 specs/truth/**

Phase 2 -- 收斂系統介面盤點與 clarify 策略

  1. THINK 從需求原文、spec.mdresearch.mdtruth-delta.md 與現有 truth 整理本次需求部位、外部依賴、資料責任、UI 責任與技術端點。
  2. READ 需要判斷介面邊界時,讀取 rules/系統介面盤點與端點歸類判準.md
  3. DELEGATE 若缺口會改變系統介面數量、端點類型、介面邊界、truth owner 責任或 Wave 切分,呼叫 /clarify;未收斂前停止。

Phase 3 -- 規劃分析 Wave 並產出 plan

  1. READ 需要判斷先後與平行分組時,讀取 rules/Wave依賴排序與平行分組判準.md
  2. THINK 依介面依賴、truth 變更風險與可平行程度安排 Wave,確認每個介面至少被一個後續 planner 承接。
  3. WRITE 將系統介面盤點、Wave、分析重點與委派理由寫入 specs/plans/NNN-<slug>/plan.md

Phase 4 -- 委派 planner 並交付

  1. READ 需要判斷 planner 對應時,讀取 rules/分析介面委派與planner對應判準.md
  2. DELEGATE 依 Wave 順序將 API 介面交給 /api-plan、資料介面交給 /data-plan、UI 介面交給 /ui-plan;每次 handoff 都必須包含 plan package path、truth root、truth-delta path、介面名稱與分析重點。
  3. 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