helloagents

显示 HelloAGENTS 可用命令和当前设置（~help 命令）

交互式需求澄清 — 一问一答厘清目标、方向、范围与约束，纯对话不创建文件（~ask 命令）

结构化规划工作流 — 需求澄清、方案确认、任务分解与方案包生成（~plan 命令）

完整 PRD 生成 — 头脑风暴式交互，逐维度挖掘，生成现代产品需求文档（~prd 命令）

自动执行命令 — 自动选择并依次执行 ~ask / ~plan / ~build / ~qa / ~prd，默认持续推进直到交付完成（~auto 命令）

执行实现工作流 — 基于当前需求或现有方案包完成实现、验证与状态同步（~build 命令）

按任务类型适用 — 建立质量驱动工作流，通过技能标准、流程纪律和检查清单保障交付质量

统一质量审查、命令验证、阻断修复与交付前质量闭环。

撰写文档、README、技术方案、分析报告、用户指南、邮件回复、问答说明、措辞改写，或任何需要专业文本产出的任务时使用。

规范化 Git 提交 + 知识库同步（~commit 命令）

初始化项目工作流并同步知识库

长任务入口 — 在 Codex 中优先走 `/goal -> ~auto -> ~qa`，把长程续跑交给 `/goal`，把执行推进交给 `~auto`，把最终质量闭环交给 `~qa`（~loop 命令）

统一质量命令 — 审查、命令验证、阻断修复、回归验证与收尾前质量闭环（~qa 命令）

重构代码、调整模块结构、管理依赖、拆分文件、提取组件、设计系统架构或做代码组织决策时使用。

已进入显式 UI 工作流、宿主全局模式下的 UI 任务、已初始化项目的视觉变更、设计系统改造或需要视觉验收时使用；在通用 UI 基线之上补充项目契约执行、设计系统映射与视觉验证。

使用子代理执行任务、并行开发、分派工作时使用。确保子代理有清晰的上下文和验证标准。

为指定模块或最近变更编写完整测试（~test 命令）

实现错误处理、try-catch、日志记录、监控、重试逻辑、降级机制，或处理错误响应和异常管理时使用。

HelloAGENTS 技能系统规范

清理临时文件、缓存和归档已完成方案包（~clean 命令）

调试错误、修复 bug、排查失败测试、处理异常行为，或代码行为与预期不符时使用。

编写测试、创建测试文件、实现测试覆盖、使用 Jest/Vitest/Mocha/pytest 等测试框架，或实践 TDD、修复失败测试时使用。

构建、修改或审查 REST API、GraphQL 端点、webhook、中间件、请求/响应处理、API 版本管理、限流或分页时使用。

操作数据库、编写迁移、设计 schema、管理事务、创建索引、使用 Prisma/Sequelize/TypeORM/Mongoose 等 ORM，或执行 SQL/NoSQL 操作时使用。

优化性能、处理数据库查询、实现缓存、懒加载、分页、打包优化，或代码涉及大数据集循环、并发操作、内存管理时使用。

任务完成后使用 — 生成会话反思，提取经验教训追加到相关模块文档，供未来会话参考。

涉及认证、密码、token、JWT、OAuth、session、cookie、加密、密钥、API key、权限、角色、用户输入验证、文件上传等安全敏感操作时使用。