get_template_list
Retrieve available development record templates with names and descriptions to identify templates for detailed content access.
Instructions
获取可用的开发记录模板列表。返回包含模板名称、文件名和描述的结构化数据。返回的 templates 数组中每个模板都有 templateName 字段，这是后续调用 get_template_detail 时必需的参数。使用此工具来发现可用的模板，然后使用返回的 templateName 来获取具体模板内容。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dummy | No | Dummy parameter for no-parameter tools |
Implementation Reference
- src/index.ts:110-163 (handler)Main execution logic for the get_template_list tool: validates input, reads template directory, filters .md files, constructs list with templateName, filename, and description, returns structured JSON response.case "get_template_list": { const parsed = GetTemplateListSchema.safeParse(args); if (!parsed.success) { throw new Error(`Invalid arguments for get_template_list: ${parsed.error}`); } try { const templateDir = getTemplateDir(); const files = await readdir(templateDir); // 过滤出 .md 文件并构建模板信息 const templates = files .filter((file: string) => extname(file) === ".md") .map((file: string) => { const templateName = basename(file, ".md"); return { templateName, filename: file, description: getTemplateDescription(templateName) }; }); // 返回标准化格式，便于AI识别和使用 return { content: [ { type: "text", text: JSON.stringify({ success: true, templates, count: templates.length, message: `Found ${templates.length} available templates`, usage: "Use the 'templateName' field from any template to call get_template_detail" }, null, 2) } ] }; } catch (error) { const errorMessage = error instanceof Error ? error.message : String(error); return { content: [ { type: "text", text: JSON.stringify({ success: false, error: `Failed to get template list: ${errorMessage}`, templates: [] }, null, 2) } ], isError: true, }; } }
- src/index.ts:22-24 (schema)Zod input schema for get_template_list tool, allowing optional dummy parameter since it's a no-arg tool.const GetTemplateListSchema = z.object({ dummy: z.string().optional().describe("Dummy parameter for no-parameter tools") });
- src/index.ts:85-91 (registration)Tool registration in listTools handler, defining name, detailed description, and input schema.name: "get_template_list", description: "获取可用的开发记录模板列表。返回包含模板名称、文件名和描述的结构化数据。" + "返回的 templates 数组中每个模板都有 templateName 字段，这是后续调用 get_template_detail 时必需的参数。" + "使用此工具来发现可用的模板，然后使用返回的 templateName 来获取具体模板内容。", inputSchema: zodToJsonSchema(GetTemplateListSchema) as ToolInput, },
- src/index.ts:34-38 (helper)Helper function to resolve the path to the template directory, handling build vs src contexts.function getTemplateDir(): string { // 如果在build目录中运行，需要回到上级目录找src/template const srcDir = __dirname.includes('build') ? join(__dirname, '..', 'src') : __dirname; return join(srcDir, "template"); }
- src/index.ts:56-65 (helper)Helper function providing human-readable descriptions for each template by name.function getTemplateDescription(templateName: string): string { const descriptions: Record<string, string> = { "meeting-record": "会议记录模板 - 用于记录会议内容、决策和行动项", "project-summary": "项目总结模板 - 用于总结项目进展、问题和计划", "learning-notes": "学习笔记模板 - 用于记录学习内容和心得体会", "daily-standup": "每日站会模板 - 用于记录团队每日站会内容" }; return descriptions[templateName] || "通用记录模板"; }