import { parseArgs, getString } from "../utils/parseArgs.js";
/**
* start_onboard 智能编排工具
*
* 场景：快速上手项目
* 编排：analyze_project → init_project_context
*/
const PROMPT_TEMPLATE = `# 📚 快速上手编排指南
## 🎯 目标
快速了解并上手当前项目
---
## 🔍 步骤 1: 项目分析
**调用工具**: \`analyze_project\`
**参数**:
\`\`\`json
{
"project_path": "{project_path}",
"max_depth": 5,
"include_content": true
}
\`\`\`
**分析内容**:
- 项目结构
- 技术栈识别
- 入口文件
- 核心模块
- 依赖关系
**产出**: 项目分析报告
---
## 📝 步骤 2: 生成项目上下文
**调用工具**: \`init_project_context\`
**参数**:
\`\`\`json
{
"docs_dir": "{docs_dir}"
}
\`\`\`
**生成内容**:
- 技术栈文档
- 架构说明
- 编码规范
- 开发指南
**产出**: \`{docs_dir}/project-context.md\`
---
## ✅ 完成检查
- [ ] 项目结构已分析
- [ ] 技术栈已识别
- [ ] 项目上下文已生成
- [ ] 文档已保存
---
## 📊 输出汇总
完成后，向用户提供：
### 1. 项目概览
| 项目 | 内容 |
|------|------|
| 项目名称 | [名称] |
| 项目类型 | [前端/后端/全栈/库] |
| 主要语言 | [语言] |
| 框架 | [框架] |
### 2. 技术栈
| 类别 | 技术 |
|------|------|
| 语言 | [语言列表] |
| 框架 | [框架列表] |
| 构建工具 | [工具列表] |
| 测试框架 | [框架列表] |
### 3. 项目结构
\`\`\`
[目录树]
\`\`\`
### 4. 核心文件
| 文件 | 用途 |
|------|------|
| [文件1] | [用途] |
| [文件2] | [用途] |
### 5. 快速开始
\`\`\`bash
# 安装依赖
[安装命令]
# 启动开发
[启动命令]
# 运行测试
[测试命令]
\`\`\`
### 6. 下一步建议
1. 阅读 \`{docs_dir}/project-context.md\` 了解详细信息
2. 查看 README.md 了解项目背景
3. 运行项目熟悉功能
4. 阅读核心模块代码
---
*编排工具: MCP Probe Kit - start_onboard*
`;
export async function startOnboard(args: any) {
try {
// 智能参数解析，支持自然语言输入
const parsedArgs = parseArgs<{
project_path?: string;
docs_dir?: string;
}>(args, {
defaultValues: {
project_path: ".",
docs_dir: "docs",
},
primaryField: "project_path", // 纯文本输入默认映射到 project_path 字段
fieldAliases: {
project_path: ["path", "dir", "directory", "路径", "项目路径"],
docs_dir: ["docs", "output", "目录", "文档目录"],
},
});
const projectPath = getString(parsedArgs.project_path) || ".";
const docsDir = getString(parsedArgs.docs_dir) || "docs";
const guide = PROMPT_TEMPLATE
.replace(/{project_path}/g, projectPath)
.replace(/{docs_dir}/g, docsDir);
return {
content: [{ type: "text", text: guide }],
};
} catch (error) {
const errorMsg = error instanceof Error ? error.message : String(error);
return {
content: [{ type: "text", text: `❌ 编排执行失败: ${errorMsg}` }],
isError: true,
};
}
}
