快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

详细介绍

🏔️ 夏尔巴人-人工智能开发工作流程指南

![CI](https://github.com/anthropics/sherpa-mcp/actions) ](https://www.npmjs.com/package/sherpa-mcp) ![License: MIT](https://opensource.org/licenses/MIT) ![TypeScript](https://www.typescriptlang.org/) ![Tests](#testing)

MCP服务器，通过行为采用和积极强化引导AI代理完成系统开发工作流程

Sherpa是一个模型上下文协议（MCP）服务器，它通过引导代理通过经过验证的工作流程和行为采用技术来转换人工智能辅助开发。通过积极强化、进度跟踪和情境庆祝，夏尔巴人帮助人工智能代理开发系统化的编码实践，从而获得更高质量的结果。

为什么是夏尔巴人？

当使用AI编码助手时，他们很容易：

跳过编写测试，急于实现
在没有系统调查的情况下猜测解决方案
在不了解根本原因的情况下修复错误
创建不遵循经过验证的模式的代码

夏尔巴人通过行为收养改变了这一点：

🎯 正向强化：通过鼓舞人心的反馈来庆祝进展
📈 进度跟踪：监控工作流程完成情况和连续性建设
🏆 成就系统：确认里程碑和系统发展
💡 成功案例：分享Netflix、GitHub和Shopify等公司的真实案例
🎉 充满活力的庆祝活动基于当前进展的情境性鼓励

研究表明，系统化的工作流程将bug减少了60%以上，并大大提高了开发人员的信心。

快速开始

1.安装依赖项

要求： 该项目需要包子以获得最佳性能。

# Install Bun if you haven't already:
curl -fsSL https://bun.sh/install | bash

# Install dependencies:
bun install

2.初始化夏尔巴人（必填-一次性设置）

首次使用前，运行安装脚本以安装工作流：

bun run setup

这创造了 ~/.sherpa/ 与：

9个默认工作流文件（tdd.yaml、bug-hunt.yaml等）
用于跟踪进度的日志目录

在配置Claude之前，您必须运行此程序。 工作流已复制到您的主目录，因此您可以在不影响源代码的情况下自由自定义它们。

3.配置Claude

对于Claude Code（CLI）：

增添 ~/.claude/config.json:

{
  "mcpServers": {
    "sherpa": {
      "command": "bun",
      "args": ["run", "/absolute/path/to/sherpa-server.ts"]
    }
  }
}

对于Claude Desktop：

增添 ~/Library/Application Support/Claude/claude_desktop_config.json （Mac）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "sherpa": {
      "command": "bun",
      "args": ["run", "/absolute/path/to/sherpa-server.ts"]
    }
  }
}

重要提示： 使用绝对路径 sherpa-server.ts 在该存储库中（例如。， /Users/yourname/projects/sherpa/sherpa-server.ts).

4.开始编码！

在Claude中，人工智能现在可以使用两个强大的工具：

guide -为您的下一步工作流程提供专家指导
approach -在开发方法之间进行选择和切换

您的工作流现在可以在所有项目中使用！ 🎉

技能（推荐）

夏尔巴人包括教人工智能代理如何有效使用系统开发工作流程的技能：

tdd循环 -严格TDD工作流程执行（定义合同→ 测试→ 实施→ 重构）
猎虫 -采用再现优先的方法进行系统调试（防止症状修复）
系统发展 -一般平衡工作流程（研究→ Plan → 测试→ 实施→ 验证）

为什么要使用技能？ 技能提供了经过验证的工作流程模式，帮助人工智能代理正确遵循夏尔巴人的系统方法。它们在相关时自动激活，确保 guide check 在编码和适当的相位推进之前。

安装

