# Sa

> Methodologies for System Analysis (SA), focusing on technical architecture, data flow modeling, and API design. Use when this capability is needed.

- Skill: `tomevault-io/sa-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/sa-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/sa-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/sa-2

---


# System Analysis (SA) Skill

本技能專注於系統分析與設計 (System Analysis & Design)，旨在將 PRD 中的業務需求轉化為可執行的技術方案。SA 是連接 "What to do" (PRD) 與 "How to do" (Code) 的橋樑。

## SA 的核心職責

1.  **架構設計 (Architecture Design)**: 定義系統的高層結構、模組劃分與職責。
2.  **資料建模 (Data Modeling)**: 設計資料庫 Schema、資料結構與存儲方案。
3.  **介面設計 (Interface Design)**: 定義 API 規格、函數簽名 (Function Signatures) 與互動協議。
4.  **流程邏輯 (Process Logic)**: 透過圖表 (Flowchart, Sequence Diagram) 釐清複雜的業務邏輯。
5.  **測試策略 (Testing Strategy)**: **[Critical]** 分析變更對現有測試的影響，並定義測試計畫。

## SA 產出物 (Artifacts)

*   **System Design Document (SDD)**: 系統設計說明書 (注意：此縮寫與 Spec-Driven Development 相同，需視上下文而定)。本技能中我們使用 `references/system_design_doc.md`。
*   **API Specification**: API 規格書 (Swagger/OpenAPI or Markdown)。
*   **Database Schema**: ER Model 或 JSON Schema 定義。

## 如何使用此 Skill

當 User 需要進行技術評估或設計時 (e.g., "幫我規劃一下這個功能的資料結構"):

1.  **Analyze**: 審閱 PRD，確認所有功能需求的技術可行性。
2.  **Model**:
    *   **Data**: 設計 JSON 物件或 DB Table。
    *   **Process**: 繪製 Mermaid Sequence Diagram。
3.  **Validate Tests**: 
    *   搜尋與變更模組相關的所有測試檔案 (grep/find)。
    *   分析測試代碼是否依賴將被更改的內部實作 (Internal Imports) 或 DOM 結構。
    *   在 SA 文件中明確列出 *必須修改的測試檔案* 與 *必須保留的 DOM 結構*。
4.  **Design**: 填寫 `system_design_doc.md` 模板。
5.  **Review**: 請 User 確認技術方案是否符合專案架構規範。

## 常用工具

*   **Mermaid**: 用於繪製流程圖、循序圖、類別圖與狀態圖。請參考 `references/diagram_guide.md`。
*   **TypeScript / JSDoc**: 用於精確定義資料型別與介面。

## 檢查清單 (Checklist)

*   [ ] 是否考慮了邊界情況 (Edge Cases)？
*   [ ] 資料結構是否具備擴充性？
*   [ ] 是否符合現有的程式碼風格與架構模式？
*   [ ] 是否評估了性能影響 (Performance Impact)？
*   [ ] **[Must]** 是否已識別所有受影響的測試案例，並規劃了與程式碼變更同步的測試修正？

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/tai-ch0802) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->