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 绑定、运行创建、守护进程执行、回调投递。
配置工作流
-
确定目标循环。 完成标志:已命名一个循环:
local-echo、github、slack或codex-runner。 -
收集所需信息。 完成标志:答案包含所有缺失的值,或者所有必需的值都已可用。
-
写入或更新最小配置文件。 完成标志:配置仅包含所选循环需要的字段,并使用用户的真实仓库/频道/检出路径。
-
在创建运行之前注册绑定关系。 完成标志:运行器已注册,仓库已绑定,并且当 Slack 在范围内时 Slack 频道也已绑定。
-
验证一次真实的运行。 完成标志:该运行可通过调度器查看,拥有审计事件,并且最终状态为已完成,或者因特定错误而失败。
-
报告结果。 完成标志:告知用户配置了什么、哪条命令验证了该配置、以及还有哪些未配置。
命令默认值
除非项目已更改,否则使用以下默认值:
- 调度器应用:
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 并根据需要安装依赖项。