feishu-create-hermes-bot

一个用于创建 Hermes 飞书机器人的 Codex skill。

This is a Codex skill for creating Feishu self-built bot apps for Hermes.

作用

这个 skill 帮你完成 Hermes 新业务机器人创建链路中的第一段：

• 从 Hermes bots/*.yaml 读取机器人名称和密钥环境变量名。
• 在飞书开放平台创建企业自建应用。
• 启用飞书应用的机器人能力。
• 获取 App ID 和 App Secret。
• 写入本地 keys/hermes.secrets.env。
• 运行 npm run validate 验证本地配置。

它不会处理 API 权限、事件订阅、应用发布、租户审批、CNB 同步或运行时启动。这些属于后续发布和运维步骤。

Purpose

This skill covers the first part of creating a new Hermes business bot:

• Read the bot name and credential environment variable names from Hermes bots/*.yaml.
• Create a Feishu enterprise self-built app.
• Enable the Feishu bot capability.
• Capture the App ID and App Secret.
• Store the credentials in local keys/hermes.secrets.env.
• Run npm run validate to verify local Hermes configuration.

It does not configure API permissions, event subscriptions, app publishing, tenant approval, CNB sync, or runtime startup. Those are separate release and operations steps.

中文使用方法

1. 把本仓库中的 SKILL.md 放到你的 Codex skills 目录，或保持本目录作为一个独立 skill 目录。
2. 打开 Hermes 仓库，通常是：

cd /Users/jiang/Downloads/01hermes

3. 确认目标机器人已经存在于 bots/*.yaml。
4. 让 Codex 使用 feishu-create-hermes-bot。
5. 按 skill 指引在飞书开放平台创建企业自建应用并启用机器人能力。
6. 将 App ID、App Secret 和 profile 名称写入 keys/hermes.secrets.env。
7. 运行：

npm run validate

8. 验证通过后，再进入权限、事件订阅、发布、租户审批和运行时启动流程。

English Usage

1. Put SKILL.md into your Codex skills directory, or keep this folder as a standalone skill directory.
2. Open your Hermes repository, usually:

cd /Users/jiang/Downloads/01hermes

3. Confirm that the target bot already exists in bots/*.yaml.
4. Ask Codex to use feishu-create-hermes-bot.
5. Follow the skill instructions to create a Feishu enterprise self-built app and enable the bot capability.
6. Write the App ID, App Secret, and profile name to keys/hermes.secrets.env.
7. Run:

npm run validate

8. After validation passes, continue with API permissions, event subscription, publishing, tenant approval, and runtime startup in your separate release workflow.

安全边界 / Security Boundary

• 不要提交 App Secret。

• 不要在聊天、日志、README、issue、PR 或 commit message 中展示 App Secret。

• keys/hermes.secrets.env 应该保持在 Hermes 主仓库的 .gitignore 中。

• 创建完成后不要直接把 bot 标记为 active，除非权限、事件、发布和租户审批也已经完成。

• Do not commit App Secrets.

• Do not expose App Secrets in chat, logs, README files, issues, pull requests, or commit messages.

• keys/hermes.secrets.env should stay ignored in the Hermes repository.

• Do not mark the bot as active after app creation alone; permissions, events, publishing, and tenant approval must be completed separately.

License

MIT