English | 한국어 | 中文 | 日本語 | Español | Tiếng Việt | Português

thalix-auto

Codex 用户： 查看 oh-my-codex — 为 OpenAI Codex CLI 提供同样的编排体验。

Claude Code 的多智能体编排系统。零学习曲线。

无需学习 Claude Code，直接使用 TAP。

快速开始 • 文档 • CLI 参考 • 工作流 • 迁移指南 • Discord

---

快速开始

第一步：安装

/plugin marketplace add https://github.com/manateeit/thalix-auto
/plugin install thalix-auto

第二步：配置

/tap-setup

如果你通过 tap --plugin-dir <path> 或 claude --plugin-dir <path> 运行 TAP，请在 tap setup 中添加 --plugin-dir-mode（或提前导出 TAP_PLUGIN_ROOT），以避免复制插件在运行时已经提供的技能/代理。有关完整的决策矩阵和所有可用标志，请参阅 REFERENCE.md 中的 Plugin directory flags 部分。

第三步：开始构建

autopilot: build a REST API for managing tasks

就这么简单。其余都是自动的。

不确定从哪里开始？

如果你对需求不明确、有模糊的想法，或者想要精细控制设计：

/deep-interview "I want to build a task management app"

深度访谈使用苏格拉底式提问在编写任何代码之前帮你理清思路。它揭示隐藏假设并通过加权维度衡量清晰度，确保你在执行前明确知道要构建什么。

Team 模式（推荐）

从 v4.1.7 开始，Team 是 TAP 的标准编排方式。swarm 和 ultrapilot 等旧版入口仍受支持，但现在在底层路由到 Team。

/team 3:executor "fix all TypeScript errors"

Team 按阶段化流水线运行：

team-plan → team-prd → team-exec → team-verify → team-fix (loop)

在 ~/.claude/settings.json 中启用 Claude Code 原生团队：

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

如果团队被禁用，TAP 会发出警告并在可能的情况下回退到非 Team 执行模式。

tmux CLI 工作者 — Codex & Gemini (v4.4.0+)

v4.4.0 移除了 Codex/Gemini MCP 服务器（x、g 提供商）。请改用 /tap-teams 在 tmux 分屏中启动真实的 CLI 进程：

/tap-teams 2:codex   "review auth module for security issues"
/tap-teams 2:gemini  "redesign UI components for accessibility"
/tap-teams 1:claude  "implement the payment flow"

如需在一个命令中混合使用 Codex + Gemini，请使用 /ccg 技能：

/ccg Review this PR — architecture (Codex) and UI components (Gemini)

技能	工作者	最适合
/tap-teams N:codex	N 个 Codex CLI 窗格	代码审查、安全分析、架构
/tap-teams N:gemini	N 个 Gemini CLI 窗格	UI/UX 设计、文档、大上下文任务
/tap-teams N:claude	N 个 Claude CLI 窗格	通过 tmux 中的 Claude CLI 处理通用任务
/ccg	1 个 Codex + 1 个 Gemini	并行三模型编排

工作者按需生成，任务完成后自动退出 — 无空闲资源浪费。需要安装 codex / gemini CLI 并有活跃的 tmux 会话。

注意：包命名 — 项目品牌名为 thalix-auto（仓库、插件、命令），但 npm 包以 tap-skill 发布。通过 npm/bun 安装 CLI 工具时，请使用 npm install -g tap-skill。

更新

# 1. 更新 marketplace 克隆
/plugin marketplace update tap

# 2. 重新运行设置以刷新配置
/tap-setup

注意： 如果 marketplace 自动更新未启用，您需要在运行设置之前手动执行 /plugin marketplace update tap 来同步最新版本。

如果更新后遇到问题，清除旧的插件缓存：

/tap-doctor

你的 Claude 已被注入超能力。

---

为什么选择 thalix-auto？

• 无需配置 - 开箱即用，智能默认设置
• Team 优先编排 - Team 是标准的多智能体界面（swarm/ultrapilot 是兼容性外观）
• 自然语言交互 - 无需记忆命令，只需描述你的需求
• 自动并行化 - 复杂任务自动分配给专业智能体
• 持久执行 - 不会半途而废，直到任务验证完成
• 成本优化 - 智能模型路由节省 30-50% 的 token
• 从经验中学习 - 自动提取并复用问题解决模式
• 实时可见性 - HUD 状态栏显示底层运行状态

