---
name: help-article-writer
description: 針對客戶的單一任務撰寫說明中心或知識庫文章：以任務為標題、答案放最前面、編號步驟使用畫面上的確切名稱，附截圖預留位置、疑難排解與相關文章。適用於有人要求寫說明文章、客服文件、操作教學、知識庫頁面，或要把工單回覆、版本說明、零散筆記改寫成客戶能自己照著做的文章時。
---

# 說明文章撰寫

說明文章讓客戶不必聯絡客服就能完成一項任務。他們從搜尋進來，快速找到自己的任務，一邊開著產品一邊照步驟操作。以任務為標題，答案放最前面，每個步驟只做一個動作，名稱與畫面上顯示的完全一致。

## 適用情境

- 工單裡一直出現同一個問題，而答案只存在客服人員的回覆裡。
- 新功能上線，客戶需要知道怎麼用。
- 現有文章太長、已過時，或用的是內部用語。
- 不適用於涵蓋多個問題的 FAQ 清單：請改用 faq-from-tickets。也不適用於版本說明：請改用 release-notes。

## 需要準備

- 文章涵蓋的任務，以及誰會做（所有使用者、僅限管理員、特定方案）。
- 實際步驟：產品上顯示的畫面、按鈕與選單名稱。如果只有文字描述，就照描述寫步驟，並把每個不確定的名稱標註「[確認名稱]」。
- 已知問題：客戶遇到的錯誤，來自工單或產品團隊。
- 選填：可以列為相關文章的現有文章。

## 步驟

1. **以任務為標題。** 用客戶搜尋時的說法，以動詞開頭：「將聯絡人匯出成 CSV」「邀請成員加入工作區」。不要寫「匯出功能」或「認識匯出」。一篇文章一項任務；筆記涵蓋 2 項任務，就寫 2 篇。
2. **在前 2 句給出答案。** 說明這項任務做什麼、最短的路徑：「你可以從 **聯絡人 > 匯出** 匯出聯絡人。檔案會在幾分鐘內寄到你的信箱。」接著說明誰可以做，以及事前需要什麼（角色、方案、權限）。
3. **寫編號步驟，每步一個動作。** 每個步驟以動詞開頭。畫面名稱用粗體，與顯示的寫法完全相同（包括英文大小寫）。選單路徑寫成 **設定** > **團隊**，箭頭不加粗。先說位置再說動作：「在右上角點選 **設定**。」控制在 3 到 10 步；更長的話，分成各有標題的段落。
4. **說明成功時會看到什麼。** 最後一步之後，用一行說明完成時客戶應該看到什麼：一則訊息、一個檔案、清單中的新項目。
5. **在有幫助的地方標註截圖。** 在目標難找或畫面很複雜的步驟後加上預留位置，不是每一步都加。寫出截圖要呈現什麼，方便之後補拍，也能當作替代文字。
6. **依實際問題加上疑難排解。** 每一項以客戶描述的症狀為標題，再用 1 到 3 句說明原因與解法。只用來自工單或產品團隊的問題；不要捏造錯誤。
7. **連結 2 到 4 篇相關文章。** 客戶接下來很可能要做的任務，以及事前要完成的任務。有提供文章實際標題就用；沒有就寫「[相關：主題]」。

## 輸出格式

```markdown
# [以動詞開頭的任務標題]

[這項任務做什麼與最短路徑，1–2 句。]

**誰可以操作：**[角色／方案] · **開始之前：**[事前準備，沒有就刪除]

## [任務，或任務的第一部分]
1. 在[位置]點選 **[名稱]**。
2. [...]

![截圖：呈現的內容]

完成後，[客戶會看到什麼]。

## 疑難排解
### [客戶描述的症狀]
[原因與解法，1–3 句。]

## 相關文章
- [文章標題]
```

## 範例

**輸入：**

> 產品團隊的筆記：管理員可以從 設定 → 團隊 →「邀請成員」按鈕邀請成員，輸入電子郵件（以逗號分隔），選擇角色「成員」或「檢視者」，再按「傳送邀請」。邀請 7 天後失效。工單：有人說一直沒收到邀請信（通常在垃圾郵件匣，或信箱打錯）；非管理員看到的「邀請成員」是灰色的。

**輸出：**

```markdown
# 邀請成員加入你的工作區

你可以從 **設定** > **團隊** > **邀請成員** 邀請成員。對方會收到一封附加入連結的信，連結 7 天內有效。

**誰可以操作：**工作區管理員

## 傳送邀請
1. 在左側選單點選 **設定**。
2. 點選 **團隊**。
3. 點選 **邀請成員**。
4. 輸入一個或多個電子郵件地址，以逗號分隔。
5. 選擇角色：**成員** 或 **檢視者**。
6. 點選 **傳送邀請**。

![截圖：「邀請成員」視窗，已輸入兩個電子郵件地址，角色選單已展開]

完成後，每位受邀者都會以「已邀請」狀態出現在團隊清單中，直到對方加入。

## 疑難排解
### 一直沒收到邀請信
請對方檢查垃圾郵件匣。如果也沒有，先確認團隊清單中的電子郵件地址，再重新傳送邀請。

### 「邀請成員」是灰色的
只有管理員可以邀請。請工作區管理員邀請對方，或請管理員把你設為管理員。

## 相關文章
- [相關：變更成員的角色]
- [相關：移除成員]
```

## 寄出前檢查

- [ ] 標題以動詞開頭，且只有一項任務。
- [ ] 不看步驟，前 2 句也已回答問題。
- [ ] 每個步驟只有一個動作，每個畫面名稱都是粗體，且與產品一致或已標註「[確認名稱]」。
- [ ] 文章說明了誰可以操作，以及成功時會看到什麼。
- [ ] 每一項疑難排解都來自工單或產品團隊。
- [ ] 沒有出現內部用語（工單、SKU、功能旗標、後端）。

## 常見錯誤

- 以背景說明開頭（「團隊是……的重要一環」）。讀者是為了步驟而來。
- 寫成「前往設定頁面並設定你的團隊」。要寫出每一次點選。
- 每一步都放截圖。頁面會變得很長，而且每次介面改版都會過時。