mcpField
C
create-moviepilot-skill

create-moviepilot-skill

github.com/jxxghpAgent 工作流12.0k79 次安装今天更新
代码仓库

关于 create-moviepilot-skill

用于在 MoviePilot 仓库中创建或更新内置 Agent 技能的指南，涵盖目录约定、版本管理、实现流程和验证要求。

主要功能

  1. 01创建和更新内置技能
  2. 02仓库路径与命名规则
  3. 03版本和 frontmatter 指南
  4. 04分步实现流程
  5. 05完成前验证清单

适用场景

  1. 01添加 MoviePilot 内置技能
  2. 02修改现有技能以避免重复
  3. 03检查技能元数据和版本变更

安装

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

$npx skills add https://github.com/jxxghp/moviepilot --skill create-moviepilot-skill

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

详细介绍

创建 MoviePilot 技能

本技能将指导你在此代码仓库中创建或更新内置的 MoviePilot Agent 技能。

范围

对代码仓库中的内置技能使用此工作流：

  • 创建或更新 skills/<skill-id>/ 下的文件
  • 将技能作为 MoviePilot 代码仓库的一部分提交
  • 除非用户明确要求使用本地覆盖版本，而非内置技能，否则不要只将实现放在 config/agent/skills 中

MoviePilot 特定规则

  • 代码仓库根目录下的 skills/ 是内置技能的打包事实来源。
  • Agent 启动时，打包的技能会同步到 config/agent/skills。
  • 同步时是否覆盖取决于 SKILL.md 中的 version 字段。更新现有内置技能时，请递增 version，否则用户可能会继续使用较旧的副本。
  • 文件夹名称必须与 frontmatter 中的 name 相同。只能使用小写字母、数字和连字符。
  • 优先扩展现有技能，而不是创建功能重叠的重复技能。

工作流

步骤 1：了解请求
  • 判断用户想要新建技能，还是修改现有技能。
  • 提取目标任务、可能的触发短语、所需工具，以及是否需要辅助脚本。
  • 如果阅读请求和本地上下文后目标仍有歧义，请提出一个有针对性的澄清问题。否则，采用合理的默认方案继续。
步骤 2：先检查现有技能
  • 创建任何内容前，先检查代码仓库的 skills/ 目录。
  • 如果现有技能已经涵盖大部分工作流，请更新它，而不是添加一个近似重复项。
  • 沿用代码仓库的风格：简洁的 YAML frontmatter、包含丰富触发条件的描述，以及流程化的正文部分。
步骤 3：选择技能 ID 和路径
  • 新建内置技能的路径：skills/<skill-id>/SKILL.md
  • <skill-id> 应简短、采用连字符分隔，并且少于 64 个字符。
  • 使用以动词或领域开头、能清楚表明触发条件的名称，例如 transfer-failed-retry、moviepilot-api 或 create-moviepilot-skill。
步骤 4：正确编写 Frontmatter

使用以下格式：

---
name: create-moviepilot-skill
version: 1
description: >-
  Explain what the skill does and exactly when to use it.
allowed-tools: read_file write_file edit_file execute_command
---

规则：

  • description 是主要的触发入口。在其中说明具体的“何时使用”场景。
  • 内置技能必须包含 version。每次发布新的内置版本时都要递增该字段。
  • 如果工作流依赖一组数量少且定义明确的工具，请添加 allowed-tools。
  • 只有在环境限制确实重要时，才添加 compatibility。
步骤 5：编写正文

正文应包含：

  • 简短的用途说明
  • MoviePilot 特定规则或防护措施
  • 分步工作流
  • 与用户请求匹配的具体示例
  • 对现有辅助文件的引用

建议：

  • 使用祈使句
  • 提供具体文件路径
  • 使用符合 MoviePilot 实际惯例的示例

避免：

  • 不会影响执行的通用理论
  • 大量重复的文档内容
  • 在技能目录中添加 README.md 或 CHANGELOG.md 等额外文件
步骤 6：仅在有帮助时添加辅助文件
  • 只有在相同的确定性工作需要反复重写时，才添加 scripts/。
  • 将辅助文件放在同一技能目录中。
  • 在 SKILL.md 中明确引用辅助文件路径。
  • 如果技能仅包含指令，则只保留一个 SKILL.md 文件。
步骤 7：实现技能

对于新的内置技能：

  1. 创建 skills/<skill-id>/
  2. 创建 SKILL.md
  3. 仅在确有必要时添加辅助脚本

对于现有内置技能：

  1. 编辑 skills/<skill-id>/SKILL.md
  2. 递增 version
  3. 根据需要更新同一目录中的辅助文件
步骤 8：完成前进行验证
  • 重新阅读 frontmatter，并确认 name 与目录名称一致。
  • 确认 description 提到了真实的触发场景。
  • 如果修改了现有内置技能，确认 version 已递增。
  • 如果可能，验证 MoviePilot 技能加载器能否解析该文件。
  • 报告最终路径，并说明 Agent 是否需要重启，才能将最新的内置技能同步到 config/agent/skills。

最简示例

用户请求：

给 MoviePilot agent 加一个处理站点 Cookie 更新的内置技能

预期结果：

  • 创建或更新一个目录，例如 skills/update-site-cookie/
  • 编写 SKILL.md，其中包含明确的触发场景描述
  • 仅包含该工作流所需的工具
  • 修订现有内置技能时递增 version

最终检查清单

  • 技能是否位于仓库的 skills/ 目录下？
  • 文件夹名称是否与 frontmatter 中的 name 一致？
  • description 是否清楚说明了该技能应在何时触发？
  • 是否避免了不必要地重复创建现有技能？
  • 更新内置技能时，是否递增了 version？
  • 技能是否保持精简且以流程为主？

评论

支持 Markdown