GitHub 工作流程
選擇要求的操作，並遵循其任務參考。每個操作都在一個普通的議題或 PR 上進行，且不包含先前的 ghflow 任務。僅載入目前所需的任務和共享規則。套用 工作環境與工具輸出 以處理參考載入、搜尋和交接。
在決定如何執行操作之前，請套用 執行模式。本地模型工作應停留在當前工作階段，不使用子代理。此模式會覆寫任務中關於派遣工作人員或啟動全新審查工作階段的指示。
定位來源與工具
透過任何符號鏈結解析此 SKILL.md 的路徑。其父目錄即為 GHFLOW_SKILL_DIR。在該目錄下使用絕對路徑來處理參考和子代理交接。在執行指令範例之前，請將 GHFLOW_CLI 設定為其下 cli/ghflow.py 的絕對路徑。請將路徑用引號括起來。命令工具可以為每次呼叫啟動一個新的 shell，因此請在每個使用該變數的命令中導出它，或直接寫入完整路徑：
export GHFLOW_CLI="ABSOLUTE_SKILL_DIRECTORY/cli/ghflow.py"
python3 "$GHFLOW_CLI" --help
將 ABSOLUTE_SKILL_DIRECTORY 替換為解析後的目錄。解析後的技能目錄就是原始碼檢出根目錄。直接使用其 cli/ghflow.py。保持目前目錄在目標專案中，以便 Git、GitHub 和身分設定使用該專案。透過每個參考的連結來解析寫入指導，而非透過目前目錄。如果來源讀取需要外部目錄權限，請報告已解析的檢出路徑，並使用 來源存取權限 中的設定指示。請勿在未告知的情況下更改代理權限。
選定的任務參考會指名其所需的共享規則。當條件成立時開啟一個共享參考，並閱讀擁有該決策權的章節；請勿在第一次操作前閱讀所有共享參考。條件如下：授權 於出現權限或範圍問題時；證據 於報告結果或傳遞識別碼之前；決策 於缺乏事實或選擇時；代理身分 於代理執行 Git 或 GitHub 命令之前；GitHub 寫入 於變更 GitHub 記錄之前。CLI 讀取不授予寫入權限。
選擇要求的操作
將使用者的明確請求與下方的操作進行比對。從使用者的請求或目標檢出中識別主體儲存庫。python3 "$GHFLOW_CLI" facts 會報告檢出、儲存庫、工具、身分就緒狀態以及專案事實檔案；加上 --issue ISSUE_URL 則會新增該議題的分支、工作目錄、PR 和看板項目。應使用此命令代替分別執行 git 和 gh 讀取來獲取該狀態，並在其報告有 .ghflow/project.md 時讀取該檔案。對於本地模型工作階段的開始，preamble ISSUE_URL 會將這些事實列印成一個緊湊的區塊，適合放在第一個提示中。原始碼檢出提供指示和工具；其遠端和已設定的帳戶無法識別主體。如果選定的儲存庫、議題或 PR 缺失，請在進行 GitHub 搜尋或派遣前返回所需的輸入。對於僅評估的請求，請解釋操作和限制，而無需執行交付。如果某個關鍵端點不清楚，僅詢問該決定。請勿選擇待辦事項工作或添加固定的執行順序。交付請求預設為審查後續追蹤，並保持其 PR 處於開啟狀態。閱讀其協調參考，並套用選定的執行模式來處理派遣和審查要求。
| 請求 | 任務參考 |
|---|---|
| 重新評估現有議題 | reconsider-issue |
| 定義想法或議題（包括僅草稿工作） | define-issue |
| 與使用者確定議題決策 | interview-issue |
| 將廣泛的父議題拆分為子議題 | decompose-parent-issue |
| 發布已審查的議題草稿 | file-issue |
| 透過本地提交實作議題 | implement-issue |
| 獨立審查程式碼變更 | review-changes |
| 將已提交的變更發布為 PR | submit-pr |
| 處理 PR 回饋並修復 CI | address-pr-review |
| 合併一個經明確授權的 PR | merge-pr |
| 交付或處理一個選定的議題 | express-issue |
| 交付一個已同意的父議題 | deliver-parent-issue |
| 將相關議題分組到主題下 | bundle-issues |
| 評估一組請求的開放議題 | triage-issues |
| 解決需要輸入的議題 | sweep-needs-input |
| 定義已接受的議題 | sweep-needs-definition |
| 將未受阻的議題返回定義階段 | sweep-blocked |
| 審計已關閉的議題 | sweep-audit-closed |
| 對請求的看板範圍進行優先級排序 | sweep-prioritize |
| 將議題分階段放入「準備就緒」佇列 | curate-ready-queue |
| 交付一個明確請求的「準備就緒」佇列 | burndown-ready-queue |
| 撰寫或重新整理專案事實檔案 | prepare-project-facts |
執行與交接
對於需要持續進行或重建成本高昂的工作或發現，請套用 任務筆記。在恢復工作或經歷上下文壓縮後，請先閱讀現有的任務筆記，再重複研究或重新開啟決策。
遵循所選參考的範圍和停止點。將現有的授權延續到包含的任務中。僅草稿和唯讀限制仍然適用；實作或提交絕不代表有合併權限。
在委派模式下，套用 協調。將選定的操作和所需的輸入傳遞給子代理。如果委派或所需的審查模型不可用，請遵循共享規則並回報限制。
回傳操作的實際結果、來源、檢查以及剩餘的決策。明確報告缺失的功能和不完整的證據。