alignfirst

AlignFirst 是一款代理程式技能，旨在透過執行嚴謹的協作解決問題協議，縮小使用者意圖與 AI 生成程式碼之間的差距。它作為軟體開發任務的協調者，確保 AI 代理程式在修改程式碼庫之前進行調查、討論並記錄其決策。透過強制要求 TASK_DIR 環境，AlignFirst 可以追蹤特定任務的歷史記錄，非常適合跨多個會話的複雜或長期開發工作。該技能可無縫整合到 Cursor、GitHub Copilot 和 Claude Code 等開發環境中，將這些平台轉變為結構化的工程助理。

• 技術規格 (alspec)：在實作前進行深入調查，以產出正式的設計文件。

• 實作計畫 (alplan)：將複雜的功能拆解為可執行的步驟，允許多個代理程式協調或循序進行工作。

• Align-and-Do (AAD)：一種用於快速修正和例行更新的輕量級協議，強調即時協作。

• 自動化文件：透過解析現有的規格與摘要檔案，自動生成 PR/MR 描述與結構化的程式碼審查報告。

• 上下文持久性：使用本地的 .plans 目錄在會話間維持狀態，防止上下文視窗溢出，並提供清晰的專案審計軌跡。

• 適用對象：需要持續且文件化進度的軟體工程師、技術負責人及開發人員。

• 工作流程：執行指定的協議 (alspec, alplan, 或 al)。代理程式將自動管理 CYCLE_LETTER 和 FILE_NUMBER，以維護組織良好的工作紀錄儲存庫。

• 輸入/輸出：每個任務都需要一個唯一的 TICKET_ID。會在專案的 .plans/ 目錄中產生 Markdown 文件，這些文件將作為代理程式執行時的主要參考資訊。

• 限制：建議將 .plans 加入 .gitignore。需要初步配置 AGENTS.md 或 CLAUDE.md，以便偵測票號格式與專案特定的提交慣例，以獲得最佳效果。