# Install skills globally (works across all projects where Sherpa is configured)
mkdir -p ~/.claude/skills
cp -r /path/to/sherpa/skills/* ~/.claude/skills/

技能是模型调用的——Claude会根据您的请求自动使用它们（实现功能→ tdd周期，修复bug→ 找虫，一般工作→ 系统发展）。不需要显式命令。

🎯 行为采纳特征

夏尔巴人使用经过验证的行为心理学来帮助人工智能代理养成系统的习惯：

进度跟踪和庆祝活动

步骤完成：在情境鼓励下庆祝每个工作流程步骤
阶段推进：完成工作流程阶段时的特殊认可
里程碑式成就：解锁“第一工作流精通”和“工作流老手”等成就
Streak大楼：跟踪连续几天的系统开发

动态激励系统

上下文感知消息：第一步与主要里程碑的庆祝活动不同
工作流特定表扬TDD得到以测试为重点的鼓励，Bug Hunt得到侦探隐喻
成功灵感：偶尔分享相关公司的成功案例
工具使用强化：对使用系统方法的积极反馈

行为流示例

// After completing a test
{
  "celebration": "🧪 Excellent! First test written - you're building bulletproof code!",
  "tool_encouragement": "🎯 Excellent workflow awareness! Checking progress keeps you oriented.",
  "progress_encouragement": "📈 Great progress! 1 workflows completed, 5 steps taken.",
  "success_inspiration": "TDD practitioners at major companies ship 67% fewer bugs!"
}

个性化提示

根据使用模式，夏尔巴人提供个性化建议：

尝试不同的工作流程类型，获得不同的体验
建立一致性，以更好地形成习惯
每个工作流程完成更多步骤，以获得最大收益

可用工作流

🧪 TDD（TDD.Yaml）

纯测试优先开发。非常适合：

构建解析器、提取器、转换器
创建定义良好的实用程序
任何你知道预期行为的功能

🐛 Bug Hunt（Bug Hunt.yaml）

通过测试进行系统调试。适用于：

修复报告的错误
调查车祸
解决测试失败

📝 将军（将军yaml）

平衡的研究方法→ plan → test → 实施。适用于：

大多数功能开发
添加新功能
默认工作流

🚀 快速（Rapid.yaml）

具有追溯测试的快速原型制作。用途：

尖峰和实验
概念证明
演示准备

📋 规划（Planning.yaml）

纯粹的规划工作流程——在实施之前进行研究、理解、设计和记录。适用于：

建筑设计
特性规范
需求分析
研究和文件

♻️ 重构（Refactor.yaml）

具有测试覆盖率的安全重构。非常适合：

代码清理
性能改进
重组

🔥 修补程序（Hotfix.yaml）

用最少的过程修复紧急错误。用途：

生产事故
需要立即关注的关键错误
时间敏感修复

🔍 探索（Exploration.yaml）

探索性开发和实验。非常适合：

学习新技术
调查方法
没有承诺的原型制作

👁️ 代码审查（Code Review.yaml）

全面的代码审查流程。适用于：

审查拉取请求
审计代码质量
指导和反馈

管理工作流

可用命令

# Check Sherpa status and installed workflows
bun run status

# Reinstall default workflows (preserves existing customizations)
bun run setup

# Force reinstall (overwrites customizations)
bun run setup:force

# Reset to default workflows (removes all customizations)
bun run reset

# View real-time logs
bun run logs

# View latest log file
bun run logs:latest

自定义工作流

编辑中的任何文件 ~/.sherpa/workflows/ 为了符合您的喜好：

name: "Your Workflow Name"
description: "What this workflow is for"
trigger_hints:  # Keywords that auto-select this workflow
  - "keyword1"
  - "keyword2"
phases:
  - name: "📋 Phase Name"
    guidance: "What to focus on"
    suggestions:
      - "Specific action 1"
      - "Specific action 2"

创建新工作流

创建新文件： ~/.sherpa/workflows/my-workflow.yaml
遵循上述结构
重新启动Claude以加载新工作流

示例工作流程

结账 workflows/examples/ 对于其他专门的工作流程：

📚 文档 -用于编写指南和API文档
🔒 安全审计 -用于防御安全审查
📈 演出 -用于优化项目

将任何示例复制到工作流目录：

cp workflows/examples/documentation.yaml ~/.sherpa/workflows/

用法示例

当克劳德开始处理一项任务时，夏尔巴人会提供丰富而鼓舞人心的指导：

Claude: I need to fix the login bug.

[Calls: next check]

Sherpa: {
  "workflow": "Bug Hunt",
  "phase": "🔍 Reproduce & Isolate",
  "guidance": "Understand the bug completely before fixing",
  "suggestions": ["Reproduce manually first", "Document exact steps", ...],
  "tool_encouragement": "🎯 Excellent workflow awareness! Checking progress keeps you oriented.",
  "progress_encouragement": "🔥 Amazing 3-day streak! You're building excellent workflow habits."
}

Claude: I'll systematically reproduce this issue first...

[After reproducing]
[Calls: next done: "Reproduced - happens with special characters in email"]

Sherpa: {
  "celebration": "🔍 Detective mode activated! Great systematic reproduction work.",
  "workflow": "Bug Hunt",
  "phase": "🎯 Capture in Test",
  "guidance": "Lock down the bug with a failing test",
  "suggestions": ["Write failing test with special chars", ...],
  "progress": {"completed": 1, "total": 3, "remaining": 2},
  "success_inspiration": "Netflix reduced critical incidents by 73% through systematic bug reproduction!"
}

实际效益：

🎯 克劳德自然会采取系统的方法
📈 进度跟踪建立势头和信心
🎉 庆祝活动强化良好的发展习惯
💡 成功案例提供了额外的动力

成功秘诀

简单开始：按原样使用提供的工作流
逐步定制：根据适合您项目的工作流程调整工作流程
具体：添加明确、可操作的建议来指导人工智能
强化良好习惯：人工智能将学会使用 guide 定期

哲学

夏尔巴人通过行为科学改变人工智能的发展：

核心原则

正向强化：赞扬系统方法，而不是惩罚捷径
逐步养成习惯：通过持续的鼓励逐步建立工作流程纪律
情境感知指导：根据当前进度和工作流类型调整反馈
循证：结合行业领导者的真实成功案例

设计理念

建议性的，非规定性的：指导而不限制创造力
轻量级：只需2个直观的工具，最少的上下文使用，最大的行为影响
可定制的：您的工作流程、庆祝活动、发展文化
以测试为重点：因为人工智能生成的代码需要系统验证
快乐驱动：使系统开发感到有益和满意

故障排除

工作流未加载

确保 ~/.sherpa/workflows/ 存在并包含YAML文件
跑 bun run status 检查您的安装
检查日志： bun run logs:latest
如果丢失，请运行 bun run setup 重新安装

AI不遵循工作流程

提醒克劳德使用 guide 工具定期-夏尔巴人会庆祝这个！
行为收养系统自动提供正向强化
考虑调整工作流程建议，使其更加具体和令人鼓舞
检查庆祝活动和进度跟踪是否激励了工具的一致使用

调试问题

查看实时日志： bun run logs
检查Claude Desktop中的服务器启动消息
验证Claude Desktop配置中的绝对路径
日志存储在 ~/.sherpa/logs/ 自动轮换（7天）

常见问题

“夏尔巴人未初始化”错误：

bun run setup

“未找到工作流”警告：

bun run reset  # Reinstall default workflows

服务器无法启动：

检查Claude Desktop配置中的绝对路径
确保Bun已安装并位于您的PATH中
检查TypeScript错误： bun run sherpa-server.ts

建筑

行为收养制度

夏尔巴人的行为收养系统包括：

自适应学习引擎 (src/behavioral-adoption/adaptive-learning-engine.ts)：跟踪用户模式并提供个性化指导
进度跟踪器 (src/behavioral-adoption/progress-tracker.ts)：监控工作流完成情况、跟踪里程碑并维护使用统计数据
庆典生成器 (src/behavioral-adoption/celebration-generator.ts)：创建情境鼓励和成功庆祝活动
激励制度 (src/server-instructions/templates/encouragements.json)：100多条按工作流程类型和上下文组织的上下文鼓励消息

核心架构

MCP服务器 (sherpa-server.ts)：具有集成行为系统的主模型上下文协议服务器
工作流引擎：基于YAML的工作流定义，具有分阶段指导
基于文件的日志记录：所有行为事件和进度记录到 ~/.sherpa/logs/

贡献

改进的想法？工作流程模式是否有效？新的行为采用技术？请分享！

发展

# Install dependencies
bun install

# Run tests
bun test

# Check server startup (for testing)
bun run start

# Initialize user workflows
bun run setup

# View logs during development
bun run logs

______________________________________________________________________

*记住：就像一个好的夏尔巴人，这个工具会引导你的旅程，但不会带你。人工智能仍然需要做这项工作，但现在它有了一个值得信赖、鼓舞人心的指南，来庆祝每一步的进步。*

目录标签

TypeScriptClaude代码质量AI开发辅助本地部署工作流管理行为心理学测试驱动开发

支持客户端

Claude DesktopClaude

接入字段

传输方式（transport，传输协议）

未说明

鉴权方式（authType，认证方式）

session

工具数量（toolCount，工具数）

0

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

未说明session部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

仍需确认：installCommand

来源信息

MCP World

mcpworld.com

/detail/7b3945350f80d86641cae72c151bf417

Sherpa是一个MCP服务器，通过行为采纳和正面强化技术，引导AI代理完成系统化的开发工作流程，提高代码质量和开发效率。

继续浏览同类 MCP

更多AI代理 MCP（18,706）返回 MCP 目录

上一个 MCP

shelly.mcpserver

连接Shelly云与全球任何设备的集成项目，提供MCP服务器和REST API网关功能。

下一个 MCP

Shettysaish20 MCP

全面解析MCP Server V3MCP Server的核心功能、安装配置和实用案例。作为顶级Model Context Protocol服务器，MCP Server V3能让AI助手访问实时数据、执行操作，为您提供更智能的工作体验和自动化解决方案。

sherpa (Anortham)