hellowind777/helloagents

解決的問題

HelloAGENTS 解決了 AI 編碼 CLI 中常見的失敗問題，例如代理過早停止（僅提供建議而非實作）、將困難任務的責任推給使用者、跨會話遺失專案上下文，以及未實際驗證即報告完成。它透過新增結構化的工作流程層，確保 AI 代理能作為可靠的執行者，持續完成建構、驗證與收尾任務。

如何運作

它作為現有 AI 編碼工具（如 Claude Code、Gemini CLI、Grok Build、Cursor 和 Codex CLI）之上的層進行整合。透過使用「技能」（專門的規則集）與聊天指令（以 ~ 開頭）來引導代理的行為。

關鍵機制包括：

• 工作流程技能：14 個內建技能（例如 hello-ui、hello-security、qa-review），根據任務類型自動啟用，以強制執行品質標準。
• 專案知識庫：在磁碟上維護一個 .helloagents/ 目錄，用於儲存專案概覽、編碼指南與模組筆記，防止代理重複發現事實。
• 結構化規劃：使用「計畫包」（需求、任務與合約）與 PRD 檔案來管理複雜工作，而非依賴聊天歷史記錄。
• 狀態恢復：在 STATE.md 與 runtime.json 中追蹤會話狀態，支援在不同工作區或會話間恢復執行。
• 驗證門檻：在任務標記為完成前，要求提供交付證據（如視覺驗證或測試結果）。

適用對象

希望獲得更高可靠性、更嚴格品質控制與更好長期專案記憶的 AI 編碼 CLI 使用者。

主要亮點

• 14 個專業技能：針對 UI、API、安全、測試、架構等任務的特定規則。
• 聊天驅動指令：透過 ~plan、~build、~qa 與 ~auto 等指令直接控制。
• 持久化知識：將專案上下文與指南儲存在磁碟上，減少上下文視窗浪費。
• 交付證據：超越「測試通過」，要求提供結構化證據以完成最終交付。
• 廣泛整合：支援多個主流 AI CLI，包括 Claude Code、Gemini、Grok、Cursor 與 Codex。