astro:help — 如何使用這條工作流
astro: 工作流是一組技能，用於在 AI 協助下從合約到 PR/交付進行開發，並透過一個程式碼門閘（gate）強制執行安全屏障。每個技能都是一個階段；請按順序使用，但只需呼叫你需要的部分。
工作流一覽
| 階段 | 指令 | 使用時機 |
|---|---|---|
| 0 · 合約 | astro:setup | 在開始/恢復一個專案時，寫程式碼之前。 |
| 1 · 規劃 | astro:plan | 描述了一個變更，並希望在實作前取得計劃。 |
| 2 · 執行 | astro:exec | 執行整個計劃，一次一個任務。 |
| 3 · 關閉 | astro:commit | 產生訊息並提交一個邏輯變更。 |
| 3 · 關閉 | astro:pr | 建立 Pull Request 的描述。 |
| 3 · 關閉 | astro:answer | 提供給 QA/PO 的任務交付文字（本地檔案）。 |
| 門閘 | astro:gate | 在瀏覽器中開啟門閘規則編輯器。 |
| 幫助 | astro:help | 本指南。 |
典型流程
astro:setup（每個專案一次）——在CLAUDE.md中簽訂合約（安全屏障 + 模式），偵測技術棧，若為 Laravel 專案則下載架構並確保每個領域有一個AGENTS.md。安裝門閘：迷你應用程式ai-gate/（SQLite）會產生.claude/hooks/astro_gate.py並註冊一個鉤子，該鉤子會攔截禁止的指令。astro:plan——你描述變更；它會先了解情況，只詢問需要你決定的事項（AskUserQuestion），提出一個計劃，在你確認後，將計劃分解為會話中的任務（不會在專案中建立檔案）。astro:exec——執行計劃，一次一個任務，只實作範圍內的內容，遵循合約和架構，並進行真實測試（實際輸出）。astro:commit——訊息格式為TYPE: Title+ 變更清單（繁體中文，過去分詞）；每個邏輯變更一個提交。- 關閉：
astro:pr（PR 描述）和/或astro:answer（提供給 QA/PO 的交付文字，儲存在本地不提交的檔案中）。
門閘（程式碼保證）
提示引導，門閘保證：每次指令執行前都會被檢查，如果包含禁止的文字（migrate:fresh、rm -rf、git push --force、truncate……）則攔截。規則可以編輯：
astro:gate（或python3 ai-gate/app.py）會開啟 UI（http://127.0.0.1:8787）來新增/編輯/停用規則；產生門閘會重新寫入.claude/hooks/astro_gate.py。- 產生的門閘是獨立運作的——也可以在 VM/CI 中作為 CLI 執行：
python3 astro_gate.py "$CMD" && eval "$CMD"。
適用於所有階段的原則
- 只問需要你決定的事；其餘由你決定（使用安全的預設值，並告知假設）。
- 從來源確認，不要虛構 API/路由/欄位/版本。
- 小規模且可審閱的變更；同時進行測試；真實的證據，而不是空口聲明。
- 不可破壞、不包含機密、不上傳依賴——門閘會加強這點。