# 📦 QA 測項系統 — 部署包使用說明（先看這份）

> 你下載了「QA測項系統-部署包(022+023)」。這份 README 教你拿到包之後怎麼用。
> 照著做就能把整套系統架起來。有問題隨時問 general。

---

## 這個包是什麼？

這是「QA 測項展開系統」的完整還原包。用途:換機器、重建系統、或第一次架設時，一鍵把整套規則和文件裝回去。

**包裡有這些檔案:**

| 檔案 | 是什麼 | 給誰 |
|------|--------|------|
| `部署包使用說明.md`（本檔） | 拿到包怎麼辦 | 你 |
| `使用者指南.md` | 怎麼日常操作系統 | 你 / 測試人員 |
| `建置教學.md` | 怎麼串接 Google Sheet | 你（管理者） |
| `skill_022_final_recommendation.md` | 測項展開規則（規則 1~24） | 機器人（交給 general） |
| `SKILL-022-phase1.md` | 規格書轉 MD 規則 | 機器人（交給 general） |
| `_schema.md` | 轉 MD 的格式定義 | 機器人 |
| `SKILL-022-A8-ref.md` / `A9-ref.md` | A8/A9 用語對照表 | 機器人 |

---

## 三步驟裝好系統

### 【第一步】把包交給 general（它做程式的部分）

1. 到 general 頻道，上傳這個部署包
2. 說一句:「幫我用這個包還原 QA 測項系統」

**general 會自動幫你做:**
- 把規則檔（SOP、轉 MD 規則、用語表）放進兩個機器人的設定裡
- 把使用者指南、建置教學歸檔
- 建立 / 設定好兩個協作機器人:
  - **qa-test-expander**（主腦，負責展開測項）
  - **qa-sheet-worker**（讀寫工，負責讀寫 Google Sheet）

👉 這一步你只要「交包 + 說一句話」，其餘 general 自動處理。

---

### 【第二步】你親自做:申請 Google 帳號（general 代替不了）

因為這牽涉你的 Google 帳號權限，只能你本人在 Google 網站上操作。**照包裡的「建置教學.md」做:**

1. 到 Google Cloud 建專案、開啟 Google Sheets API
2. 建一個「機器人帳號」，記下它的 email
3. 下載機器人帳號的**金鑰檔（一個 JSON）**
4. 把 Sheet「共用」給機器人 email（權限給編輯者）

👉 詳細圖文步驟看「建置教學.md」第一部分。

---

### 【第三步】把金鑰交給 general → 完成串接

1. 把第二步下載的**金鑰 JSON 檔**傳給 general
2. general 自動:把金鑰放安全位置 + 寫好程式讀取 + 完成串接
3. 跟 general 說「串接好了嗎」→ 它確認後你就能開始用

---

## ✅ 一頁總覽（誰做什麼）

```
【交給 general 自動做】
  □ 用部署包還原規則、設定兩個機器人
  □ 拿到金鑰後完成程式串接

【你親自做（general 代替不了）】
  □ Google Cloud 申請機器人帳號
  □ 下載金鑰 JSON
  □ 把 Sheet 共用給機器人 email
  □ 把金鑰交給 general
```

**簡單記:「申請帳號、拿金鑰、共用 Sheet」你做；「程式串接、設定機器人」general 做。**

---

## 裝好之後怎麼用？

看包裡的「使用者指南.md」——從貼規格書連結、回答機器人問題、到看展開結果，都有白話步驟。

---

## 遇到問題

- 卡在建置（Google 那邊）→ 看「建置教學.md」的「你會遇到的狀況」
- 卡在串接 / 機器人沒反應 → 到 general 頻道說明卡在哪一步
- 不知道機器人 email → 在 qa-test-expander 頻道打「你的 email 是什麼」

---

*版本 v1.5 | 有任何一步不清楚，直接問 general。*