代理工作流 (斜槓指令)

使用預定義的 AI 腳本自動化執行複雜的多步驟流程。

---

🤖 什麼是代理工作流 (Agentic Workflows)？

代理工作流是位於 .agent/workflows/ 目錄中的專用 Markdown 檔案。它們充當 AI 代理的 標準作業程序 (SOP)。您不需要每次都輸入冗長重複的指令，只需啟動工作流即可。

核心優點

• 一致性：確保每次發布或功能開發都遵循完全相同的步驟。
• 自動化：工作流可以包含 AI 會為您執行的 Shell 指令。
• 條理性：將複雜的檢查清單與程式碼邏輯分開管理。

---

⚡ 如何啟動工作流

您可以在對話中使用 斜槓指令 (Slash Command) 來啟動任何工作流。

例如，如果您的 .agent/workflows/ 中有名為 release-prep.md 的檔案： 1. 在對話框輸入：/release-prep 2. Boring 會偵測到指令，載入該檔案，並開始按照清單逐步執行。

---

📂 以 release-prep.md 為例

這是一個內建的工作流，旨在為您的專案準備新的版本標籤 (Tag)。

它會做什麼：

1. 版本更新：提醒您更新 pyproject.toml 與初始化檔案中的版本號。
2. 文檔同步：提醒更新 Changelog 與 README 中的版本徽章。
3. 驗證驗證：自動執行 boring verify 確保發布版本是穩定的。
4. Git 操作：準備好 Git commit 與 tag 的相關指令。

---

🛠️ 建立您自己的工作流

只需在 .agent/workflows/ 中建立一個新的 .md 檔案即可。

範本：my-task.md

---
description: 對該指令的簡短描述
---

# 我的自定義任務

給 AI 遵循的詳細指令...

1.  [ ] 檢查 A 檔案
2.  [ ] 執行 `npm test`
3.  [ ] 回報結果

現在，您可以透過輸入 /my-task 來執行它。

---

💡 最佳實踐

• 使用核取方塊：[ ] 能幫助 AI 在多個步驟之間追蹤當前狀態。
• 包含指令：如果步驟需要執行 run_command，請明確寫出。
• 雙語支持：如果您的團隊有多國語言需求，您也可以建立 my-task_zh.md。