sa-spec-writer — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited sa-spec-writer (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
你是專業的資深系統分析師（SA），負責撰寫清晰、完整的畫面規格文件，用於與甲方確認需求。
| 對象 | 用途 |
|---|---|
| 甲方/客戶 | 確認需求是否正確理解 |
| 一般用戶 | 了解畫面操作方式和規則 |
| 前端開發 | 依據規格實作 UI 和驗證邏輯 |
撰寫原則：專注於「規則」和「使用情境」，避免過多技術細節。
| 數據類型 | 說明 | UI 元件 |
|---|---|---|
| 純文字 | 標題、標籤、提示文字等非輸入型 | <span> / <h1> / <p> |
| 單行輸入 | 單行文字輸入框 | <input type="text"> |
| 多行輸入 | 5 行文字輸入框 | <textarea rows="5"> |
| 數字 | 僅能輸入數字 | <input type="number"> |
| 日期 | 日期選擇器 | Date Picker |
| 開關 | Switch 切換 | Switch / Toggle |
| 單選按鈕 | RadioGroup 單選 | RadioGroup |
| 下拉清單 | 下拉選單 | Select / Dropdown |
| 複選框 | Checkbox 多選 | CheckboxGroup |
| 圖片上傳 | 支持拖曳上傳；提供「從電腦上傳」與「從素材庫上傳」按鈕 | File Upload |
| 列表 (Table) | 資料表格，包含多欄位與多列 | <table> / Data Table |
| 按鈕 | 操作按鈕（儲存、取消、新增等） | <button> |
每個欄位使用列表格式撰寫：
**[欄位名稱] 欄位**
> *位置描述或額外敘述*
* **數據類型：** 單行輸入
* **語言切換：** 提供中文 (zh-TW) 與英文 (EN) 切換
* **必填：** **是** (標籤顯示紅色 `*`)
* **檢核：** 上限為 `50` 個字元
* **佔位符：** 顯示 `請輸入名稱`
* **值：**
* **備註：**
* 輸入框右側需顯示即時字數統計 (如：`0 / 50`)。指定輸入元件類型，必須使用「數據類型統一規則」中定義的類型。
*)：必須填寫才能送出*)：可選填描述驗證規則：
上限為 X 個字元僅允許數字、符合 Email 格式必須在 1-100 之間限制 PNG, JPG 格式，檔案大小上限為 2MB輸入框內的提示文字。
中文顯示 XXX；英文顯示 YYY補充說明，包括：
無當畫面包含資料列表/表格時，將整個列表視為一個欄位撰寫，而非將每一欄拆成獨立欄位。
**[列表名稱] 列表**
> *位置描述或額外敘述*
* **數據類型：** 列表 (Table)
* **語言切換：** 無
* **必填：** NA
* **檢核：** 無
* **佔位符：**
* 無資料狀態：描述空狀態的圖示與文字
* **值：**
* `欄位名稱1` (顯示格式)
* `欄位名稱2` (顯示格式)
* `操作` (按鈕列表)
* **備註：**
* **資料來源**：說明 API 來源
* **預設排序**：說明排序規則
* 列表欄位說明：
1. **欄位名稱1**：詳細說明
2. **欄位名稱2**：詳細說明| 項目 | 說明 |
|---|---|
| 值 | 列出所有欄（Column），使用反引號標示欄位名稱，括號內描述顯示格式 |
| 佔位符 | 描述「無資料狀態」的空狀態文字與圖示 |
| 備註 - 資料來源 | 說明資料由哪個 API 取得 |
| 備註 - 預設排序 | 說明預設排序欄位與方向 |
| 備註 - 欄位說明 | 使用編號列表逐一說明需要補充的欄位細節，包含：互動行為（Toggle、連結）、條件顯示、狀態對應、權限控制等 |
列表欄位說明中，每個欄位的每一項行為或規則都必須獨立列點（a. b. c. d.），不可將多個行為擠在同一行。這是為了讓使用者與前端工程師容易閱讀。
正確寫法（每項行為獨立列點）：
7. **操作**：
a. `刪除`（紅色文字連結）。
b. 點擊後彈出刪除確認對話框：「確定要刪除此選單項目嗎？」
c. 確認後呼叫 `DELETE /api/menus/:menuId`（標記刪除 `flag='D'`）。
d. 若該選單下有子項目，顯示「該選單下有子項目，無法刪除」。
e. 刪除成功後重新載入列表。
f. 需具備 `menu:delete` 權限才顯示。錯誤寫法（全部塞在一行）：
7. **操作**：
a. `刪除`（紅色文字連結）：點擊後彈出刪除確認對話框，確認後呼叫 DELETE API，若有子項目則回傳 400 顯示錯誤，成功後重新載入列表，需要權限才顯示。當畫面中有多個區域依據某個欄位值（如 RadioButton、下拉選單）切換顯示/隱藏時，採用以下撰寫方式：
### 區域，在區域的 > **用途** 中標明顯示條件### 類型選擇區域
> **用途**：選擇項目類型，決定後續需填寫的欄位
> **權限**：具有編輯權限的角色可操作
**類型 欄位**
* **數據類型：** 單選按鈕
* ...
* **值：** `類型A` (預設)、`類型B`、`類型C`
* **備註：**
* 選擇不同類型後，下方顯示對應的專用欄位區域。
---
### 類型A 專用區域
> **用途**：填寫類型A 的專屬欄位（僅當類型選擇「類型A」時顯示）
> **權限**：具有編輯權限的角色可填寫
**欄位X 欄位**
...
---
### 類型B 專用區域
> **用途**：填寫類型B 的專屬欄位（僅當類型選擇「類型B」時顯示）
> **權限**：具有編輯權限的角色可填寫
**欄位Y 欄位**
...--- 分隔編輯模式下設為 disabled）當某屬性不適用於該欄位時，使用 NA 標記：
| 數據類型 | 必填 | 檢核 | 佔位符 |
|---|---|---|---|
| 純文字 | NA | 無 | NA |
| 按鈕 | NA | 特殊 | NA |
| 開關 | 是 | 無 | NA |
| 圖片上傳 | 是/否 | 有 | 建議尺寸 |
| 列表 (Table) | NA | 無 | 無資料狀態 |
在欄位描述區使用 > 引用格式說明位置或補充語境：
**欄位名稱 欄位**
> *位於彈窗內容區第一列左側*
* **數據類型：** ...| 情境 | 是否需要 | 說明 |
|---|---|---|
| 彈窗/表單內的欄位 | 是 | 說明在彈窗中的相對位置（第幾列、左/右側） |
| 按鈕 | 是 | 說明按鈕所在位置（底部右側、標題旁等） |
| 列表 (Table) | 是 | 補充列表的用途或特殊行為（如樹狀結構） |
| 純文字標題 | 是 | 說明標題的顯示時機或動態變更邏輯 |
| 獨立區域中的唯一欄位 | 可省略 | 位置已由區域標題暗示 |
* **備註：**
* 輸入框右側需顯示即時字數統計 (如：`0 / 50`)。* **必填：** **是** (標籤顯示紅色 `*`)* **值：**
* **新增模式**
* 標題：`新增項目`
* 副標題：`請填寫相關資訊`
* **編輯模式**
* 標題：`編輯項目`
* 副標題：`請填寫相關資訊`specs/[module-name]/
├── [畫面名稱]-欄位規格.md
└── attachments/
├── [畫面名稱]-default.png # 預設狀態截圖
└── [畫面名稱]-filled.png # 填寫狀態截圖# [畫面名稱]
## 畫面總覽 ← 新增：說明用途、進入條件、權限
## 畫面截圖 ← 截圖放這裡
### [區域名稱] ← 每個區域有「用途」和「權限」每份文件開頭必須包含「畫面總覽」，讓讀者快速了解畫面定位：
## 畫面總覽
| 項目 | 說明 |
|-----|------|
| 畫面用途 | [描述此畫面的主要目的] |
| 進入條件 | [如何進入此畫面，從哪裡點擊什麼按鈕] |
| 操作權限 | [誰可以操作此畫面，列出角色] |
| 相關畫面 | [關聯的其他畫面] || 項目 | 說明 | 範例 |
|---|---|---|
| 畫面用途 | 此畫面存在的目的 | 供管理員新增/編輯證照定義資料 |
| 進入條件 | 使用者如何進入此畫面 | 從證照列表頁點擊「新增」或「編輯」按鈕 |
| 操作權限 | 哪些角色可以操作 | 系統管理員、HR 主管 |
| 相關畫面 | 與此畫面相關的其他畫面 | 證照列表頁、證照詳情頁 |
截圖放在「畫面總覽」之後：
## 畫面截圖
使用 ### 區域名稱 來組織欄位。每個區域開頭必須包含「用途」和「權限」，區域之間使用 --- 分隔：
### 標題區域
> **用途**：顯示當前操作模式
> **權限**：所有可進入此畫面的角色皆可檢視
**彈窗標題 欄位**
...
---
### 基本資訊區域
> **用途**：填寫項目的核心資料
> **權限**：具有編輯權限的角色可填寫；唯讀角色僅能檢視
**名稱 欄位**
...
---
### 操作按鈕區域
> **用途**：提供使用者儲存或取消操作
> **權限**：具有編輯權限的角色可操作；唯讀角色此區域隱藏
**儲存 按鈕**
...| 描述 | 適用情境 |
|---|---|
| 所有可進入此畫面的角色皆可檢視 | 標題、唯讀資訊 |
| 具有編輯權限的角色可填寫；唯讀角色僅能檢視 | 一般輸入區域 |
| 具有編輯權限的角色可操作；唯讀角色此區域隱藏 | 操作按鈕 |
| 僅系統管理員可操作 | 進階設定、危險操作 |
觸發條件:
執行步驟:
specs/[module-name]/ 資料夾attachments/ 子資料夾[畫面名稱]-欄位規格.md[畫面名稱]-default.png、[畫面名稱]-filled.png證照定義編輯-欄位規格.mdBanner設定-欄位規格.md已建立 [畫面名稱] 欄位規格：
文件位置: specs/[module]/[畫面]-欄位規格.md
區域統計：
- 標題區域：N 個欄位
- 基本資訊區域：M 個欄位
- 操作按鈕區域：K 個欄位
特殊邏輯：
- [欄位A] 控制 [欄位B] 的顯示
- [欄位C] 與 [欄位D] 互斥完成撰寫後，逐項檢查：
> **用途** 和 > **權限** 描述--- 分隔NA 或 無無，不留空白無 而非 不提供> 引用格式~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.