如何给DevoxxGenie装上随叫随到的技能SKILL.md便携技能文件教程【免费下载链接】DevoxxGenieIDEAPluginDevoxxGenie is an agentic plugin for IntelliJ IDEA that uses local LLMs (Ollama, LMStudio, GPT4All, Jan and Llama.cpp) and Cloud based LLMs to help review, test, explain your project code. Latest version now also supports Spec Driven Development with CLI Runners.项目地址: https://gitcode.com/gh_mirrors/de/DevoxxGenieIDEAPluginDevoxxGenie 是一款面向 IntelliJ IDEA 的智能体插件支持本地 LLMOllama、LM Studio、GPT4All 等与云端模型来审查、测试和解释你的项目代码。而SKILL.md 便携技能文件是它最有趣的扩展机制之一只需一个 Markdown 文件就能给 AI 助手装上随叫随到的可复用技能——重构流程、代码审查清单、提交规范……模型会在对话中自己判断并激活无需你敲任何命令。本文带你从零开始用 10 分钟上手这套技能系统 ✨ 什么是 SKILL.md 技能文件LLM 自己点单的技能库技能Skills是存放在磁盘上的自描述能力文件。每次发起对话时DevoxxGenie 会扫描技能目录把每个技能的「名称 → 一句话描述」索引注入系统提示词当模型认为某个技能与你的请求相关时就会主动调用activate_skill工具把该技能的完整正文拉进对话然后按里面的步骤执行。这和斜杠命令Commands完全不同Commands 是你打的字Skills 是模型自己选的。而且 SKILL.md 文件与 Claude Code、Codex、Gemini 等工具共用同一套目录约定——一份文件多个 AI 助手通用这就是便携的含义。✅ 两个前置条件Agent Mode 与工具调用模型技能以工具调用的形式交付因此必须满足两个条件见 docusaurus/docs/features/skills.md开启 Agent Mode进入Settings → Tools → DevoxxGenie → Agent勾选Enable Agent Mode。关闭时activate_skill工具不会暴露给模型技能完全沉睡。选择支持工具调用的模型主流云端模型GPT-4o/4.1、Claude 3.5、Gemini 1.5、Mistral、Grok 等都可以本地模型请选择明确支持 tool use 的如 Qwen2.5-Coder、Llama 3.1、GLM-4。更多内置工具说明见 docusaurus/docs/features/agent-mode.md。 SKILL.md 文件长什么样两行元数据 一份 Markdown每个技能 一个独立目录 目录根下的 SKILL.md 文件技能名/ └── SKILL.md文件由 YAML 元数据头 Markdown 正文组成最简示例一个重构助手技能--- name: refactor-helper description: Guides a safe, step-by-step refactoring workflow with tests --- # Refactor Helper 当用户要求重构时 1. 读取目标文件及其引用。 2. 先把重构方案以 diff 形式勾勒出来再动手。 3. 每一步之后运行项目测试。 4. 一旦有测试失败立即停下并报告。字段必填说明name是LLM 调用activate_skill时使用的唯一标识应与目录名一致description是展示给模型的一句话摘要请写得具体、面向动作正文可以是任意 Markdown——步骤清单、示例、或指向同目录资源文件的引用模型的read_file工具可以按需读取。 技能文件放哪里6 个目录与优先级规则DevoxxGenie 会扫描6 个目录按优先级从低到高排列同名时高优先级者胜出优先级目录作用域1最低~/.agents/skills/name/用户级与.agents系工具共享2~/.claude/skills/name/用户级与 Claude Code 共享3~/.devoxxgenie/skills/name/用户级DevoxxGenie 专用4project/.agents/skills/name/项目级与.agents系工具共享5project/.claude/skills/name/项目级与 Claude Code 共享6最高project/.devoxxgenie/skills/name/项目级DevoxxGenie 专用两条冲突裁决规则很好记项目级压过用户级项目里的技能覆盖你主目录下的同名技能。.devoxxgenie压过.claude.claude压过.agents。这个分层设计非常实用把常用技能库放在~/.claude/skills/全局复用再用项目里的.devoxxgenie/skills/针对单个项目做特供版覆盖。目录的加载与合并逻辑实现于 SkillRegistry.java。 最快上手三步创建你的第一个技能打开技能目录进入Settings → Tools → DevoxxGenie → Skills在Open Skills Folder下拉框中选择project (.devoxxgenie)并点击按钮——文件管理器会直接打开project/.devoxxgenie/skills/目录不存在会自动创建这是写新技能最快的入口。新建技能在打开的目录旁新建commit-message-writer/目录放入如下SKILL.md--- name: commit-message-writer description: Writes a Conventional Commits message based on the current staged diff --- 当用户要求生成提交信息时 - 运行 git diff --cached 读取暂存变更。 - 用 Conventional Commits 格式 type(scope): subject 概括。 - 正文解释为什么而不是做了什么。 - 主题行不超过 72 个字符。重载并验证回到设置页点击Reload无需重启 IDE新技能会出现在列表中。然后在聊天面板开启 Agent Mode随口问一句帮我给暂存的改动写个提交信息——模型会自动调用activate_skill(commit-message-writer)并严格按你写的规则执行全程无需你输入任何特殊指令 ⚙️ 技能管理面板启用、禁用与一键重载设置页SkillsSettingsComponent.java提供了一整套管理能力技能表格列出 6 个目录中检测到的所有技能含Enabled启用、Source来源如project (.claude)、Name、Description四列。Open Skills Folder下拉框 按钮任选 6 个目录之一一键在文件管理器中打开。Reload按钮不重启 IDE 即可重新扫描全部目录在外部编辑器改完 SKILL.md 后点它最方便。Enabled 复选框取消勾选 文件保留在磁盘上但对该 LLM 隐藏禁用状态在 IDE 重启后依然记忆。 小技巧禁用而不是删除——实验阶段建议直接取消勾选而不是删文件随时可恢复。同名技能被高优先级源覆盖时被跳过的版本会在 IDE 日志中留下警告。⚖️ Commands 与 Skills 怎么选一张表看懂两者的分工详见 docusaurus/docs/features/commands.mdCommands斜杠命令Skills技能文件谁触发你输入/name argsLLM 调用activate_skill(name)时机请求发出前的文本替换对话中由模型驱动需要 Agent Mode否是存储位置IDE 设置XML磁盘上的 SKILL.md 文件可移植性仅 DevoxxGenie与 Claude Code、Codex、Gemini 共享适合场景高频重复的提示词模板可复用的智能体工作流与行为规范简单记法/explain、/test这类你主动触发的日常操作用 Commands代码审查清单、框架配方、部署手册、团队提交规范这类希望模型自己想到的行为做成 Skills。 让技能更好用的 5 个技巧像写工具说明一样写 description——模型只凭这一行字决定用不用Guides a safe refactor workflow 远胜 Refactoring stuff。正文保持可执行——编号清单、步骤剧本模型最喜欢照着一步步走。携带伴生资源文件——技能目录里可放checklist.md、template.json等并在正文中提示模型去读read_file工具会按需取回。团队配方放项目级——把project/.devoxxgenie/skills/提交进代码库每位装了 DevoxxGenie 的同事自动获得一致的 AI 行为。善用分层覆盖——公共技能放~/.claude/skills/全局复用个别项目用项目级目录做特供版。 小结SKILL.md 便携技能文件让 DevoxxGenie 从听话的助手进化为会自己翻工具箱的工程师一个 Markdown 文件跨工具通用模型自动激活。今天就把你的第一条工作流写成技能吧——下次重构、审查、写提交信息时AI 会主动随叫随到地按你的规矩办事。想深入了解技能系统的底层实现可以阅读 SkillRegistryTest.java 中的测试用例与官方博客文章 docusaurus/blog/2026-05-18-commands-and-skills.md。【免费下载链接】DevoxxGenieIDEAPluginDevoxxGenie is an agentic plugin for IntelliJ IDEA that uses local LLMs (Ollama, LMStudio, GPT4All, Jan and Llama.cpp) and Cloud based LLMs to help review, test, explain your project code. Latest version now also supports Spec Driven Development with CLI Runners.项目地址: https://gitcode.com/gh_mirrors/de/DevoxxGenieIDEAPlugin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考