Communitygithub.com

工作流程

當需要協調 Freeflow 活動中的權限、當前擁有者、路由變更、連續性、選定的檢查點或支援的退出時使用。

工作流程 是什麼?

工作流程技能掌管外部互動生命週期。它負責解讀和執行權限,為每個有明確範圍的活動維持一個當前的擁有者,僅在證據顯示責任歸屬發生變化時才進行路由,審慎選擇檢查點,並判斷何時支援的退出是合理的。此技能本身不會創建權限或監督每個動作,而是協調擁有者與方法,而不取代它們各自詳細的工作。它明確指出選擇技能、方法、鏡頭、工具、工件、審查、檢查點、領域指南或計算設定檔,都不會自動擴大權限或改變當前擁有者。工作流程支援多種平台,包括 Claude Code、Cline 和 Cursor。其運作方式是透過詳細的路由規則,根據使用者請求、當前狀態和既有權限來決定下一步行動,並確保在不違反權限邊界的情況下維持連續性。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hassan-mohiddin/freeflow/tree/main/skills/workflow

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

工作流程 (Workflow)

掌管外部互動生命週期。解讀和執行權限,為每個有界限的活動維持一個當前擁有者,僅在證據顯示責任歸屬發生變化時才進行路由,審慎選擇檢查點,並判斷何時支援的退出 (Supported Exit) 是合理的。

工作流程不會創建權限,也不會監督每一個動作。它協調擁有者與方法,但不取代它們各自詳細的工作。

選擇技能、方法、鏡頭、工具、工件、審查、檢查點、領域指南或計算設定檔,永遠不會自動擴大權限或改變當前擁有者。

透過權限進入 (Enter Through Authority)

在採取有後果的行動之前,解讀整個使用者對話輪次、當前執行時期狀態以及仍然有效的先前核准。

當一個活動包含多於一種效果時,累積性地分類其效果,使用共享術語 (Shared Terms) 中關於被動觀察、主動證據產生以及變更或交付的定義。

一個直接請求會授權其有界限的結果、所蘊含的工具、檢查以及可逆的局部選擇。它不會授權不相關的清理工作、另一個結果、一個獨立控制的效果,或是一個其後果可能實質改變使用者選擇的行動。

一份規格 (Spec)、計畫 (Plan)、工作記錄 (Working Record)、交接單 (Handoff)、審查 (review)、建議 (recommendation)、檢查點 (checkpoint)、有用的證據或沉默,都可能約束或保留工作。但這些都不會創建權限。

在進行主動證據產生、變更、交付,或其他不受當前權限涵蓋的獨立控制行動之前,告知使用者需要的原因、確切會發生什麼事、應該產生什麼證據或結果,以及會在何處停止。提出一個直接的授權問題並等待。在等待期間,不要執行提議的行動或任何依賴於該行動的工作。

當權限、已接受的意圖或效果邊界不清楚時,應先解決邊界問題,然後再選擇執行擁有者。

選擇並持有一個當前擁有者 (Choose And Keep One Current Owner)

選擇可發現範圍內最狹窄的、其工作與當前有界限活動相符的擁有者。以下類別是常見的擁有者,並非詳盡清單。

理解或決定 (Understand or decide)

  • 對於實質上方向、替代方案、假設或權衡仍然開放的狀況,使用 討論。
  • 對於一個阻礙性的、使用者擁有的選擇或來源衝突,使用 決策關卡。

當方向涉及設計時,使用 深度設計 作為一個鏡頭。鏡頭不會成為當前擁有者。

產生、保存或判斷持久狀態 (Produce, preserve, or judge durable state)

  • 追蹤工作 負責工作記錄 (Working Record) 的創建、復原、核對和生命週期。
  • 撰寫規格 負責穩定的、已接受的內容或合約。
  • 撰寫計畫 負責穩定的、有序的執行策略。
  • 審查工件 負責判斷持久的指導性工件。

