command-creator

指令建立器

此技能引導建立 Claude Code 斜線指令——可在 Claude Code 對話中以 /command-name 呼叫的可重複使用工作流程。

關於斜線指令

斜線指令是存放在 .claude/commands/（專案層級）或 ~/.claude/commands/（全域/使用者層級）的 Markdown 檔案，呼叫時會展開為提示詞。它們非常適合：

• 重複性工作流程（程式碼審查、PR 提交、CI 修正）
• 需要一致性的多步驟流程
• 代理程式委派模式
• 專案特定自動化

何時使用此技能

當使用者有以下情況時呼叫此技能：

• 要求「建立指令」或「製作斜線指令」
• 想要自動化重複性工作流程
• 需要記錄一致的流程以供重複使用
• 說「我一直在做 X，可以為它建立一個指令嗎？」
• 想要建立專案特定或全域指令

隨附資源

此技能包含參考文件以提供詳細指引：

• references/patterns.md - 指令模式（工作流程自動化、迭代修正、代理程式委派、簡單執行）
• references/examples.md - 真實指令範例與完整原始碼（submit-stack、ensure-ci、create-implementation-plan）
• references/best-practices.md - 品質檢查清單、常見陷阱、撰寫指南、範本結構

在建立指令時視需要載入這些參考資料，以了解模式、查看範例或確保品質。

指令結構概覽

每個斜線指令都是一個 Markdown 檔案，包含：

---
description: 在 /help 中顯示的簡短說明（必要）
argument-hint: <placeholder>（選用，若指令接受引數）
---

# 指令標題

[供代理程式自主執行的詳細指示]

指令建立工作流程

步驟 1：決定位置

自動偵測適當位置：

1. 檢查 Git 儲存庫狀態：git rev-parse --is-inside-work-tree 2>/dev/null
2. 預設位置：
   • 若在 Git 儲存庫內 → 專案層級：.claude/commands/
   • 若不在 Git 儲存庫內 → 全域：~/.claude/commands/
3. 允許使用者覆寫：
   • 若使用者明確提到「全域」或「使用者層級」→ 使用 ~/.claude/commands/
   • 若使用者明確提到「專案」或「專案層級」→ 使用 .claude/commands/

在繼續前向使用者報告所選位置。

步驟 2：顯示指令模式

協助使用者了解不同的指令類型。載入 references/patterns.md 以查看可用模式：

• 工作流程自動化 - 分析 → 執行 → 報告（例如 submit-stack）
• 迭代修正 - 執行 → 解析 → 修正 → 重複（例如 ensure-ci）
• 代理程式委派 - 上下文 → 委派 → 迭代（例如 create-implementation-plan）
• 簡單執行 - 使用引數執行指令（例如 codex-review）

詢問使用者：「哪一種模式最接近您想建立的內容？」這有助於聚焦對話。

步驟 3：收集指令資訊

向使用者詢問關鍵資訊：

A. 指令名稱與用途

詢問：

• 「指令應該叫什麼？」（用於檔名）
• 「這個指令做什麼？」（用於 description 欄位）

指引：

• 指令名稱必須使用 kebab-case（連字號，不要底線）
  • ✅ 正確：submit-stack、ensure-ci、create-from-plan
  • ❌ 錯誤：submit_stack、ensure_ci、create_from_plan
• 檔名需與指令名稱相符：my-command.md → 以 /my-command 呼叫
• 說明應簡潔、以行動為導向（顯示在 /help 輸出中）

B. 引數

詢問：

• 「這個指令需要任何引數嗎？」
• 「引數是必要還是選用？」
• 「引數應該代表什麼？」

若指令接受引數：

• 在前置資料中加入 argument-hint: <placeholder>
• 使用 <angle-brackets> 表示必要引數
• 使用 [square-brackets] 表示選用引數

C. 工作流程步驟

詢問：

• 「這個指令應該遵循哪些具體步驟？」
• 「它們應該以什麼順序進行？」
• 「應該使用哪些工具或指令？」

收集以下細節：

• 要執行的初始分析或檢查
• 要採取的主要動作
• 如何處理結果
• 成功標準
• 錯誤處理方式

D. 工具限制與指引

詢問：

• 「這個指令應該使用任何特定的代理程式或工具嗎？」
• 「有沒有任何工具或操作應該避免？」
• 「它應該讀取任何特定檔案以取得上下文嗎？」

步驟 4：產生最佳化指令

建立包含代理程式最佳化指示的指令檔案。載入 references/best-practices.md 以取得：

• 範本結構
• 代理程式執行的最佳實務
• 撰寫風格指引
• 品質檢查清單

關鍵原則：

• 使用祈使句/不定詞形式（動詞優先的指示）
• 明確且具體
• 包含預期結果
• 提供具體範例
• 定義清晰的錯誤處理

步驟 5：建立指令檔案

1. 決定完整檔案路徑：

   • 專案：.claude/commands/[command-name].md
   • 全域：~/.claude/commands/[command-name].md

2. 確保目錄存在：

   mkdir -p [目錄路徑]
   

3. 使用寫入工具寫入指令檔案

4. 向使用者確認：

   • 報告檔案位置
   • 摘要說明指令功能
   • 解釋如何使用：/command-name [arguments]

步驟 6：測試與迭代（選用）

若使用者想測試：

1. 建議測試：You can test this command by running: /command-name [arguments]
2. 準備根據回饋進行迭代
3. 視需要更新檔案以進行改善

快速提示

如需詳細指引，請載入隨附的參考資料：

• 設計指令工作流程時載入 references/patterns.md
• 查看現有指令的結構時載入 references/examples.md
• 定稿前載入 references/best-practices.md 以確保品質

要記住的常見模式：

• 使用 Bash 工具執行 pytest、pyright、ruff、prettier、make、gt 指令
• 使用 Task 工具呼叫子代理程式處理專業任務
• 先檢查特定檔案（例如 .PLAN.md）再繼續
• 立即標記待辦事項為完成，不要批次處理
• 包含明確的錯誤處理指示
• 定義清晰的成功標準

總結

建立指令時：

1. 偵測位置（專案 vs 全域）
2. 顯示模式以聚焦對話
3. 收集資訊（名稱、用途、引數、步驟、工具）
4. 產生最佳化指令，包含代理程式可執行的指示
5. 建立檔案於適當位置
6. 確認並迭代視需要

專注於建立代理程式可自主執行的指令，包含清晰的步驟、明確的工具使用方式以及適當的錯誤處理。