works-plugin — TourMind Works 插件市场

TourMind 官方插件市场，Claude Code 和 Codex 用户都能从本仓库安装 works 插件—— tm 项目管理工作流命令集（Issue 推进、实现/设计文档、代码审查、PR 创建与日报规划）， 内置 pm MCP 服务器直连 TourMind Works 平台。

安装

第 1 步：配置 Token（必需）

插件通过环境变量 TOURMIND_WORKS_TOKEN 读取 Works 平台的鉴权 Token（oat_ 前缀）， 在 ~/.zshrc（或 ~/.bashrc）中添加后重开终端：

export TOURMIND_WORKS_TOKEN=oat_你的Token

使用 Codex macOS 应用（非终端启动）的，还需执行 launchctl setenv TOURMIND_WORKS_TOKEN oat_你的Token 后完全退出重开 Codex。

第 2 步：安装插件

方式一：自然语言安装（推荐） —— 把下面这段话直接发给 Claude Code 或 Codex：

帮我安装 TourMind 的 works 插件：
1. 添加插件市场，GitHub 仓库是 tourmind-com/works-plugin
2. 从市场 tourmind-plugins-official 安装 works 插件
3. 检查环境变量 TOURMIND_WORKS_TOKEN 是否已设置，没有的话指导我配置
4. 装好后列出所有可用的 tm-* 工作流命令

方式二：命令安装

Claude Code（会话内执行）：

/plugin marketplace add tourmind-com/works-plugin
/plugin install works@tourmind-plugins-official

Codex（终端执行，装完新开一个会话生效）：

codex plugin marketplace add tourmind-com/works-plugin
codex plugin add works@tourmind-plugins-official

第 3 步：开始使用

命令	用途
tm-daily	每日工作规划
tm-start IT-123	开始/推进 Issue 的完整 AI 工作流
tm-impl	生成实现方案文档
tm-design	生成设计文档
tm-ui	生成界面设计文档
tm-review	审查实现文档
tm-code-review	代码审查
tm-create-pr	为当前分支创建 PR
tm-new-issue	从当前会话快速创建 Issue
tm-status	更新 Issue 状态
tm-overview	PM 项目概览

• Claude Code：命令带 works: 命名空间，如 /works:tm-daily、/works:tm-start IT-123
• Codex：直接 /tm-daily，或用自然语言（如「规划今天的工作」「帮我创建 PR」）触发对应技能

保持更新

最省事的方式：装好插件后直接对 AI 说「更新 works 插件」（或 Claude Code 中 /works:works-update、Codex 中 /works-update），剩下的交给它。

手动方式：

• Claude Code：/plugin → Marketplaces 标签 → 选中 tourmind-plugins-official → Enable auto-update，之后每次启动自动拉取最新版（第三方市场默认关闭，需手动开一次）。 手动更新：claude plugin marketplace update tourmind-plugins-official 后 /reload-plugins。
• Codex：codex plugin marketplace upgrade tourmind-plugins-official 后重装 codex plugin add works@tourmind-plugins-official，新开会话生效。

---

插件维护者请见 docs/MAINTAINER.md。

License

MIT