用途:该技能面向 Hexabot v3 的动作开发工作,支持创建、搭建脚手架、实现、审查、撰写文档和改进动作,包括自定义工作流动作、外部 API 集成以及 LLM 驱动动作。
主要能力:先识别请求的动作能力、副作用、工作流类型与目标位置(Hexabot 单体仓库 API 源码、自定义应用动作、npm 包 hexabot-action-*,或独立 @hexabot-ai/agentic 示例)。在编写最终代码或审查结论前,检查当前项目文件;若工作区仅有此打包技能,则使用内置参考与示例,并说明运行时验证仍需实际 Hexabot 项目或动作包。
实现模式:简单、由 Nest 发现且无自定义构造依赖的动作使用 API createAction;需要构造注入服务、继承或更复杂行为时继承 API BaseAction;defineAction 仅用于独立 @hexabot-ai/agentic 运行时示例,不用于 Nest API 扩展动作。设计顺序为先定契约:动作名称、工作流类型、输入输出与设置 schema、支持的绑定、幂等性、失败行为、日志和测试。使用 Zod schema、当前上下文服务、安全的凭据处理,并通过 $output.<task> 提供显式输出。
内置资源:实现或脚手架前阅读 references/action-authoring-guide.md;设计 schema 或绑定前阅读 references/action-contract-guide.md;处理凭据、设置、环境变量、LLM 模型绑定和外部 API 调用时阅读 references/settings-and-secrets-guide.md;审查或规划验证时阅读 references/testing-and-review-checklist.md;需要完整设计、脚手架、审查或文档时阅读 references/output-templates.md;参考 examples/create-crm-ticket.action.example.ts。
输出默认:实现任务在目标可用且用户要求实现时直接改代码;仅设计任务给出决策完整的动作契约并标注缺失事实与运行时假设;审查按严重程度列出结论并引用文件或契约字段;仅工作流请求使用 Hexabot workflow 技能,除非需要动作代码或契约。
限制:不要臆造当前项目或已安装 Hexabot 包中不存在的装饰器、schema 字段、绑定类型、注册钩子、包结构、导入路径或配置约定。除非用户明确要求本地化,否则不要新增或更新额外语言文件。API 可能随项目演进,最终代码需以实际仓库类型为准。