Tuskway

Tuskway 插件

一个插件文件夹 plugins/tuskway，适用于 Claude Code、Cursor、Codex、Copilot CLI、Grok Build、OpenCode 和 Pi。Grok Bot 使用 Cursor 安装方式。

该插件连接到托管的 MCP 服务 https://tuskway.com/mcp。在客户端中通过 OAuth 登录。软件包不包含访问令牌、钩子、规则文件或子 Agent。

plugins/tuskway/skills/ 中有九个工作流技能。

安装

从此仓库安装。它未列入 Claude、Cursor 或 Codex 插件目录。托管服务已列入官方 MCP Registry，名称为 com.tuskway/tuskway。

Agent	安装	登录
Claude Code	/plugin marketplace add tuskway/plugin，然后运行 /plugin install tuskway@tuskway	运行 /mcp，选择 plugin:tuskway:tuskway
Cursor（团队）	Dashboard → Plugins & MCPs → Team Marketplaces → Import from Repo https://github.com/Tuskway/plugin。成员从 Customize 安装。	Cursor 的登录提示
Cursor（个人）	Customize → Add Marketplace → 在 User 范围内从 GitHub 导入，然后在 Personal 标签页中选择 Add。	Cursor 的登录提示
Grok Bot	使用 Cursor 安装方式。如果 Cursor 提示同步插件，请完成 GitHub 身份验证。	通过 Cursor
Codex	codex plugin marketplace add tuskway/plugin，然后运行 codex plugin add tuskway@tuskway	codex mcp login tuskway
Copilot CLI	copilot plugin marketplace add tuskway/plugin，然后运行 copilot plugin install tuskway@tuskway	/mcp auth tuskway
Grok Build	grok plugin install tuskway/plugin	运行 /mcps，选择 tuskway，然后按 i
OpenCode	npx skills add tuskway/plugin --agent opencode 和 opencode mcp add tuskway --url https://tuskway.com/mcp	opencode mcp auth tuskway
Pi	pi install git:github.com/tuskway/plugin 和 pi mcp add tuskway --url https://tuskway.com/mcp	pi mcp login tuskway
Gemini CLI	gemini extensions install https://github.com/Tuskway/plugin	Gemini 的登录提示

使用客户端的市场更新命令进行更新。Pi 和 OpenCode 则通过再次运行安装命令来更新。

MCP

两个文件都将服务命名为 tuskway，地址为 https://tuskway.com/mcp。

plugins/tuskway/mcp.json 是 Agent Plugins 文档。服务使用 streamable-http，且仅包含 type 和 url。该架构会拒绝任何其他字段，包括 auth 和 extensions。如果服务条目包含 extensions，Codex 会将其丢弃，因此此文件不会声明 OAuth。请使用客户端的 MCP 登录功能登录。

.mcp.json 的内容为 { "type": "http", "url": "https://tuskway.com/mcp" }。Claude Code 会将不带 type 的 url 视为 stdio。Cursor 会先读取 .mcp.json，再读取 mcp.json。.cursor-plugin/plugin.json 会将 mcpServers 固定为 ./.mcp.json。

Codex 要求 onboardingSkill 必须是指向已打包 SKILL.md 的 ./ 路径。两个 Codex 清单都将其设为 ./skills/setup-tuskway/SKILL.md。

根目录的 package.json 设置了 "private": true，因此 npm publish 不会上传此软件包。Pi 会安装 git 仓库并加载 plugins/tuskway/skills。

server.json 为官方 MCP Registry 指定了同一个服务：通过 streamable HTTP 访问 https://tuskway.com/mcp 的 com.tuskway/tuskway。gemini-extension.json 和 GEMINI.md 是位于仓库根目录的 Gemini CLI 扩展。要在 Gemini CLI gallery 中展示，还需为此仓库添加 GitHub 主题 gemini-cli-extension。

检查软件包

node --test scripts/test-plugin.mjs
node scripts/sync.mjs --check
node scripts/validate.mjs
node scripts/package-limits.mjs
npm run build:openai-zip
node --test scripts/test-manifests.mjs scripts/test-build-claude.mjs evals/mock-tuskway.test.mjs evals/grade.test.mjs

sync.mjs --check 会比较清单版本，不会重写版本或创建标签。validate.mjs 会检查技能 frontmatter、本地大小限制和资源链接。package-limits.mjs 在发现符号链接、子模块、超过 512 个文件，或 plugins/tuskway 下有超过 256 KiB 的非图像文件时会报错。九个技能都必须存在，包括 sync-design-tuskway。evals/ 会在模拟服务上运行这些技能，而不是在 https://tuskway.com 上运行。

npm run build:openai-zip 会生成 dist/tuskway-openai-<version>.zip。归档根目录包含 plugin.json、mcp.json、skills/ 和 assets/。npm run build:openai-zip -- --folder <name> 会将同一根目录放在一个顶层目录中，且不会添加同级条目。构建过程会检查 Agent Plugins 1.0.0 架构，检查每个技能 frontmatter 中的 name 是否与其文件夹匹配，并在文件匹配凭据模式时失败。软件包不包含测试凭据、审核者说明、apps 或 .app.json。

发布

当技能或列表数据发生变化时，请提高每个清单中的 version。如果任何清单版本不一致，node scripts/sync.mjs --check 就会报错。

为合并后的提交创建标签并推送该标签。使用清单中的版本：

git checkout main
git pull origin main
git tag vX.Y.Z
git push origin vX.Y.Z

标签工作流会发布 GitHub 版本，并附上 dist/tuskway-openai-X.Y.Z.zip。如果该任务无法附加 ZIP，请将同一文件上传到该版本。不要将访问令牌放入 ZIP、此 README 或 CI 日志中。

如果发布时 server.json 有更改，请在推送标签后将其重新发布到官方 MCP Registry。使用 tuskway.com 的 DNS 进行身份验证，然后从仓库根目录运行 mcp-publisher publish，使 com.tuskway/tuskway 与新版本一致。

提交至 OpenAI 或 Claude 之前，如果已安装 Claude CLI，请运行 claude plugin validate ./plugins/tuskway。如果运行器上存在 claude，软件包工作流就会运行该命令。

Claude 目录

Claude 插件目录仅接受 Markdown、文本、JSON、YAML，以及 PNG、JPEG、GIF、WebP 或 ICO 图像。本仓库为其他平台保留了 assets/logo.svg 和 skills/sync-design-tuskway/scripts/drift.mjs。

要发布 Claude 发行版：

npm run build:claude

此命令会将精简副本写入 dist/claude。将该目录树推送到 Tuskway/plugin-claude，并使用与清单相同的版本创建标签。

许可证

MIT