Community写作与编辑github.com

amplifthq/opentag

开源的 @agent 提及工具,适用于 Slack 和 GitHub。OpenTag 将标记请求路由到 Codex、Claude Code,并在线程中返回结果。

opentag 是什么?

OpenTag 是一个开源的开发工具,用于将 Slack 和 GitHub 中的 `@opentag` 提及转换为可审计的 AI 代理运行流程。它能够监听工作区事件(如 GitHub Issue/PR 评论或 Slack 消息中的提及),然后将请求路由到代码执行器(如 Codex 或 Claude Code),最终将结果回调到原始线程中。用户需要先通过 `local-echo` 进行本地烟雾测试,再根据实际需求配置 GitHub 或 Slack 适配器以及真实的代码执行器。其核心工作流程包括:确定目标循环、收集所需配置信息、写入最小配置文件、注册绑定关系、验证一次完整运行,最后报告结果。OpenTag 支持在本地开发环境、GitHub 和 Slack 等平台上运行,并提供了详细的故障排除文档。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add amplifthq/opentag

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

opentag 是做什么的?

OpenTag 将工作区中的提及(例如 @opentag 修复此问题)转换为可审计的代理运行流程。使用此技能可帮助用户配置从工作区事件到调度器、本地运行器、执行器和回调的完整路径。

路由请求

只读取用户路径所需的参考文档:

  • 本地烟雾测试或首次设置:references/local-echo.md
  • GitHub Issue 或 PR 提及:references/github-setup.md
  • Slack 应用提及:references/slack-setup.md
  • 真实代码执行或 PR 创建:references/codex-runner.md
  • 运行失败、缺少回调、拒绝运行或认证错误:references/troubleshooting.md

如果用户询问多个路径,请先配置并验证最小的可用循环,然后再添加下一个适配器。

工作规则

  • 除非用户已拥有正在运行的调度器和运行器,否则优先选择本地回显循环,而非真实代理或实时回调。
  • 保持配置明确:不要自行编造仓库所有者、仓库名称、检出路径、令牌、Slack ID 或调度器 URL。
  • 不要添加后备行为。缺少必需值时,应停止配置,并清晰列出缺少的内容。
  • 将 opentagd 视为本地执行权威。它只能声明其配置中列出的仓库。
  • 使用 echo 进行非破坏性烟雾测试,仅当用户需要真实代码执行时才使用 codex。
  • 分层验证:调度器健康检查、运行器注册、仓库或 Slack 绑定、运行创建、守护进程执行、回调投递。

配置工作流

  1. 确定目标循环。 完成标志:已命名一个循环:local-echo、github、slack 或 codex-runner。

  2. 收集所需信息。 完成标志:答案包含所有缺失的值,或者所有必需的值都已可用。

  3. 写入或更新最小配置文件。 完成标志:配置仅包含所选循环需要的字段,并使用用户的真实仓库/频道/检出路径。

  4. 在创建运行之前注册绑定关系。 完成标志:运行器已注册,仓库已绑定,并且当 Slack 在范围内时 Slack 频道也已绑定。

  5. 验证一次真实的运行。 完成标志:该运行可通过调度器查看,拥有审计事件,并且最终状态为已完成,或者因特定错误而失败。

  6. 报告结果。 完成标志:告知用户配置了什么、哪条命令验证了该配置、以及还有哪些未配置。

命令默认值

除非项目已更改,否则使用以下默认值:

  • 调度器应用:pnpm --filter @opentag/dispatcher-app dev
  • 本地守护进程应用:pnpm --filter @opentag/opentagd dev -- <command>
  • Slack 事件应用:pnpm --filter @opentag/slack-events dev
  • 调度器 URL:http://localhost:3030
  • Slack 事件 URL 路径:/slack/events
  • 示例运行负载:examples/github-to-echo/run.example.json

在此仓库中运行包命令之前,请使用 Node 22.x 并根据需要安装依赖项。

相关技能