---

功能特性

执行模式

针对不同场景的多种策略 - 从全自动构建到 token 高效重构。了解更多 →

模式	特点	适用场景
Team（推荐）	阶段化流水线	在共享任务列表上协作的 Claude 智能体
tap-teams	tmux CLI 工作者	Codex/Gemini CLI 任务；按需生成，完成后退出
ccg	三模型并行	Codex（分析）+ Gemini（设计），Claude 合成
Autopilot	自主执行	最小化繁琐配置的端到端功能开发
Ultrawork	最大并行	不需要 Team 的并行修复/重构
Ralph	持久模式	必须完整完成的任务
Pipeline	顺序处理	需要严格顺序的多阶段转换
Swarm / Ultrapilot（旧版）	路由到 Team	现有工作流和旧文档

智能编排

• 32 个专业智能体 涵盖架构、研究、设计、测试、数据科学
• 智能模型路由 - 简单任务用 Haiku，复杂推理用 Opus
• 自动委派 - 每次都选择最合适的智能体

开发者体验

• 魔法关键词 - ralph、ulw、plan 提供显式控制

• HUD 状态栏 - 状态栏实时显示编排指标

  • 如果你直接使用 claude --plugin-dir <path> 启动 Claude Code（绕过 tap shim），请在 shell 中导出 TAP_PLUGIN_ROOT=<path>，以便 HUD bundle 解析到与插件加载器相同的 checkout。详情见 REFERENCE.md 中的 Plugin directory flags 部分。

• 技能学习 - 从会话中提取可复用模式

• 分析与成本追踪 - 了解所有会话的 token 使用情况

贡献

想为 TAP 做贡献？请参阅 CONTRIBUTING.md 了解完整的开发者指南，包括如何 fork、设置本地 checkout、将其链接为活跃插件、运行测试和提交 PR。

自定义技能

一次学习，永久复用。TAP 将调试过程中获得的实战知识提取为可移植的技能文件，并在相关场景中自动注入。

	项目作用域	用户作用域
路径	.tap/skills/	~/.tap/skills/
共享范围	团队（受版本控制）	所有项目通用
优先级	高（覆盖用户作用域）	低（回退）

# .tap/skills/fix-proxy-crash.md
---
name: Fix Proxy Crash
description: aiohttp proxy crashes on ClientDisconnectedError
triggers: ["proxy", "aiohttp", "disconnected"]
source: extracted
---
在 server.py:42 的处理程序外包裹 try/except ClientDisconnectedError...

技能管理： /skill list | add | remove | edit | search 自动学习： /skillify 以严格的质量标准提取可复用模式 自动注入： 匹配的技能自动加载到上下文中 — 无需手动调用

完整功能列表 →

---

魔法关键词

为高级用户提供的可选快捷方式。不用它们，自然语言也能很好地工作。

关键词	效果	示例
team	标准 Team 编排	/team 3:executor "fix all TypeScript errors"
tap-teams	tmux CLI 工作者 (codex/gemini/claude)	/tap-teams 2:codex "security review"
ccg	三模型 Codex+Gemini 编排	/ccg review this PR
autopilot	全自动执行	autopilot: build a todo app
ralph	持久模式	ralph: refactor auth
ulw	最大并行化	ulw fix all errors
plan	规划访谈	plan the API
ralplan	迭代规划共识	ralplan this feature
deep-interview	苏格拉底式需求澄清	deep-interview "vague idea"
swarm	已弃用 — 请使用 team	swarm 5 agents: fix lint errors
ultrapilot	已弃用 — 请使用 team	ultrapilot: build a fullstack app

注意：

• ralph 包含 ultrawork： 激活 ralph 模式时，会自动包含 ultrawork 的并行执行。无需组合关键词。
• swarm N agents 语法仍可被识别用于提取智能体数量，但运行时在 v4.1.7+ 中由 Team 支持。

---

实用工具

速率限制等待

当速率限制重置时自动恢复 Claude Code 会话。

tap wait          # 检查状态，获取指导
tap wait --start  # 启用自动恢复守护进程
tap wait --stop   # 禁用守护进程

需要： tmux（用于会话检测）

通知标签配置 (Telegram/Discord/Slack)

你可以配置 stop 回调发送会话摘要时要 @ 谁。

