HelloAGENTS 使用介绍：把 AI 编程从“能跑”变成“可交付”

很多团队已经在用 AI 写代码了，但“写出来”不等于“能交付”：输出格式不稳定、需求不清就开始改、变更缺少可追溯性、不同复杂度的任务却走同一套流程……这些都会把 AI 的效率优势吞掉。

HelloAGENTS 的定位很明确：它不是另一个聊天提示词，而是一套 AI 编程模块化技能系统。它通过“统一智能路由 + 多阶段技能（分析/设计/开发/知识库/模板）”，把一次次交互变成更像工程流程的执行链路：先验证需求质量，再选择合适的工作流，最后产出结构化结果与可追溯的变更清单。

本文以“怎么装、怎么用、怎么写出更容易被路由器正确理解的请求”为主，适合已经在用 Codex CLI 或 Claude Code 的开发者快速上手。

HelloAGENTS 解决的是什么问题

HelloAGENTS 在仓库里把痛点描述得很直接：AI 很强但不稳定、容易在需求模糊时猜测、决策不透明、输出结构随机、跨平台命令经常翻车。HelloAGENTS 用几组关键机制去“约束并增强”这些环节：¹

• 统一智能路由：基于语义、意图、范围与高风险信号（EHRB）自动选择工作流，而不是一刀切。¹
• 需求评分（10 分制，阈值 ≥7）：当目标/预期/边界/约束不够清楚时，先追问补齐再进入实现。¹
• 3 阶段推进：需求分析 → 方案设计 → 开发实施，减少“直接写代码然后反复返工”。¹
• 状态变量（G12）：在多轮对话里显式追踪“正在执行哪个方案包”，减少上下文丢失。¹
• 人性化安全防护（EHRB 升级）：检测到高风险线索时自动走更严格流程，避免误操作。¹

如果你把它理解成“给智能体加上路由器、需求闸门、输出模板、状态机”，就基本对上了。

快速安装（Codex CLI / Claude Code）

HelloAGENTS 的安装方式是“复制规则集到客户端配置目录”，无需额外依赖。官方 README 给出了路径约定：Codex CLI 使用 ~/.codex/，Claude Code 使用 ~/.claude/。¹

1）拉取仓库

git clone "https://github.com/hellowind777/helloagents" "helloagents"

2）复制到你的客户端目录

以 Codex CLI + 中文版 为例：¹

mkdir -p "$HOME/.codex"
cp -R "helloagents/Codex/Skills/CN/"* "$HOME/.codex/"

Claude Code + 中文版：¹

mkdir -p "$HOME/.claude"
cp -R "helloagents/Claude/Skills/CN/"* "$HOME/.claude/"

提示：如果你更偏好英文输出，把 CN 换成 EN 即可。¹

3）配置输出语言（非常关键）

README 强调：需要在入口规则文件里设置语言（例如 bootstrap: lang=zh-CN），并在客户端的全局规则里把 Response Language 配成“简体中文”，这样才能稳定按预期语言输出。¹²³

入口规则文件在不同客户端的命名不同：

• Codex CLI：AGENTS.md（示例路径：Codex/Skills/CN/AGENTS.md）²
• Claude Code：CLAUDE.md（示例路径：Claude/Skills/CN/CLAUDE.md）³

4）验证是否生效

重启终端后，直接问：

"显示技能引用表"

预期会列出 5 个技能引用（analyze / design / develop / kb / templates）。¹

如何使用：从“写提示词”到“写需求”

HelloAGENTS 的路由器会综合评估：你是在问答、要改代码、还是在执行命令；改动范围是微/小/中/大；需求是否足够明确；是否存在 EHRB 高风险信号。¹²

因此，想让它“选对工作流、少追问、快落地”，关键不在于写更长的提示词，而是把需求写完整（尤其是范围和验收标准）。

1）微调模式：明确到文件与行数

当你能把改动收敛到少量文件和很小行数时，尽量把信息一次写全（路径、位置、要改成什么），例如：¹

"修复 src/utils/helper.ts 第42行的拼写错误：'respose' 应该是 'response'"

2）轻量迭代：小范围多文件，别省略验收点

如果是 3–5 个文件左右的小范围改动，建议补充“范围 + 预期效果 + 不能破坏的约束”，避免被判定为需求模糊：¹

"为登录、注册和密码重置功能添加错误处理。
范围：仅修改现有逻辑，不引入新依赖。
验收：错误时返回统一错误码，并保留现有成功流程。"

3）完整研发：当你说不清，就先把它说清

你一旦提出“添加 OAuth2”“重构架构”“引入新模块”这类任务，HelloAGENTS 倾向进入完整流程并进行需求评分；低于阈值会追问补齐。¹

你可以把常见“追问点”提前写在请求里：

• 目标：要实现什么能力（而不是“加个登录”）
• 预期结果：怎么判断成功（接口/页面/指标/测试）
• 边界范围：改哪些模块，不改哪些
• 约束条件：性能、兼容性、依赖、上线风险等

常用命令：~auto / ~plan / ~exec / ~init

HelloAGENTS 提供了几类特殊命令，用来控制“只规划 / 只执行 / 全授权连续执行 / 初始化知识库”等行为：¹

• ~plan：只做规划（需求分析/方案设计），你审核通过再执行。
• ~exec：只执行 plan/ 里已有的方案包。
• ~auto：全授权模式，连续完成分析 → 设计 → 开发。
• ~init：初始化/刷新知识库（从代码库提取并生成结构化知识）。

注意: 默认情况下,claude code和codex是没有上述命令的,所以你需要在终端里输入一个空格之后加上~plan等命令,就会识别到了

实践建议：

• 先用 ~plan 把方案审一遍，再决定是否 ~exec 或继续补充需求。
• 当任务涉及生产环境、数据破坏性操作、支付、密钥等关键词时，宁可更保守，避免一上来就 ~auto。¹²

许可证与署名：可商用，但要“正确署名”

HelloAGENTS 在 README 里说明采用“双许可证”策略：代码 Apache-2.0；文档/图表 CC BY 4.0，并给出了统一署名建议。复用其文档内容或图表时，请按 CC BY 4.0 的要求署名并标注修改情况。¹

参考

1. HelloAGENTS README（简体中文）：https://github.com/hellowind777/helloagents/blob/main/README_CN.md¹
2. HelloAGENTS Codex 规则入口（AGENTS.md，中文）：https://github.com/hellowind777/helloagents/blob/main/Codex/Skills/CN/AGENTS.md²
3. HelloAGENTS Claude 规则入口（CLAUDE.md，中文）：https://github.com/hellowind777/helloagents/blob/main/Claude/Skills/CN/CLAUDE.md³