🚀 OnboardingOS——零到高效开发代理
“你的AI伙伴将数周的入职变成了数小时”
    
______________________________________________________________________
🎯 问题
新开发人员采取 2-4周 变得富有成效。每家公司都输了 5万美元+ 每位员工在入职时间内。
| 痛点 | 影响 |
|---|---|
| 😫 设置开发环境 | 每天30多分钟 |
| 🤷 “这件事我该问谁?” | 浪费了几个小时才找到合适的人 |
| 📚 过时的文档 | 错误的答案,更多的混乱 |
| 🔄 部落知识丢失 | 当老年人离开时,知识也会消失 |
| 📊 没有进度可见性 | 经理无法跟踪入职情况 |
💡 解决方案
机载操作系统 是一个基于人工智能的入职助理 Archestra的MCP平台 即:
- 📁 解释代码库架构 立即通过GitHub
- 🛠️ 设置开发环境 自动进行安全检查
- 📖 搜索内部文档 任何问题的答案
- 👥 将您与合适的专家联系起来 通过Slack
- 📊 跟踪入职进度 游戏化与成就
______________________________________________________________________
🏗️ 建筑
┌──────────────────────────────────────────────────────────────────┐
│ ARCHESTRA PLATFORM │
│ ┌──────────┐ ┌──────────────┐ ┌──────────────────────────┐ │
│ │ Chat UI │ │ Security │ │ Observability │ │
│ │ (port │ │ (Dual LLM, │ │ (Metrics, Traces, │ │
│ │ 3000) │ │ Approvals) │ │ Cost Monitoring) │ │
│ └──────────┘ └──────────────┘ └──────────────────────────┘ │
│ │ │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ 🤖 OnboardingOS Agent │ │
│ │ "Friendly Onboarding Buddy" with Smart Routing │ │
│ └──────────────────────────────────────────────────────────┘ │
│ │ │ │ │ │ │
│ ┌────┴───┐ ┌────┴───┐ ┌────┴───┐ ┌────┴───┐ ┌────┴────┐ │
│ │ GitHub │ │ Docs │ │Terminal│ │ Slack │ │Progress │ │
│ │ MCP │ │ MCP │ │ MCP │ │ MCP │ │ MCP │ │
│ │ 5 tools│ │ 4 tools│ │ 5 tools│ │ 5 tools│ │ 4 tools │ │
│ └────────┘ └────────┘ └────────┘ └────────┘ └─────────┘ │
└──────────────────────────────────────────────────────────────────┘______________________________________________________________________
🛠️ MCP服务器(5台服务器,23个工具)
1.📂 GitHub MCP——代码库理解
| 工具 | 说明 |
|---|---|
explain_repo_structure | 分析文件夹布局、语言、关键文件 |
find_file | 在仓库中按名称搜索文件 |
explain_code | 获取带有上下文的文件内容以进行解释 |
get_recent_prs | 查看最近的PR以了解团队模式 |
who_owns_code | 找出谁是特定代码的专家 |
2.📖 文档MCP——文档搜索
| 工具 | 说明 |
|---|---|
search_docs | 带有相关性评分的全文搜索 |
get_document | 按ID检索完整文档 |
get_onboarding_checklist | 分阶段入职检查表 |
list_all_docs | 浏览所有可用文档 |
3.🖥️ 终端MCP——环境设置
| 工具 | 说明 |
|---|---|
check_dev_environment | 验证Node、NPM、Git、Docker是否已安装 |
get_setup_instructions | 逐步修复指南 |
run_safe_command | 安全执行只读命令 |
run_setup_command | ⚠️ 需要批准 --系统修改命令 |
suggest_next_steps | 情境感知建议 |
4.💬 Slack MCP——团队整合
| 工具 | 说明 |
|---|---|
find_expert | 将主题与团队专家匹配 |
search_discussions | 从过去的对话中寻找答案 |
list_channels | 显示要加入的频道 |
send_welcome_message | ⚠️ 需要批准 --发布到Slack |
get_team_contacts | 完整的团队目录及其可用性 |
5.📊 进度MCP——机载跟踪器 *新*
| 工具 | 说明 |
|---|---|
get_progress_dashboard | 统计数据和成就的视觉进度 |
complete_task | 标记已完成的任务——可能会解锁成就! 🏆 |
get_next_tasks | 获取前3个推荐的下一步行动 |
get_leaderboard | 比较所有新员工的进度 |
______________________________________________________________________
🔐 安全功能(Archestra集成)
| 功能 | 实现 |
|---|---|
| ✅ 需要批准 | run_setup_command 和 send_welcome_message 需要明确的用户批准 |
| ✅ 双LLM隔离 | 工具输出通过安全子代理进行处理 |
| ✅ 安全命令白名单 | 只有预先批准的命令才能在未经批准的情况下运行 |
| ✅ 成本优化 | 智能路由——查找模型便宜,合成模型昂贵 |
| ✅ 完全可观察性 | 跟踪工具使用情况、热门文档、常见问题、完成率 |
______________________________________________________________________
🚀 快速开始
先决条件
- Docker 桌面版
- Node.js 18+
- GitHub个人访问令牌(创建一个)
选项1:Docker Compose(推荐)
# Clone the repo
git clone https://github.com/spidy29/archestra-ai-mcp-hackathon.git
cd archestra-ai-mcp-hackathon
# Set up environment
cp .env.example .env
# Edit .env and add your GITHUB_TOKEN
# Start everything
docker-compose up -d
# Access UI at http://localhost:3000选项2:手动设置
# 1. Start Archestra Platform
docker pull archestra/platform:latest
docker run -d --name archestra \
-p 9000:9000 -p 3000:3000 \
-e ARCHESTRA_QUICKSTART=true \
-v /var/run/docker.sock:/var/run/docker.sock \
archestra/platform
# 2. Install all MCP server dependencies
cd mcp-servers/github-mcp && npm install && cd ../..
cd mcp-servers/docs-mcp && npm install && cd ../..
cd mcp-servers/terminal-mcp && npm install && cd ../..
cd mcp-servers/slack-mcp && npm install && cd ../..
cd mcp-servers/progress-mcp && npm install && cd ../..
# 3. Test all servers
node test-servers.js______________________________________________________________________
📁 项目结构
archestra-hackathon/
├── agent-config/
│ └── agent.json # 🤖 Agent personality & MCP config
├── mcp-servers/
│ ├── github-mcp/ # 📂 Codebase understanding (5 tools)
│ ├── docs-mcp/ # 📖 Documentation search (4 tools)
│ ├── terminal-mcp/ # 🖥️ Environment setup (5 tools)
│ ├── slack-mcp/ # 💬 Team integration (5 tools)
│ └── progress-mcp/ # 📊 Progress tracking (4 tools)
├── docker-compose.yml # 🐳 One-command setup
├── test-servers.js # ✅ Server verification
├── .env.example # 🔑 Environment template
└── README.md # 📄 You are here!______________________________________________________________________
🎬 演示场景
👤 User: "I just joined the team. How do I get started?"
🤖 OnboardingOS:
→ Checks dev environment ✅ Node 18, Git, Docker found
→ Shows onboarding checklist 📋 4 phases, 17 tasks
→ Explains repo structure 📁 React + Node.js monorepo
→ Suggests who to contact 👥 @alice (Frontend), @bob (Backend)
→ Creates progress dashboard 📊 [░░░░░░░░░░░░░░░░░░░░] 0%
👤 User: "I've cloned the repo and installed deps"
🤖 OnboardingOS:
→ Marks tasks complete ✅ 2 tasks done!
→ Unlocks achievement 🌱 Quick Starter!
→ Shows next steps 📋 "Set up .env file next"
→ Progress update 📊 [██████░░░░░░░░░░░░░░] 12%______________________________________________________________________
📊 可观察性度量
OnboardingOS通过Archestra的可观察性跟踪这些指标:
- 每次会话使用的工具 --哪些工具最有价值?
- 搜索最多的文档 --哪些文档需要改进?
- 常见设置问题 --什么东西最常坏?
- 专家查找主题 --存在哪些知识差距?
- 入职完成率 --开发人员的增长速度有多快?
______________________________________________________________________
🏁 专为
2 Fast 2 MCP — Online Hackathon by WeMakeDevs
Powered by Archestra • MCP-based Agent Orchestration
Speed Racer Category (Solo) 🏎️
______________________________________________________________________
📄 许可证
MIT许可证