# 设置/替换标签列表
tap config-stop-callback telegram --enable --token <bot_token> --chat <chat_id> --tag-list "@alice,bob"
tap config-stop-callback discord --enable --webhook <url> --tag-list "@here,123456789012345678,role:987654321098765432"
tap config-stop-callback slack --enable --webhook <url> --tag-list "<!here>,<@U1234567890>"

# 增量更新
tap config-stop-callback telegram --add-tag charlie
tap config-stop-callback discord --remove-tag @here
tap config-stop-callback discord --clear-tags

标签规则：

• Telegram：alice 会规范化为 @alice
• Discord：支持 @here、@everyone、纯数字用户 ID、role:<id>
• Slack：支持 <@MEMBER_ID>、<!channel>、<!here>、<!everyone>、<!subteam^GROUP_ID>
• file 回调会忽略标签选项

OpenClaw 集成

将 Claude Code 会话事件转发到 OpenClaw 网关，通过您的 OpenClaw 代理实现自动化响应和工作流程。

快速设置（推荐）：

/tap:configure-notifications
# → 提示时输入 "openclaw" → 选择 "OpenClaw Gateway"

手动设置： 创建 ~/.claude/omc_config.openclaw.json：

{
  "enabled": true,
  "gateways": {
    "my-gateway": {
      "url": "https://your-gateway.example.com/wake",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" },
      "method": "POST",
      "timeout": 10000
    }
  },
  "hooks": {
    "session-start": { "gateway": "my-gateway", "instruction": "Session started for {{projectName}}", "enabled": true },
    "stop":          { "gateway": "my-gateway", "instruction": "Session stopping for {{projectName}}", "enabled": true }
  }
}

环境变量：

变量	说明
TAP_OPENCLAW=1	启用 OpenClaw
TAP_OPENCLAW_DEBUG=1	启用调试日志
TAP_OPENCLAW_CONFIG=/path/to/config.json	覆盖配置文件路径

支持的钩子事件（bridge.ts 中 6 个活跃）：

事件	触发时机	主要模板变量
session-start	会话开始时	{{sessionId}}, {{projectName}}, {{projectPath}}
stop	Claude 响应完成时	{{sessionId}}, {{projectName}}
keyword-detector	每次提交提示词时	{{prompt}}, {{sessionId}}
ask-user-question	Claude 请求用户输入时	{{question}}, {{sessionId}}
pre-tool-use	工具调用前（高频）	{{toolName}}, {{sessionId}}
post-tool-use	工具调用后（高频）	{{toolName}}, {{sessionId}}

回复通道环境变量：

变量	说明
OPENCLAW_REPLY_CHANNEL	回复通道（例如 discord）
OPENCLAW_REPLY_TARGET	频道 ID
OPENCLAW_REPLY_THREAD	线程 ID

参见 scripts/openclaw-gateway-demo.mjs，这是一个通过 ClawdBot 将 OpenClaw 有效载荷转发到 Discord 的参考网关。

---

文档

• 完整参考 - 完整功能文档
• CLI 参考 - 所有 tap 命令、标志和工具
• 通知指南 - Discord、Telegram、Slack 和 webhook 设置
• 推荐工作流 - 常见任务的经过实战检验的技能链
• 发布说明 - 每个版本的新内容
• 网站 - 交互式指南和示例
• 迁移指南 - 从 v2.x 升级
• 架构 - 底层工作原理
• 性能监控 - 智能体追踪、调试和优化

---

环境要求

• Claude Code CLI
• Claude Max/Pro 订阅 或 Anthropic API 密钥

可选：多 AI 编排

TAP 可以选择性地调用外部 AI 提供商进行交叉验证和设计一致性检查。非必需 — 没有它们 TAP 也能完整运行。

提供商	安装	功能
Gemini CLI	npm install -g @google/gemini-cli	设计审查、UI 一致性（1M token 上下文）
Codex CLI	npm install -g @openai/codex	架构验证、代码审查交叉检查

费用： 3 个 Pro 计划（Claude + Gemini + ChatGPT）每月约 $60 即可覆盖所有功能。

---

开源协议

MIT

---

Star 历史

💖 支持本项目

如果 Thalix-Auto 帮助了你的工作流，请考虑赞助：

为什么赞助？

• 保持项目活跃开发
• 赞助者获得优先支持
• 影响路线图和功能
• 帮助维护自由开源

其他帮助方式

• ⭐ 为仓库加星
• 🐛 报告问题
• 💡 提出功能建议
• 📝 贡献代码