finna/Finn-loop

解決的問題

Finn-loop 將使用 Linear 和 GitHub 的標準開發工作流程轉變為 AI 驅動的「軟體工廠」。它自動化了軟體生命週期中繁瑣的部分——規格制定、實作和審查——同時確保人類對於最終合併到程式碼庫的內容保留最終決策權。

運作方式

該系統以三個 Claude Code 自訂技能的形式運作，這些技能整合了 Linear（用於問題追蹤）和 GitHub（用於版本控制和 CI）：

1. 規格制定 (/finn-spec)：AI 透過與使用者訪談，將模糊的想法轉化為詳細的 Linear 問題，並包含明確的驗收標準和非目標。
2. 實作 (/finn-build)：AI 從 Linear 認領一個 agent-ready 的問題，實作所需的變更，進行驗證，並開啟一個 GitHub Pull Request。
3. 審查 (/finn-review)：AI 根據原始的 Linear 契約和 GitHub 狀態檢查來審查待處理的 PR，並對 PR 是否準備好合併提供判決。

使用者可以循環執行這些流程（使用 /loop），以持續處理就緒問題的佇列和待處理的審查。

適用對象

使用 Claude Code、Linear 和 GitHub，並希望自動化執行小型、定義明確之任務，同時不放棄最終合併決策控制權的軟體工程師和產品負責人。

亮點

• 人工管控工作流程：嚴格執行只有人類才能合併程式碼的規則。
• 契約驅動開發：使用 Linear 問題作為唯一的事實來源；如果某個需求不在問題中，代理程式就不會建構它。
• 整合式工具：利用 GitHub CLI (gh) 和 Linear 連接器進行無縫的狀態管理。
• 可擴充架構：提供從簡單循環進化為具備 Slack 整合、風險感知合併和自動監控程式之完整工廠的路線圖。