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系统中以便其他技能或用户能够调用它。具体注册方法可以参考现有技能的注册方式。技能调用在其他技能中调用你的自定义技能需要遵循以下步骤准备输入参数调用技能处理返回结果例如在另一个技能的脚本中调用你的技能import subprocess def call_your_skill(param1, param2): result subprocess.run( [python3, path/to/your/skill/script.py, param1, param2], capture_outputTrue, textTrue ) return result.stdout示例创建一个简单的版本检查技能下面以创建一个简单的版本检查技能为例演示自定义技能的开发过程。1. 创建目录结构version-check/ ├── SKILL.md └── scripts/ └── check_version.py2. 编写SKILL.md--- name: version-check description: 检查指定软件包的版本信息 --- # version-check 用于检查指定软件包的当前版本和最新版本。 ## 核心行为准则 - 输入必须包含软件包名称 - 优先从本地仓库获取版本信息本地不存在时从远程仓库获取 ## 编排流程用户输入包名 │ ▼ 检查本地仓库 ──→ 本地版本 │ ▼ 检查远程仓库 ──→ 远程版本 │ ▼ 比较版本并输出结果## 输入输出格式 - 输入包名字符串 - 输出JSON对象包含本地版本、远程版本和是否需要更新 ## 脚本路径 scripts/check_version.py3. 编写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_outputTrue, textTrue, checkTrue ) 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考