helloagents

HelloAGENTS 技能系统规范

审查代码变更、检查 PR、review 代码质量，或用户要求看看代码、检查代码时使用。

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

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

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

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

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

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

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

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

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

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

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

声称工作完成前、提交代码前、创建 PR 前、报告任务完成前使用。确保验证命令已运行并检查输出后才能声称成功。

撰写文档、README、技术方案、分析报告、用户指南，或任何需要专业文本产出的任务时使用。

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

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

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

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

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

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

轻量点子探索与方向发散（~idea 命令）

初始化项目知识库与项目级规则文件（~init 命令）

自主迭代优化循环 — 设定目标和指标，AI 自主循环修改-验证-保留/回滚，直到达成目标或达到迭代上限（~loop 命令）

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

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

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

验证总入口 — 审查、lint、typecheck、test、build 与修复循环（~verify 命令）

初始化或同步项目知识库（仅 `.helloagents/`）

8 hooks across 7 events