skills/commands/help/SKILL.md
显示 HelloAGENTS 可用命令和当前设置(~help 命令)
npx skillsauth add hellowind777/helloagents ~helpInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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 |
tools
价值与范围评估命令 — 先判断事情该不该做、该做多大、先做哪一小块(~office 命令)
testing
统一质量命令 — 审查、命令验证、阻断修复、回归验证与收尾前质量闭环(~qa 命令)
data-ai
按任务类型适用 — 建立质量驱动工作流,通过技能标准、流程纪律和检查清单保障交付质量
documentation
撰写文档、README、技术方案、分析报告、用户指南、邮件回复、问答说明、措辞改写,或任何需要专业文本产出的任务时使用。