template-skill

template-skill 是为旨在扩展 Mini-Agent 生态系统功能的开发者提供的基础样板。此模板专为工程师与系统集成人员设计，提供了创建模块化、可重复且专业化代理行为所需的结构化框架。通过遵循此模板，开发者可以确保其自定义工具符合 Mini-Agent 框架的架构标准，从而促进 LLM 与本地环境之间的无缝交互。

• 通过 SKILL.md 接口进行指令与元数据的标准化结构设计。

• 具备将复杂逻辑、Shell 命令或外部 API 调用封装成单一可调用技能的能力。

• 支持与 MiniMax M2.5 模型兼容的交错思考与推理模式。

• 准备好与使用 uv 包管理的标准 Python 环境进行集成。

• 一致的设计允许代理根据用户请求动态加载与卸载专业功能。

• 当您需要自动化重复性的开发工作流程或创建专业的数据处理管道时，请使用此模板。

• 请确保您的实现能在相关的 SKILL.md 文件中包含明确的指令，以引导模型的工具选择过程。

• 对函数参数使用描述性的命名约定，以提高代理正确解释任务需求的能力。

• 输入通常涉及特定于任务的参数（例如文件路径、配置设置），而输出则结构化为供代理处理的 ToolResult 对象。

• 将逻辑保持在技能目录内，以维持仓库整洁，并促进与框架现有测试套件的模块化测试。

• 通过内置的日志系统监控工具执行情况，以调试代理的推理步骤并识别任务执行循环中的潜在瓶颈。