sync

English | 中文

TapTap Claude Code Plugins Marketplace

TapTap 团队维护的 Claude Code 插件库，提供开发工作流自动化工具。

团队配置

对于团队项目，可以在项目根目录配置 .claude/settings.json，Claude Code 会自动安装插件，无需手动执行安装命令。

1. 配置 settings

在项目根目录执行以下命令：

mkdir -p .claude && echo '{
  "extraKnownMarketplaces": {
    "taptap-plugins": {
      "source": {
        "source": "github",
        "repo": "taptap/claude-plugins-marketplace"
      }
    }
  },
  "enabledPlugins": {
    "spec@taptap-plugins": true,
    "sync@taptap-plugins": true,
    "git@taptap-plugins": true,
    "quality@taptap-plugins": true
  }
}' > .claude/settings.json

可选：按仓库配置 Git 插件行为

在 .claude/settings.json 的 env 字段中可配置 Git 插件行为：

环境变量	默认值	说明
GIT_ALLOW_NO_TICKET	"true"	是否允许 no-ticket 提交，设为 "false" 可禁用

示例（禁用 no-ticket，要求必须提供任务 ID）：

{
  "env": {
    "GIT_ALLOW_NO_TICKET": "false"
  },
  "enabledPlugins": { ... }
}

2. 执行 /sync

一键配置 MCP、自动更新和 Cursor 同步：

# 在 Claude Code 中执行
/sync:basic

# 配置完成后，重启 Claude Code 和 Cursor 即可使用

包含功能：

• ✅ 配置 context7 和 sequential-thinking MCP（自动获取最新文档）
• ✅ 启用插件自动重载 + CLI 工具检测（修改后重启会话即可生效）
• ✅ 同步配置到 Cursor（含 Spec Skills 规则）
• ✅ 同步 GitLab Merge Request 默认模板
• ✅ 支持 GitHub Pull Request 模板

3. 验证安装

# 查看已安装插件
/plugin

# 查看可用命令
/help

插件列表

插件	版本	描述
spec	0.1.4	Spec-Driven Development 工作流插件
git	0.1.13	Git 工作流自动化插件（提交/推送/MR + 自动代码审查 + 远程平台操作）
sync	0.1.23	开发环境配置同步插件（MCP + LSP + Hooks + Cursor + Claude Skills）
quality	0.0.4	AI 驱动的代码质量检查插件（9 个并行 Agent，支持 Bug 检测、代码质量、安全检查、性能分析）

详细说明请查看各插件目录下的 README.md。

版本历史：查看 CHANGELOG.md 了解各版本更新内容。

日常使用

Git 工作流（推荐）

适用于需要创建 MR 的开发场景：

# 1. 提供任务链接，自动创建分支、提交、推送并创建 MR
/git:commit-push-pr https://xindong.atlassian.net/browse/TAP-12345

# 或提供飞书任务链接
/git:commit-push-pr https://project.feishu.cn/pojq34/story/detail/12345

命令执行流程：

• 自动从任务链接提取 Task ID
• 智能判断分支前缀：分析 git diff 内容自动选择合适的前缀
  • docs/：仅修改文档文件
  • test/：仅修改测试文件
  • fix/：包含 bug 修复关键词
  • feat/：新增功能或文件
  • refactor/：代码重构
  • perf/：性能优化
  • chore/：配置或维护任务
• 如果在 main/master 分支，会询问分支描述并创建功能分支（如 feat/TAP-12345-description）
• 分析代码变更，生成符合规范的提交信息
• 推送代码并自动创建 Merge Request / Pull Request

平台支持：

平台	CLI 工具	模板路径
GitLab	glab	.gitlab/merge_request_templates/default.md
GitHub	gh	.github/PULL_REQUEST_TEMPLATE.md

💡 命令会自动检测仓库类型和可用的 CLI 工具，选择合适的方式创建 MR/PR。

CLI 工具配置： 使用 /sync:git-cli-auth 命令检测和配置认证

# 配置 git cli Token
/sync:git-cli-auth

# 或使用原始命令
gh auth login        # GitHub
glab auth login      # GitLab

快速提交与推送

Git 插件提供三种提交方式，根据需求选择：

1. 仅提交（本地开发）

# 适用于：还需要多次提交，暂不推送
/git:commit

2. 提交并推送（备份到远程）

# 适用于：功能完成，需要备份到远程，但不创建 MR
/git:commit-push

3. 提交、推送并创建 MR（完整流程）

# 适用于：功能完成，立即创建合并请求
/git:commit-push-pr https://xindong.atlassian.net/browse/TAP-12345

说明：

• 所有命令都会自动从分支名提取 Task ID
• 在 main/master 分支会自动创建功能分支
• /git:commit-push-pr 支持智能分支前缀判断

Spec 驱动开发

⚠️ 警告：此功能正在开发中，暂不推荐使用

从需求文档生成技术方案并执行开发：

# 根据任务需求生成完整的技术方案和执行计划
/spec https://xindong.atlassian.net/browse/TAP-12345

模块发现（module-discovery）

AI 开始工作时自动读取模块索引，快速了解项目结构：

路径	说明
tap-agents/tap-agents-configs.md	项目配置文件（项目类型、项目名称、业务模块目录、主要类后缀、文件扩展名）
tap-agents/prompts/module-map.md	模块索引（P0/P1/P2 优先级分类 + 关键词定位表）
tap-agents/prompts/modules/[模块名].md	各模块详细文档

工作流程：

1. AI 检查 module-map.md 是否存在
2. 如不存在，询问用户是否生成（使用 generate-module-map.md prompt）
3. 读取模块索引，利用关键词快速定位代码

文档自动同步（doc-auto-sync）

AI 修改代码时自动维护模块文档：

触发场景	AI 行为
新增模块	创建 modules/[模块名].md + 更新 module-map.md
修改模块	检查并更新对应文档
文档缺失	自动创建文档（强制执行）
文档过期	信任代码，自动更新文档

配置项（在 tap-agents/tap-agents-configs.md 中定义）：

• 「项目类型」：iOS / Android / Web / Backend 等
• 「项目名称」：项目名称
• 「业务模块目录」：主要业务代码目录（如 TapTap、src/modules）
• 「主要类后缀」：识别主要类的后缀（如 ViewController、Service）
• 「文件扩展名」：代码文件扩展名（如 .swift、.kt、.go）

代码质量检查

使用 AI 驱动的代码审查，自动检测潜在问题：

# 审查当前分支的所有变更
/review

# 审查特定 Merge Request
/review --mr 123

# 审查特定文件
/review path/to/file.go

功能亮点：