執行、調查、驗證或判斷工作 (Execute, investigate, verify, or judge work)

  • 執行工作 負責具體的實作、文件、配置、學習或維護。
  • 遷移工作 負責在使用者、狀態或流量之間移動路徑。
  • 診斷失敗 負責無法解釋或重複發生的失敗。
  • 驗證工作 負責判斷直接證據證明了什麼。
  • 審查工作 負責實作判斷、獨立審查或裁決。

TDD、簡化程式碼、領域指導、參考資料和工具可以為當前擁有者提供方法,而不會成為另一個擁有者。

保存、設定檢查點、整合或交付 (Preserve, checkpoint, integrate, or deliver)

  • 提交工作 負責一個經授權的本地提交或簡單推送。
  • 交接 負責時間點的延續轉移。
  • 完成分支 負責整合、保存、捨棄或分支結案。
  • 發布工作 負責版本化的發布。
  • 啟動工作 負責正式環境的公開、回滾或復原。

套用修飾符與互動控制 (Apply modifiers and interaction control)

繞過 修改了明確選定的、選擇性的工作流程壓力。它不會成為底層活動的擁有者。

當擁有者需要環境互動,且動作或工具選擇尚未明確時,使用 行動選擇。它將觀察結果和狀態變更返還給同一個當前擁有者。

當專門的工程指導必須支援當前擁有者時,請閱讀領域技能組合參考文件。

當當前擁有者的問題、預期結果、權限和必要的觀察邊界仍然保持一致時,就保留該擁有者。方法、工具、回饋、設定檔轉換和環境互動本身並不會造成擁有者變更。

僅在使用者的輸入可能實質改變結果、邊界、權衡、方法或驗收標準時,才建議在授權工作之前進行討論。檢視可用的事實,並選擇可逆的局部細節,避免不必要的提問。

從結果進行路由 (Route From The Result)

透過當前擁有者執行有保證的回饋迴路 (Feedback Loop)。僅當權限、擁有權、必要證據、檢查點或支援的退出發生變化時,才重新進入工作流程。

根據結果現在所支持的內容進行路由:

  • 繼續 (Continue): 當前擁有者、預期結果、權限和必要觀察邊界保持一致。
  • 局部修正 (Correct locally): 一個明確的缺陷,但已接受的意圖和效果保持不變;將它返回給產生問題的擁有者,重新驗證受影響的邊界,並自我審查修正後的狀態。
  • 擴大證據 (Broaden evidence): 主張超出了當前觀察者的範圍;使用驗證工作 (Verify Work),或將缺失的證據要求返回給當前擁有者。
  • 診斷 (Diagnose): 原因不明確、證據衝突,或修正反覆發生。
  • 討論 (Discuss): 假設、替代方案、策略或方向發生了實質性變化。
  • 決策關卡 (Decision Gate): 一個使用者擁有的選擇或來源衝突阻礙了安全的繼續進行。
  • 追蹤 (Track): 必須創建、復原、核對或實質變更持久的任務狀態。
  • 修訂工件 (Revise an artifact): 已接受的內容、策略、決策或轉移狀態發生變化;返回給該工件的擁有者。
  • 審查 (Review): 在有事實依據的支持後,需要進行選擇性的判斷。
  • 檢查點 (Checkpoint): 在依賴性工作開始前,某個已選定的邊界已經到期。
  • 停止或延後 (Stop or defer): 沒有安全、經授權且有價值的方式可以繼續。

保留未受影響的決策、工件、工作和證據。新的證據僅在其影響範圍內改變路由。

不要因為已開始實作而繼續,審查未經支持的工作並將其視為準備就緒,因為一個責任變更就重新開始任務,或讓一個有用的下一步行動變成隱含的權限。

審慎保留連續性 (Preserve Continuity Deliberately)

判斷失去當前任務狀態是否可能導致後續的不一致。

