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。