On this page

HelloAGENTS - AI 编程 CLI 的工作流增强层

是什么

一个为 AI 编程 CLI（如 Claude Code, Gemini CLI, Codex CLI）设计的工作流管理层。它在 AI 代理和底层执行器之间加入了一层「质量控制」与「状态管理」，防止 AI 代理因过度自信而提前停止工作或忽略验证。

GitHub： github.com/hellowind777/helloagents
定位： AI 编程助手 $\rightarrow$ 生产级 AI 软件工程师的「标准化工作流」插件

解决啥

痛点	方案
提前停止 / 交付不足 $\rightarrow$ AI 经常在给出建议后就说「完成了」，而未实际构建验证	强制交付检查：引入 `~verify` 和 delivery evidence 机制，要求提供实证（如日志、测试结果）才允许 closeout
质量波动 $\rightarrow$ 每次生成质量取决于 Prompt，缺乏一致性	14 项任务感知技能 (Quality Skills)：根据任务类型（UI/API/Security 等）动态加载专用质量检查标准
上下文碎片化 $\rightarrow$ 计划仅存在于聊天记录中，重启后丢失	项目知识库 (.helloagents/)：将架构、指南、验证命令持久化到磁盘（`context.md`, `guidelines.md`）
配置风险 $\rightarrow$ AI 修改配置文件可能导致系统不可用或漂移	安全配置管理：提供 `install`, `update`, `doctor` 等指令，显式管理插件注入和链路状态

怎么跑

HelloAGENTS 以 Node.js 包的形式分发，通过一个轻量级的 CLI 进行管理：

安装主程序： npm install -g helloagents
部署到 AI CLI：
- helloagents install claude --standby (安装到 Claude Code)
- helloagents install --all --global (全球模式，所有项目强制执行规则)
在 AI 聊天中调用： 使用 ~ 前缀指令触发特定工作流。
- 例如：输入 ~plan 开始需求分析与方案设计 $\rightarrow$ ~build 执行实现 $\rightarrow$ ~verify 验证交付。

好在哪

能力	说明
标准工作流 (Structured Plan)	将复杂任务分解为 `requirements.md` $\rightarrow$ `plan.md` $\rightarrow$ `tasks.md` $\rightarrow$ `contract.json` 的结构化包
多维度质量门禁	内置 `hello-ui`, `hello-security`, `hello-perf` 等 14 个专业领域技能，强制 AI 在实现前先对照标准思考
状态可恢复性	通过 `.helloagents/sessions/` 记录状态快照，支持长任务的中断与恢复
端到端验证	区别于「代码写完了」，它要求「验证通过了」，通过 `.ralph-visual.json` 等文件记录交付证据

亮点： 它将 AI 编程从「单次对话」模式转变为了「软件工程」模式，通过强制性的验证环节和结构化的知识沉淀，极大地降低了 AI 代理的失控率。

怎么用

复杂功能开发： ~prd $\rightarrow$ ~plan $\rightarrow$ ~build $\rightarrow$ ~verify (全流程覆盖，确保不漏项)。
UI/UX 实现： 激活 hello-ui 技能，确保视觉实现符合设计契约（Design Contract）。
项目初始化： ~init 快速建立项目知识库，让 AI 瞬间理解当前仓库的非显见约定。
迭代优化： ~loop 建立「指标 $\rightarrow$ 尝试 $\rightarrow$ 验证 $\rightarrow$ 决策」的循环迭代闭环。

by 文殊