mit einem Klick
mit einem Klick
规范化 Git 提交 + 知识库同步(~commit 命令)
初始化项目工作流并同步知识库
已进入显式 UI 工作流、宿主全局模式下的 UI 任务、已初始化项目的视觉变更、设计系统改造或需要视觉验收时使用;在通用 UI 基线之上补充项目契约执行、设计系统映射与视觉验证。
按任务类型适用 — 建立质量驱动工作流,通过技能标准、流程纪律和检查清单保障交付质量
长任务入口 — 在 Codex 中优先走 `/goal -> ~auto -> ~qa`,把长程续跑交给 `/goal`,把执行推进交给 `~auto`,把最终质量闭环交给 `~qa`(~loop 命令)
结构化规划工作流 — 需求澄清、方案确认、任务分解与方案包生成(~plan 命令)
| name | ~help |
| description | 显示 HelloAGENTS 可用命令和当前设置(~help 命令) |
| policy | {"allow_implicit_invocation":false} |
Trigger: ~help
| 命令 | 说明 |
|---|---|
| ~idea | 轻量点子探索与方向比较 |
| ~auto | 自动执行:自动选主路径并持续推进到实现 / 质量闭环 / 收尾,除非命中真实阻塞 |
| ~plan | 结构化规划:需求澄清 + 方案确认 + 方案包 |
| ~build | 执行实现:按需求或方案包完成实现与局部验证 |
| ~prd | 完整 PRD:头脑风暴式逐维度挖掘,生成现代产品需求文档 |
| ~loop | 长任务入口:在 Codex 中优先走 /goal -> ~auto -> ~qa |
| ~init | 初始化项目工作流并同步知识库 |
| ~test | 为指定模块或最近变更编写完整测试 |
| ~qa | 统一质量总入口:审查 + 运行验证命令 + 修复循环 + 收尾前证据 |
| ~commit | 规范化提交 + 知识库同步 |
| ~clean | 清理临时文件和归档方案包 |
| ~help | 显示此帮助 |
兼容别名:
~do → 等同 ~build~design → 等同 ~plan~review → 等同 ~qa以下技能仅在宿主全局模式或已初始化项目时自动激活(例如当前项目级规则文件已包含 <!-- 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 gate(显式 ~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 |