mcpField
C
create-tooluniverse-skill

create-tooluniverse-skill

github.com/mims-harvardAgent 工作流1.8k411 次安装2 天前更新
代码仓库

关于 create-tooluniverse-skill

create-tooluniverse-skill 是面向 ToolUniverse 维护者的技能，用分阶段流程指导新技能的分析、实现、测试、文档和打包。流程强调先验证工具，再编写实现与说明。

主要功能

  1. 01七阶段技能创建流程
  2. 02先发现并测试工具
  3. 03提供实现与测试模板
  4. 04验证文档和交付质量

适用场景

  1. 01为 ToolUniverse 新领域创建技能
  2. 02为技能实现补齐工具测试
  3. 03按检查清单验证并打包技能

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/mims-harvard/tooluniverse --skill create-tooluniverse-skill

安装后在 Claude Code 中输入/create-tooluniverse-skill确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

CODE_TEMPLATES.md
OPTIMIZE_INTEGRATION.md
PACKAGING_TEMPLATE.md
PARAMETER_VERIFICATION.md
QUICKSTART_TEMPLATE.md
SKILL_TEMPLATE.md
test_tools_template.py
TESTING_GUIDE.md
VALIDATION_CHECKLIST.md
assets/skill_template/
python_implementation.py
QUICK_START.md
test_skill.py
references/
devtu_optimize_integration.md
implementation_agnostic_format.md
skill_standards_checklist.md
tool_testing_workflow.md
scripts/
test_tools_template.py

详细介绍

创建 ToolUniverse 技能

用于创建可投入生产的 ToolUniverse 技能的系统化工作流。

此技能会移交给 devtu-* 技能，但这些技能已不在此仓库中。 devtu-optimize-skills、devtu-create-tool 和 devtu-fix-tool 已移至 tu-harness 插件 (tooluniverse/tooluniverse-harness)， 因为它们作用于此仓库，而不是供此仓库的用户调用。请使用 claude plugin install tu-harness@tooluniverse-harness 安装；下文按技能名称引用它们，因此安装该插件后即可解析。这项技能 也面向维护者——它不在面向用户的插件镜像中——应与这些技能放在一起；它尚未迁移，只是因为还没有任何因素促使我们考虑这个问题。

核心原则

以 devtu-optimize-skills 的 10 项支柱原则为基础：

  1. 先测试——绝不要记录未经测试的工具
  2. 验证工具契约——不要相信函数名称
  3. 处理 SOAP 工具——添加 operation 参数
  4. 文档与实现无关——SKILL.md 中不包含 Python/MCP 代码
  5. 先打好基础——在使用专用工具前先查询聚合工具
  6. 谨慎消除歧义——正确解析 ID
  7. 实现回退方案——主要方案 -> 回退方案 -> 默认方案
  8. 为证据分级——声明采用 T1-T4 级别
  9. 量化完整性——为各章节设定最低数值要求
  10. 综合分析——提供模型和假设，而不只是列表

有关每项原则的详细应用，请参阅 OPTIMIZE_INTEGRATION.md。

7 阶段工作流

阶段时长说明
1. 领域分析15 分钟了解用例、数据类型和分析阶段
2. 工具发现30-45 分钟搜索、阅读配置、测试工具（必须执行）
3. 工具创建0-60 分钟通过 devtu-create-tool 创建缺失的工具
4. 实现30-45 分钟使用经过测试的工具编写 python_implementation.py
5. 文档编写30-45 分钟编写 SKILL.md（与实现无关）和 QUICK_START.md
6. 验证15-30 分钟运行测试套件、检查清单并手动验证
7. 打包15 分钟创建摘要并更新跟踪信息

总计：约 1.5-2 小时（不包括创建工具）。

阶段 1：领域分析
  • 收集具体用例和预期输出
  • 确定输入、输出和中间数据类型
  • 将工作流拆分为逻辑阶段
  • 查看 skills/ 中的现有技能，了解其模式
阶段 2：工具发现与测试

在 /src/tooluniverse/data/*.json 中搜索工具（共 186 个工具文件）。阅读每个工具的配置，了解其参数和返回架构。常见问题请参阅 PARAMETER_VERIFICATION.md。

使用 test_tools_template.py 创建并运行测试脚本。针对每个工具：使用已知有效的参数调用，验证响应格式，并记录需要修正的内容。有关完整测试套件模板和操作流程，请参阅 TESTING_GUIDE.md。

阶段 3：工具创建（如有需要）

当缺少所需功能且分析受阻时，调用 devtu-create-tool。如果新工具测试失败，请使用 devtu-fix-tool。

阶段 4：实现

在 skills/tooluniverse-[domain]/ 中创建：

  • python_implementation.py - 仅使用经过测试的工具；每个阶段使用 try/except；逐步编写报告
  • test_skill.py - 测试每种输入类型、组合输入和错误处理

使用 CODE_TEMPLATES.md 中的模板。

阶段 5：文档编写

使用 SKILL_TEMPLATE.md 编写与实现无关的 SKILL.md。使用 QUICKSTART_TEMPLATE.md 编写支持多种实现的 QUICK_START.md。关键规则：SKILL.md 中不得包含 Python/MCP 代码；QUICK_START 中应同等介绍两种接口。

有关格式指南和示例，请参阅 IMPLEMENTATION_AGNOSTIC.md。

阶段 6：验证

运行全面的测试套件（参见 TESTING_GUIDE.md）。按照 VALIDATION_CHECKLIST.md 进行验证。手动验证：全新加载 ToolUniverse，复制并粘贴 QUICK_START 示例，并确认输出正常。

阶段 7：打包

使用 PACKAGING_TEMPLATE.md 创建摘要文档。若创建多个技能，请更新会话跟踪。

技能集成

技能使用时机
devtu-create-tool缺少关键功能
devtu-fix-tool工具返回错误或格式异常
devtu-optimize-skills证据评级、报告优化

质量指标

高质量：编写文档前测试覆盖率达到 100%、SKILL.md 与实现无关、QUICK_START 支持多种实现、提供回退策略、参数修正表、响应格式文档。

警示信号：先写文档再测试、SKILL.md 中包含 Python、假设参数存在、没有回退方案、SOAP 工具缺少 operation、没有测试脚本。

参考文件

文件内容
SKILL_TEMPLATE.md编写 SKILL.md 的模板
QUICKSTART_TEMPLATE.md编写 QUICK_START.md 的模板
TESTING_GUIDE.md测试套件模板和流程
VALIDATION_CHECKLIST.md发布前质量检查清单
PACKAGING_TEMPLATE.md摘要文档模板
PARAMETER_VERIFICATION.md工具参数验证指南
OPTIMIZE_INTEGRATION.mddevtu-optimize-skills 十大支柱集成指南
IMPLEMENTATION_AGNOSTIC.md与实现无关的格式指南及示例
CODE_TEMPLATES.mdPython 实现和测试模板
test_tools_template.py工具测试脚本模板

评论

支持 Markdown