openEuler agent-skills开发者指南：如何扩展自定义技能

【免费下载链接】agent-skillsAgent skills made by openEuler community to provide a smooth vibe coding experience for developers.项目地址: https://gitcode.com/openeuler/agent-skills

前往项目官网免费下载：https://ar.openeuler.org/ar/

openEuler agent-skills是由openEuler社区开发的技能集合，旨在为开发者提供流畅的编码体验。本文将详细介绍如何为该项目扩展自定义技能，帮助开发者快速上手并贡献自己的创意。

了解agent-skills项目结构

在开始扩展自定义技能之前，首先需要了解agent-skills项目的基本结构。项目主要分为cve-fix-skill和import-pkg两大模块，每个模块下包含多个子技能。

• cve-fix-skill：包含与CVE漏洞修复相关的技能，如cve-init、cve-match、cve-search等
• import-pkg：包含与软件包导入相关的技能，如import-package、pkg-introduce、review-rpm等

每个技能通常包含一个SKILL.md文件和相关的脚本目录，SKILL.md文件定义了技能的核心行为准则、编排流程和上下文传递规则。

自定义技能开发的核心步骤

步骤1：创建技能目录结构

首先，在项目中创建一个新的技能目录。建议按照现有技能的命名规范，如your-skill-name，并在目录下创建SKILL.md文件和scripts目录。

your-skill-name/ ├── SKILL.md └── scripts/ ├── script1.py └── script2.sh

步骤2：编写SKILL.md文件

SKILL.md是技能的核心定义文件，需要包含以下关键部分：

技能元数据

在文件开头，定义技能的名称和描述：

--- name: your-skill-name description: 简要描述你的技能功能和用途 ---

核心行为准则

明确技能的行为规范和限制条件，例如：

• 禁止内置Fetch：当需要获取外部资源时，必须使用指定的脚本
• 全自主执行：是否允许自动运行相关脚本，无需用户确认
• 环境补全：如何处理缺失的依赖工具

编排流程

定义技能的执行流程，可以使用流程图形式展示：

用户输入 │ ▼ 步骤1 ──→ 处理逻辑 │ ▼ 步骤2 ──→ 处理逻辑 │ ▼ 输出结果

步骤3：开发技能脚本

根据SKILL.md中定义的流程，在scripts目录下开发相关的脚本文件。脚本可以使用Python、Shell等语言编写，具体取决于技能的需求。

例如，一个Python脚本可能包含以下结构：

def main(): # 读取输入参数 # 执行核心逻辑 # 输出结果 return 0 if __name__ == "__main__": main()

步骤4：定义上下文传递规则

在SKILL.md中明确技能的输入输出格式，以及与其他技能之间的上下文传递规则。例如：

## 上下文传递规则 - 输入：需要包含参数A、参数B - 输出：返回包含结果C、状态D的JSON对象 - 错误处理：当遇到X情况时，返回错误码Y

步骤5：测试技能

开发完成后，需要对技能进行充分测试。可以参考现有技能的测试方法，编写测试用例，确保技能能够正常工作。

技能集成与调用

技能注册

将自定义技能注册到agent-skills系统中，以便其他技能或用户能够调用它。具体注册方法可以参考现有技能的注册方式。

技能调用

在其他技能中调用你的自定义技能，需要遵循以下步骤：

1. 准备输入参数
2. 调用技能
3. 处理返回结果

例如，在另一个技能的脚本中调用你的技能：

import subprocess def call_your_skill(param1, param2): result = subprocess.run( ["python3", "path/to/your/skill/script.py", param1, param2], capture_output=True, text=True ) return result.stdout

示例：创建一个简单的版本检查技能

下面以创建一个简单的版本检查技能为例，演示自定义技能的开发过程。

1. 创建目录结构

version-check/ ├── SKILL.md └── scripts/ └── check_version.py

2. 编写SKILL.md

--- name: version-check description: 检查指定软件包的版本信息 --- # version-check 用于检查指定软件包的当前版本和最新版本。 ## 核心行为准则 - 输入必须包含软件包名称 - 优先从本地仓库获取版本信息，本地不存在时从远程仓库获取 ## 编排流程

用户输入包名 │ ▼ 检查本地仓库 ──→ 本地版本 │ ▼ 检查远程仓库 ──→ 远程版本 │ ▼ 比较版本并输出结果

## 输入输出格式 - 输入：包名（字符串） - 输出：JSON对象，包含本地版本、远程版本和是否需要更新 ## 脚本路径 scripts/check_version.py

3. 编写check_version.py脚本

import json import sys import subprocess def get_local_version(pkg_name): # 模拟从本地仓库获取版本 try: result = subprocess.run( ["rpm", "-q", pkg_name, "--queryformat", "%{VERSION}"], capture_output=True, text=True, check=True ) return result.stdout.strip() except subprocess.CalledProcessError: return None def get_remote_version(pkg_name): # 模拟从远程仓库获取版本 return "1.2.3" def main(): if len(sys.argv) != 2: print(json.dumps({"error": "请提供软件包名称"})) return 1 pkg_name = sys.argv[1] local_ver = get_local_version(pkg_name) remote_ver = get_remote_version(pkg_name) need_update = False if local_ver and remote_ver and local_ver < remote_ver: need_update = True result = { "package": pkg_name, "local_version": local_ver, "remote_version": remote_ver, "need_update": need_update } print(json.dumps(result)) return 0 if __name__ == "__main__": main()

技能开发最佳实践

代码规范

遵循项目现有的代码规范，保持代码风格一致。例如，Python代码可以使用pylint进行检查，Shell脚本可以使用shellcheck进行检查。

错误处理

确保技能具有完善的错误处理机制，能够优雅地处理各种异常情况，并返回清晰的错误信息。

文档完善

除了SKILL.md文件外，还可以为脚本添加详细的注释，方便其他开发者理解和维护你的技能。

性能优化

考虑技能的执行效率，避免不必要的资源消耗和延迟。例如，可以使用缓存机制减少重复的网络请求。

总结

通过本文的介绍，你应该已经了解了如何为openEuler agent-skills项目扩展自定义技能。从创建目录结构、编写SKILL.md文件，到开发脚本和测试技能，每个步骤都至关重要。希望你能够根据这些指导，开发出功能强大、易于使用的自定义技能，为openEuler社区贡献自己的力量！

如果你在开发过程中遇到任何问题，可以参考项目中的现有技能实现，或者向社区寻求帮助。祝你开发顺利！

【免费下载链接】agent-skillsAgent skills made by openEuler community to provide a smooth vibe coding experience for developers.项目地址: https://gitcode.com/openeuler/agent-skills