hexabot-action-creator

Name: hexabot-action-creator
Author: hexabot-ai

github.com/hexabot-ai开发059 次安装21 周前更新

关于 hexabot-action-creator

hexabot-action-creator 是用于设计、实现或审查 Hexabot v3 action 的技能。它要求先检查当前项目与包 API，避免臆测契约或目录结构。

复制下面的命令，在终端中运行。

$npx skills add https://github.com/hexabot-ai/action-creator --skill hexabot-action-creator

安装后在 Claude Code 中输入/hexabot-action-creator确认已加载。

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/

openai.yaml

examples/

create-crm-ticket.action.example.ts

references/

action-authoring-guide.md

action-contract-guide.md

output-templates.md

settings-and-secrets-guide.md

testing-and-review-checklist.md

在处理 Hexabot v3 action 时使用此技能。Hexabot action API 由项目定义，并且可能会演变，因此在生成最终代码前，请检查用户当前使用的 Hexabot 仓库、自定义 action 包或已安装的包类型。

在编写最终 action 代码或审查结果前，请检查相关的当前项目文件。如果工作区中只有此打包技能，请使用随附的参考资料和示例，然后说明仍需在 Hexabot 项目或 action 包中进行运行时验证。

用户在 Hexabot 单体仓库中工作时，以下是通常需要查看的位置：

API action 接口：packages/api/src/actions/**。
内置 API action 示例：packages/api/src/extensions/actions/**。
运行时绑定系统：packages/api/src/bindings/**，以及 packages/api/src/extensions/actions/**/*.binding.ts 下的 action 绑定文件。
工作流运行时上下文和服务：packages/api/src/workflow/contexts/**。
Agentic action 基类：packages/agentic/src/action/**、packages/agentic/src/dsl.types.ts 和 packages/agentic/README.md。
扩展发现机制：packages/api/src/actions/actions.module.ts、packages/api/src/bindings/bindings.module.ts 和 packages/api/README.md。

用户在独立的 hexabot-action-* 包或应用仓库中工作时，请检查该包的 package.json、源代码树、生成的模板、TypeScript 路径别名和依赖导出，不要假设存在单体仓库中的 packages/* 路径。

不要臆造当前项目或已安装的 Hexabot 包中不存在的装饰器、架构字段、绑定类型、注册钩子、包布局、导入路径或配置惯例。

确定所请求的 action 功能、附带效应、工作流类型和目标位置：Hexabot 单体仓库 API 源码、自定义应用 action、名为 hexabot-action-* 的 npm 包，或独立的 @hexabot-ai/agentic 示例。
如果目标项目可用，请检查相同类型的相邻示例：Web/API、AI/LLM、记忆、订阅者、消息传递或支持绑定的 action。如果只有此技能包可用，请将随附示例作为说明性参考，并指出未经验证的运行时假设。
选择实现模式：
- 对于没有自定义构造函数依赖、由 Nest 自动发现的简单 action，使用 API createAction。
- 对于需要通过构造函数注入服务、继承或具有更丰富行为的 action，扩展 API BaseAction。
- 仅在独立的 @hexabot-ai/agentic 运行时示例中使用 defineAction，不要将其用于 Nest API 扩展 action。
编写代码前先设计契约：action 名称、工作流类型、输入架构、输出架构、设置架构、支持的绑定、幂等性、失败行为、日志记录和测试。
使用 Zod 架构、当前上下文服务、安全地处理凭据，并明确输出，使工作流能通过 $output.<task> 引用这些输出。
添加有针对性的测试或审查说明，涵盖解析、设置、输出格式、错误路径、幂等性和绑定兼容性。

实现或搭建 action 代码前，请阅读 references/action-authoring-guide.md。
设计输入、输出、设置架构或支持的绑定时，请阅读 references/action-contract-guide.md。
处理凭据、设置、环境变量、LLM 模型绑定和外部 API 调用时，请阅读 references/settings-and-secrets-guide.md。
审查 action 或规划验证时，请阅读 references/testing-and-review-checklist.md。
用户需要经过润色的设计、脚手架、审查或文档回复时，请阅读 references/output-templates.md。
examples/create-crm-ticket.action.example.ts 提供了一个说明性的 API createAction 模式示例。

支持 Markdown