写自定义技能五步向导——从 SKILL.md 到可用的技能包

五步写一个自定义技能

不想用技能市场里的现成技能，想自己造一个？MateClaw 控制台里的技能编辑器提供五步向导：

第一步：选模板或从零开始

八个起步模板：内容创作、代码 review、数据分析、研究简报、文档整理、会议纪要整理、翻译、自动化脚本。选一个、改名字和描述，或者直接选空白模板。

第二步：写 SKILL.md 的 prompt

这是技能的核心——一段 Agent 执行这个技能时注入的 prompt。技巧：

• 用 {{参数名}} 标记用户输入的位置（比如 {{topic}} 会被用户输入的研究主题替换）
• 明确输出格式（Markdown 列表、JSON、表格……）
• 告诉 Agent 不要做什么（比如「只搜最近 30 天的结果」）

第三步：选工具依赖

这个技能执行时需要哪些底层工具？从已安装的工具（内置 + MCP）里勾选。比如「代码 review」技能需要 shell、文件读写、git 工具。

第四步：声明参数

技能接受哪些用户输入？每个参数有名字、类型（string / number / boolean / enum）、是否必填。这些参数会在 Agent 调用技能时展示为表单。

第五步：跑 Preflight 测试

技能编辑器里有一个「测试」按钮——给一个参数值，实际跑一遍这个技能。看 Agent 的执行过程、工具调用、最终输出。不满意就回去改 prompt 或工具依赖。

测试通过后保存，技能就装到你的工作空间里了。

安装前的 Preflight 检查

在把技能安装到别的工作空间之前，MateClaw 会自动跑一轮 Preflight：

• 依赖的工具在目标工作空间里有没有装？
• 需要的 MCP Server 是不是已连接？
• 参数声明和模板里的占位符对不对得上？

有问题就列出来让你先修，没问题才允许安装。