mhattingpete/claude-skills-marketplace · 上手攻略

仓库：mhattingpete/claude-skills-marketplace
链接：https://github.com/mhattingpete/claude-skills-marketplace
分类：Claude Code · Skill 扩展
作者：Tom
更新：2026-08-27

这是什么

mhattingpete/claude-skills-marketplace 是一个 Claude Code 插件市集，收录了围绕软件开发全流程的 Skills（技能）和 Agents（智能体）。与普通的 slash 命令不同，Skill 由 Claude Code 根据上下文自动触发——你描述需求，Claude 判断是否调用对应技能。

核心解决的问题：把常见的重复性开发工作（Git 推送、代码审查、测试修复、重构、文档生成）封装成可复用的 Skill，让 Claude Code 在合适的场景自动接管。

解决什么问题

工作流自动化缺失：Git 操作、代码审查、测试修复原本需要手动分步完成，Skill 让 Claude 在编码过程中自动感知并介入。
Token 消耗过高：对大型代码库做批量修改时，读取所有文件会消耗大量上下文。execution-runtime 插件通过本地执行 Python 将 Token 消耗降低 90%+（100 文件：~25,000 tokens → ~600 tokens）。
文档生成效率低：手动写架构图、流程图、时序图费时费力，visual-documentation-plugin 用 Mermaid/SVG 自动生成。

快速安装

# 安装整个市集（所有插件）
/plugin marketplace add mhattingpete/claude-skills-marketplace

# 安装单个分类插件
/plugin marketplace add mhattingpete/claude-skills-marketplace/engineering-workflow-plugin
/plugin marketplace add mhattingpete/claude-skills-marketplace/visual-documentation-plugin
/plugin marketplace add mhattingpete/claude-skills-marketplace/productivity-skills-plugin
/plugin marketplace add mhattingpete/claude-skills-marketplace/code-operations-plugin

安装完成后，Skills 根据上下文自动激活，无需手动调用。

核心用法

Engineering Workflow Plugin（工程流插件）

包含 4 个 Skill + 1 个 Agent，是整个市集最核心的部分。

Feature Planning Skill — 激活条件：用户提出新功能、增强或复杂变更需求。

"添加用户登录功能"
"为分析仪表盘写个计划"

自动拆解为可执行的任务列表，交给 plan-implementer Agent 执行。

Git Pushing Skill — 激活条件：用户提到 push、commit 或保存到远程。

"Push 这些更改"
"Commit 并推送到 GitHub"

自动执行 git add → git commit（conventional commits 格式）→ git push。

Code Review Skill — 激活条件：用户要求 review 或检查代码。

"Review 这个 PR"
"帮我检查这段代码有什么问题"

Test Fixing Skill — 激活条件：测试失败或需要修复测试。

"Fix 这些失败的测试"
"测试报错，看看是什么问题"

Visual Documentation Plugin（可视化文档插件）

Architecture Diagram Creator — 根据项目结构生成架构图（Mermaid 格式）。 Dashboard Creator — 生成 HTML 可交互仪表盘。 Flowchart Creator — 流程图生成。 Technical Doc Creator — 技术文档生成。 Timeline Creator — 时间线图。

Execution Runtime（代码执行运行时）⚠️

# 安装后运行设置脚本
~/.claude/plugins/marketplaces/mhattingpete-claude-skills/execution-runtime/setup.sh

安装后，Skills 在以下场景自动切换到本地执行模式： - 批量操作（10+ 文件） - 复杂多步骤工作流 - 迭代式处理 - 全代码库分析

Token 节省示例： - 普通模式：读取 50 个文件 → ~25,000 tokens - Execution 模式：运行脚本 + 返回摘要 → ~600 tokens（节省 97.6%）

⚠️ 注意：execution-runtime 依赖 FastMCP server（mcp-server/），需要 Python 环境和网络访问。沙箱安全机制默认开启（自动屏蔽 PII 和密钥）。

Productivity Skills Plugin

Code Auditor：代码质量审计
Codebase Documenter：为整个代码库生成文档
Conversation Analyzer：分析 Claude Code 使用模式
Project Bootstrapper：项目初始化

Code Operations Plugin

Code Execution：本地 Python 执行（需 execution-runtime）
Code Transfer：基于行的代码插入
Code Refactor：批量重构
File Operations：文件分析

典型适用场景

场景	推荐插件
日常代码审查（PR review）	engineering-workflow-plugin
批量变量重命名（50+ 文件）	code-operations-plugin + execution-runtime
项目文档自动生成	visual-documentation-plugin
新项目初始化脚手架	productivity-skills-plugin / project-bootstrapper
多步骤功能实现	engineering-workflow-plugin / plan-implementer agent

坑与注意

Skill 触发是隐式的：Skill 不像 slash 命令那样手动调用，而是由 Claude 根据描述自动判断是否激活。初期可能需要明确描述需求（如"帮我 review 这段代码"）才能触发。
Execution Runtime 需要独立安装：核心 Token 节省功能不在默认安装路径里，必须单独运行 setup.sh 并重启 Claude Code。
FastMCP 依赖：execution-runtime 的 mcp-server/ 目录依赖 FastMCP。在部分 Claude Code 配置下可能需要额外安装 fastmcp 包。
xRxiv 预印本需要下载完整 dump：bioRxiv/medRxiv/chemRxiv 数据量大（bioRxiv ~800 MB），首次使用需要下载全量数据，之后才能本地查询。
多插件可能冲突：同时安装所有插件时，部分 Skill 的触发描述可能重叠，导致非预期激活。建议按需安装，初期只装 engineering-workflow-plugin。
Skills 的 YAML frontmatter 是关键：每个 Skill 的 SKILL.md 包含 frontmatter 元数据（name、description、metadata），Claude 靠 description 判断触发时机，修改 description 会影响激活行为。

与同类对比

方案	优势	劣势
mhattingpete/skills	自动触发、Token 节省、Agent 编排能力强	依赖 Claude Code、触发逻辑不透明
@anthropic/skills 官方库	官方维护、质量有保证	覆盖范围有限、定制性弱
自定义 SKILL.md	完全可控	需手动管理、无法跨项目复用
slash commands	显式调用、无歧义	需记忆命令、无法自动触发

mhattingpete 的市集在触发自动化和工程覆盖度上优于官方技能库，在Token 经济性上优于所有手动方案。

一句话推荐结论

如果你是 Claude Code 重度用户且经常处理重复性开发任务（Git、Review、测试），安装 engineering-workflow-plugin 是最高性价比的选择；如果需要批量代码操作，务必加上 execution-runtime，97% 的 Token 节省是真实的白嫖。

原始 commit：https://github.com/mhattingpete/claude-skills-marketplace/commit/main（SHA：需 clone 后 git rev-parse HEAD 获取）