By name: help
description: 显示 HelloAGENTS 可用命令和当前设置（help 命令）
policy:
allow_implicit_invocation: false
Trigger: ~help
显示内容
可用命令
| 命令 | 说明 |
|---|---|
| ~idea | 轻量点子探索与方向比较 |
| ~office | 价值与范围评估：先判断该不该做、该做多大、先做哪一小块 |
| ~auto | 自动执行：自动选主路径并持续推进到实现 / 质量闭环 / 收尾，除非命中真实阻塞 |
| ~plan | 结构化规划：需求澄清 + 方案确认 + 方案包 |
| ~build | 执行实现：按需求或方案包完成实现与局部验证 |
| ~prd | 完整 PRD：头脑风暴式逐维度挖掘，生成现代产品需求文档 |
| ~loop | 长任务入口：在 Codex 中优先走 /goal -> ~auto -> ~qa |
| ~init | 初始化项目工作流并同步知识库 |
| ~test | 为指定模块或最近变更编写完整测试 |
| ~qa | 统一质量总入口：审查 + 运行验证命令 + 修复循环 + 收尾前证据 |
| ~commit | 规范化提交 + 知识库同步 |
| ~clean | 清理临时文件和归档方案包 |
| ~help | 显示此帮助 |
兼容别名：
~do→ 等同~build~design→ 等同~plan~review→ 等同~qa
核心规则默认生效：HelloAGENTS 会通过 bootstrap.md / bootstrap-lite.md 在运行时持续执行方案纠偏与语言纪律；这不是新增命令，也不是新增技能计数。
自动激活技能
以下技能仅在宿主全局模式或已初始化项目时自动激活（例如当前项目级规则文件已包含 <!-- HELLOAGENTS_PROFILE: full -->，通常由 ~init 建立）。
纯标准模式、且项目未初始化时不会自动触发这些技能；但涉及 UI 的任务仍受 UI 质量基线约束。
编码时：hello-ui, hello-api, hello-data, hello-security, hello-errors, hello-perf, hello-arch, hello-test 特定场景：hello-debug, hello-subagent, hello-write 完成时：qa-review, hello-reflect
当前设置
优先使用当前会话上下文中已注入的“当前用户设置”、该配置文件原始 JSON 或此前读取结果摘要显示；若会话上下文不存在该信息，或缺少下表任一配置项，才读取一次 ~/.helloagents/helloagents.json，并在后续轮次复用。对 Codex 来说，首次对话前若当前上下文仍缺少这些配置项，或刚经历压缩/恢复后的首次对话，同样先读取一次再继续。
如果当前 CLI 存在工作区限制导致家目录不可读，则明确说明“无法直接读取配置文件，以下按已注入设置或默认值展示”，不要改用无关工具或伪造已读取结果。
| 配置项 | 默认值 | 作用 | 适用 CLI |
|---|---|---|---|
| output_language | "" | 空=跟随用户语言/填写则指定（如 zh-CN、en） | Claude Code + Gemini CLI + Codex CLI |
| output_format | true | true=主代理最终回复必须使用 HelloAGENTS 格式，流式/中间输出及子代理输出保持自然；false=自然输出 | Claude Code + Gemini CLI + Codex CLI |
| notify_level | 0 | 0=关闭/1=桌面通知/2=声音/3=两者 | Claude Code + Gemini CLI + Codex CLI |
| ralph_loop_enabled | true | 收尾 QA 门禁（显式 ~qa / ~loop 或收尾要求时触发审查、lint/test/build） | Claude Code + Gemini CLI + Codex CLI |
| guard_enabled | true | 阻断危险命令与写入后的安全扫描 | Claude Code + Gemini CLI + Codex CLI |
| kb_create_mode | 1 | 0=关闭/1=知识库已存在时自动同步/2=编码任务在知识库已存在或当前项目已初始化时自动创建或同步 | Claude Code + Gemini CLI + Codex CLI |
| project_store_mode | "local" | "local"=知识库/方案包保留在项目本地 .helloagents/；"repo-shared"=本地 .helloagents/ 仅保留项目本地状态/运行态，知识库与方案包改写到 ~/.helloagents/projects/<repo-key>/ |
Claude Code + Gemini CLI + Codex CLI |
| auto_commit_enabled | true | true=验证完成且有变更时自动执行本地提交；false=跳过自动提交，仍可手动用 ~commit |
Claude Code + Gemini CLI + Codex CLI |
| commit_attribution | "" | 空=不添加/填写内容则添加到 commit message | Claude Code + Gemini CLI + Codex CLI |
| install_mode | "standby" | 当前默认安装模式 | Claude Code + Gemini CLI + Codex CLI |
| host_install_modes | {} | 单 CLI 模式记录，优先于 install_mode | Claude Code + Gemini CLI + Codex CLI |