Skill 設計：重複工作封裝成一句話觸發

用途

把每週都要重想一遍、步驟有規律的工作，設計成可重複觸發的 Claude Code Skill，讓一個指令就能跑完整個流程。

何時用

• 適合：發現某件事每週都在做、步驟有固定模式、每次都要從頭解釋給 AI 時；想把晨報、週報、發票整理、內容上架等重複任務標準化時。
• 不要用：一次性任務不要做成 Skill，額外維護成本不值得；或者步驟每次都不一樣（依情境高度客製化），做成 Skill 反而太硬，用對話式提示語更靈活。

Prompt

請幫我設計一個 Claude Code Skill，把以下重複工作封裝成單一指令。

指令名稱：/{{指令名}}
觸發場景：{{觸發場景——什麼情況下會用這個指令（如：每週一早上 / 每次接新案子 / 每晚睡前）}}

執行流程步驟（按順序）：
{{執行流程步驟——盡量具體，每個步驟說明做什麼、讀哪個檔案、輸出什麼}}

輸出格式：{{輸出格式——如：條列清單 / Markdown 報告 / JSON / 直接更新指定檔案}}

邊界條件（遇到以下情況怎麼處理）：
{{邊界條件（如：找不到檔案 / API 連不上 / 資料為空）}}

請輸出：完整 Skill Markdown 文件，格式符合 ~/.claude/commands/ 規範，包含：
- 觸發條件說明
- 每個步驟的執行邏輯（含失敗處理）
- 輸出格式規範
- 使用範例（填好的具體例子）

輸出的 Skill 可以直接存到 ~/.claude/commands/{{指令名}}.md 使用。

範例 / 變體

• 填好變數：指令名填 weekly-report；觸發場景填「每週五下午完成當週工作後」；流程步驟填「讀取本週 Jira 完成票 → 讀 Gmail 重要信件 → 整合成週報 → 存到 docs/weekly/」；輸出格式填「Markdown 週報文件」；邊界條件填「Jira MCP 連不上時只用 Gmail 部分，標記 Jira 資料缺失」。
• 變體（排程版）：在觸發條件加「配合 Claude Routines 設定每週五 17:00 自動觸發」，讓 Skill 成為真正的自動化。
• 變體（團隊共用版）：把 Skill 存到 .claude/commands/ 而非 ~/.claude/commands/，讓整個 repo 的團隊成員都能用同一個指令。

🎯 範例輸出（實測）

在 Claude Code 跑這句、把 {{變數}} 填成「指令名：weekly-report；觸發場景：每週五下午；流程：讀 Jira 完成票 → 讀 Gmail 重要信 → 整合成週報 → 存到 docs/weekly/；輸出：Markdown 週報；邊界：Jira 連不上時只用 Gmail 部分並標記缺失」的結果：

點開看 AI 實際輸出

存到 ~/.claude/commands/weekly-report.md：

---
name: weekly-report
description: 每週五自動整合 Jira + Gmail 產出週報，存到 docs/weekly/
trigger: 手動觸發（/weekly-report）或 Claude Routines 每週五 17:00
---

# 週報自動生成 — /weekly-report

## 觸發條件
- 手動：在 Claude Code 輸入 /weekly-report
- 自動：配合 Routines 每週五 17:00 觸發

## 執行流程

### 步驟 1 — 讀取 Jira 已完成票
使用 Jira MCP 查詢本週（週一 00:00 起）狀態為「Done」且指派給我的票：
- 取：票號 / 標題 / 完成日 / story points
- 失敗處理：若 MCP 連線失敗，記錄 "Jira 資料缺失" 並繼續步驟 2

### 步驟 2 — 讀取 Gmail 重要信件
搜尋最近 7 天 label:client/action 未回覆信件：
- 取：主旨 / 寄件者 / 日期 / 建議行動
- 失敗處理：Gmail MCP 失敗則跳過，標記缺失

### 步驟 3 — 整合產出週報
合併兩份資料，生成以下結構：
- 本週完成（Jira 票列表）
- 待處理信件（client/action 清單）
- 下週計畫（根據未完成票推算）
- 風險提醒（有無逾期或卡住的票）

### 步驟 4 — 存檔
儲存到 docs/weekly/YYYY-WXX.md（ISO 週次命名）

## 輸出格式
Markdown 週報，段落：本週完成 / 待處理信件 / 下週計畫 / 風險提醒

## 邊界條件
| 情況 | 處理方式 |
|------|---------|
| Jira MCP 連不上 | 只用 Gmail 部分，週報頂部標記「⚠️ Jira 資料缺失，請手動補充」 |
| Gmail MCP 連不上 | 只用 Jira 部分，標記缺失 |
| docs/weekly/ 目錄不存在 | 自動建立目錄後存檔 |

## 使用範例
在 Claude Code 輸入：/weekly-report
輸出：docs/weekly/2026-W23.md

💡 實測心得：「邊界條件」是這個 prompt 最容易被省略、但影響最大的欄位——Jira MCP 連線不穩的情況在實務中比想像中常見；先把「某個來源斷了怎麼辦」想清楚再封裝，Skill 上線後才不會因為偶發問題就整個失效。

延伸

重點來了：Skill 設計最大的錯誤是「太早標準化」。建議先用對話式提示語跑 3 次，確認步驟穩定、輸出品質夠好，再把它封裝成 Skill。這樣封裝的 Skill 通常第一次用就能跑通，不需要反覆調整。

如果你已經有一批重複工作想一次整理，可以先列出清單，按「觸發頻率 × 步驟固定程度」排序，優先做頻率高又固定的那幾個。