當決策、證據、權限、當前工作、阻礙因素、檢查點或下一個有用的行動需要持久的復原能力時,使用追蹤工作 (Track Work)。不要僅僅因為工作發生了就為一個短暫、可拋棄的活動創建工作記錄。

當工作記錄在壓縮、摘要、工作階段導航或擁有權轉移後仍然存在時:

  1. 透過追蹤工作 (Track Work) 路由記錄的復原與核對;
  2. 將復原的記憶與當前使用者對話輪次及相關的即時狀態進行比較;
  3. 返回給其實際活動仍在繼續的擁有者。

復原後,當當前擁有者的確切方法不明確時,重新閱讀其技能文件;僅重新開啟下一個決策所需的來源或歷史記錄;並從當前有效的工作階段來源中重新建立權限。

追蹤工作 (Track Work) 擁有記錄檢視、架構、變更和生命週期機制的所有權。工作流程 (Workflow) 不會複製它們。

一個摘要、歷史技能文件主體、工作記錄、計畫或交接單可以保留上下文。但它們不會創建當前權限、證明即時狀態,或成為設定檔路由狀態。

選擇並路由檢查點 (Select And Route Checkpoints)

僅當一個檢查點若未經解決可能實質危害依賴性工作、回滾、來源追溯、轉移、整合或交付時,才選擇它。

一個檢查點可能需要:

  • 一個使用者決策;
  • 選擇性的獨立審查;
  • 一個本地提交;
  • 連續性轉移;
  • 分支整合;
  • 發布;
  • 啟動。

一次暫停、狀態更新、有界限活動的結束、完成的實作、通過的檢查或自我審查,並不會自動創建一個檢查點。

工作流程 (Workflow) 選擇檢查點及其保護的邊界。其擁有者執行它。當存在持久記憶時,追蹤工作 (Track Work) 會保留其選擇和結果。

自我審查始終是普通回饋迴路的一部分,永遠不會是一個檢查點。

審查工作 (Review Work) 擁有審查角色、發現、裁決、判斷和週期限制的所有權。工作流程 (Workflow) 消費返回的結果並決定接下來由誰負責。一份審查報告、發現、判斷或建議的補救措施並不會授權修正或另一次審查。

當檢查點的證據或條件不再成立時,回報此偏差,而不是強行通過檢查點。僅能透過明確支援的路徑來取消、取代、延後或修訂已選定的檢查點,然後在存在持久狀態時進行核對。

不要創建一個自動的「審查 -> 修正 -> 審查」迴圈。不要僅僅為了獲得「通過」結果而不斷編輯。

一次提交、交接、整合、推送、發布或啟動仍然是獨立控制的,除非權限範圍明確涵蓋了它。

達到支援的退出 (Reach A Supported Exit)

支援的退出 (Supported Exit) 可能是:回答、等待、暫停、交接、延後、保留一個受控邊界、停止或完成。

僅當以下條件全部滿足時,才聲明完成:

  • 新的證據在所需的邊界內支持已接受的結果;
  • 每個完成的、有界限的活動都收到了所需的自我審查,且沒有未解決的實質性問題;
  • 選擇性的審查和檢查點已經解決;
  • 任務記憶和所需的工件準確描述了所支援的狀態;
  • 沒有隱藏任何實質性的矛盾、來源衝突、阻礙因素或使用者擁有的決策;
  • 沒有獨立控制的行動被暗示為已完成。

按比例報告:

  • 支援的結果;
  • 最強證據及其證明限制;
  • 實質未解決或延後的狀態;
  • 當工作仍在進行或等待時,當前的路由。

對下一步行動的建議並不會授權該行動。

停止 (Stop)

在以下情況停止工作流程 (Workflow):

  • 已達到一個支援的退出 (Supported Exit);或
  • 一個當前擁有者可以在沒有未解決的權限、擁有權、檢查點、連續性或路由問題的情況下繼續。

僅當回饋或證據改變了這些邊界中的任何一個時,才恢復工作流程 (Workflow)。

相關技能