菜单
Guide for creating new Agent Skills in the Koish (wakame) project. Use this skill when asked to create, add, or scaffold a new agent skill, or when the task involves writing SKILL.md files, organizing skill directories, or setting up specialized Copilot instructions for this project.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Guide for writing pull request descriptions when adding or modifying MythicMobs Mechanic, Condition, ItemDrop, or Placeholder in the wakame-hook-mythicmobs module. Use this skill when creating PRs for the mythicmobs hook, or when asked to document MythicMobs integration changes, mechanic parameters, condition parameters, drops, or placeholders.
Guide for migrating code from wakame-mixin to wakame-plugin in the Koish (wakame) project. Use this skill when asked to move, migrate, or relocate source files or directories from the wakame-mixin module to the wakame-plugin module, when the task involves creating bridge interfaces for mixin code, resolving cross-module dependencies between mixin and plugin, or refactoring classloader-boundary-crossing code.
Guide for reading, writing, and organizing configuration files in the Koish (wakame) project using SpongePowered Configurate and the project's lazyconfig wrapper. Use this skill when asked to create, modify, or read configuration files, add new config entries, define @ConfigSerializable data classes, use ConfigAccess / MAIN_CONFIG / FEATURE_CONFIG / entryOrElse / optionalEntry, write custom TypeSerializers, or load config folders with yamlLoader.
Meta-skill for creating Agent Skills that document in-house modules, frameworks, or libraries in the Koish (wakame) project. Use this skill when asked to create a new skill that introduces, explains, or documents the usage, constraints, and patterns of a specific module or framework within this project (e.g., a skill like invui-gui that explains how to use a particular library/module). This skill guides the AI through project exploration, dependency analysis, and skill authoring.
Guide for creating GUI menus using InvUI2 in the Koish (wakame) project. Use this skill when asked to create, modify, or debug GUI/menu code, or when the task involves InvUI windows, guis, items, inventories, or any Minecraft inventory-based UI in the wakame-plugin module.
| name | create-skill |
| description | Guide for creating new Agent Skills in the Koish (wakame) project. Use this skill when asked to create, add, or scaffold a new agent skill, or when the task involves writing SKILL.md files, organizing skill directories, or setting up specialized Copilot instructions for this project. |
本技能指导你在 Koish (wakame) 项目中创建新的 Agent Skill。
Agent Skill 是一组指令、脚本和资源，Copilot 会在相关任务中自动加载它们，以提升在专业任务上的表现。
Agent Skill 是一个包含 SKILL.md 文件的目录。当 Copilot 判断用户的任务与某个 Skill 的 description 匹配时，会自动将该 Skill 的 SKILL.md 内容注入上下文，使 Copilot 能够遵循其中的指令。
Skill 与 Custom Instructions (如 copilot-instructions.md) 的区别:
本项目使用 project skills，所有 Skill 存放在:
.github/skills/<skill-name>/SKILL.md
当前已有的 Skill:
| 目录 | 用途 |
|---|---|
.github/skills/invui-gui/ | 使用 InvUI2 创建 GUI 菜单 |
.github/skills/configurate-config/ | 配置文件读取与编写 (Configurate + lazyconfig) |
.github/skills/create-skill/ | 创建新的 Agent Skill (本技能) |
.github/skills/create-module-skill/ | 创建模块/框架文档型 Skill (元技能) |
.github/skills/mixin-to-plugin-migration/ | 从 wakame-mixin 迁移代码到 wakame-plugin |
在 .github/skills/ 下创建一个新的子目录。目录名规则:
-) 分隔单词.github/skills/<skill-name>/
├── SKILL.md # 必须: Skill 指令文件
├── example.kt # 可选: 示例代码
└── helper-script.sh # 可选: 辅助脚本
SKILL.md 是一个带 YAML frontmatter 的 Markdown 文件。
---
name: <skill-name>
description: >
<Skill 的描述。说明 Skill 做什么，以及 Copilot 应在什么场景下使用它。>
---
| 字段 | 必须 | 说明 |
|---|---|---|
name | ✅ | Skill 的唯一标识符。全小写，用连字符分隔，通常与目录名一致。 |
description | ✅ | 描述 Skill 的用途和触发场景。Copilot 根据此描述判断是否加载该 Skill。 |
license | ❌ | 可选的许可证信息。 |
allowed-tools | ❌ | 可选。预授权 Skill 可使用的工具 (如 shell)，跳过确认提示。谨慎使用。 |
description 是 Copilot 判断是否加载 Skill 的唯一依据，必须写好:
好的示例:
description: >
Guide for creating GUI menus using InvUI2 in the Koish (wakame) project.
Use this skill when asked to create, modify, or debug GUI/menu code,
or when the task involves InvUI windows, guis, items, inventories,
or any Minecraft inventory-based UI in the wakame-plugin module.
不好的示例:
description: GUI stuff # 太模糊，缺少触发场景
正文是 Skill 的核心指令。遵循以下结构:
以下规范适用于本项目的所有 Skill:
name 和 description 用英文编写 (供 Copilot 匹配用)```kotlin 标注语言\n) 结尾## 1., ## 2., ...) 组织内容┌──┐、├──┤ 等）。Skill 是给 LLM 读的，字符画只会浪费 token。用编号列表或表格替代。| 场景 | 做法 |
|---|---|
| 某类任务需要详细的专业指令 (>50 行) | 创建新的 Skill |
| 简短的全局规则 (编码风格、命名约定) | 添加到 copilot-instructions.md |
| 项目架构级别的范式总结 | 添加到 AGENTS.md |
| 已有 Skill 覆盖的领域需要补充 | 更新现有 Skill 的 SKILL.md |
经验法则: 如果指令足够专业、足够长，只有在特定任务才需要用到，就应该做成 Skill。
假设要创建一个 "编写 ItemProp" 的 Skill:
.github/skills/item-prop/
└── SKILL.md
---
name: item-prop
description: >
Guide for creating new ItemProp data types in the Koish (wakame) project.
Use this skill when asked to create, register, or modify ItemProp types,
or when the task involves item properties, ItemPropTypes, or property
data classes in wakame-mixin.
---
# 创建新的 ItemProp
本技能指导你在 Koish (wakame) 项目中创建和注册新的 ItemProp 数据类型。
---
## 1. ItemProp 概述
`ItemProp` 是附加在物品类型上的静态数据，定义在 `wakame-mixin` 中。
每个 ItemProp 由一个 `@ConfigSerializable` data class 和一个注册在
`ItemPropTypes` 中的类型声明组成。
## 2. 创建步骤
### 2.1 定义数据类型
在 `wakame-mixin/src/main/kotlin/cc/mewcraft/wakame/item/property/impl/`
下创建 data class:
```kotlin
@ConfigSerializable
data class MyPropData(
val someValue: Int = 0,
val anotherValue: String = "default",
)
```
### 2.2 注册到 ItemPropTypes
在 `ItemPropTypes.kt` 中添加:
```kotlin
@JvmField
val MY_PROP: ItemPropType<MyPropData> = typeOf("my_prop") {
serializers {
register(MyCustomSerializer()) // 如需自定义序列化器
}
}
```
### 2.3 读取 ItemProp
```kotlin
val propValue = itemStack.getProp(ItemPropTypes.MY_PROP) ?: return
```
## 3. 注意事项
1. data class 属性用 camelCase，YAML 自动转 snake_case
2. 提供合理的默认值
3. 子目录按类别组织 (如 `weapon/`)
创建完成后，确认以下几点:
SKILL.md (大写，不可更改)name 和 descriptionname 与目录名一致description 包含 "Use this skill when..." 触发场景如果 Skill 需要运行脚本:
SKILL.md 正文中说明何时和如何运行脚本allowed-tools:---
name: my-skill
description: ...
allowed-tools: shell
---
警告: 只有在完全信任脚本内容时才使用
allowed-tools: shell。 预授权 shell 会跳过执行终端命令的确认步骤。
SKILL.md，Copilot 只识别这个文件名。description 判断是否加载 Skill，写不好会导致 Skill 永远不被触发。