我的自定义Agent【免费下载链接】witty-opencodeAI agent client built on top of OpenCode, including the TUI frontend, agent backend, and SDK.项目地址: https://gitcode.com/openeuler/witty-opencode前往项目官网免费下载https://ar.openeuler.org/ar/我是一个专门处理系统管理的AI助手。能力范围系统监控和日志分析软件包管理建议性能优化建议行为准则优先使用本地安装的资源修改系统配置前先解释影响### 步骤2编写配置片段 创建配置文件/usr/share/witty/opencode/config.d/my-package.jsonjson { agent: { mycompany/system-helper: { description: 系统管理专用助手, mode: subagent, prompt: {file:../agents/my-package/prompt.md}, color: #4CAF50 } }, command: { sys-check: { description: 执行系统健康检查, agent: mycompany/system-helper } } }步骤3验证配置语法使用配置生成器进行验证/usr/libexec/witty-opencode/rebuild-managed-config.mjs --dry-run⚠️ 配置命名冲突保护witty-opencode内置了命名冲突检测机制防止不同包之间的配置冲突受保护的命名空间agentAgent名称不能重复command命令名称不能重复mode运行模式名称不能重复mcpMCP服务器名称不能重复命名最佳实践✅推荐使用前缀确保唯一性vendor/feature-nameteam:tool-name❌避免使用通用名称helperanalyzerdefault 配置合并工作原理当多个配置片段存在时witty-opencode按以下规则合并1. 文件扫描顺序配置生成器按字母顺序扫描config.d/目录下的所有.json文件。2. 合并策略对象合并深层合并相同键的值会合并数组去重重复的数组元素会被自动去重冲突检测关键命名空间冲突会导致生成失败3. 最终输出合并后的配置包含所有片段的agent定义所有片段的mcp配置固定的skills路径指向解析后的绝对路径 RPM打包最佳实践纯数据包规范对于大多数子包推荐使用纯数据包模式# 不包含任何脚本 %install mkdir -p %{buildroot}/usr/share/witty/opencode/config.d install -m 644 my-config.json %{buildroot}/usr/share/witty/opencode/config.d/ mkdir -p %{buildroot}/usr/share/witty/opencode/agents/my-package install -m 644 prompt.md %{buildroot}/usr/share/witty/opencode/agents/my-package/依赖关系Requires: witty-opencode-base # 可选如果包需要OpenCode CLI Requires: opencode 常见问题与解决方案问题1配置未生效检查步骤确认文件在正确位置/usr/share/witty/opencode/config.d/检查文件权限确保可读验证JSON语法使用jq . your-file.json查看日志journalctl -u witty-opencode问题2路径解析错误解决方案使用相对路径{file:../agents/name/file.md}避免绝对路径硬编码确保引用的文件存在问题3配置冲突处理方法重命名冲突的agent或command使用唯一前缀联系其他包维护者协调命名 高级配置技巧技巧1条件配置通过环境变量控制配置{ agent: { dev/debug: { enabled: {env:DEBUG_MODE,false}, prompt: {file:../agents/debug/prompt.md} } } }技巧2多环境配置为不同环境创建配置片段config.d/myapp-prod.json- 生产环境config.d/myapp-dev.json- 开发环境config.d/myapp-test.json- 测试环境技巧3配置片段模板创建可复用的配置模板{ agent: { {{AGENT_NAME}}: { description: {{DESCRIPTION}}, mode: subagent, prompt: {file:../agents/{{AGENT_DIR}}/prompt.md}, color: {{COLOR}} } } } 配置管理工具推荐1. 配置验证工具使用内置工具验证配置# 检查配置语法 opencode config validate # 查看当前配置 opencode config show2. 配置备份策略建议定期备份配置# 备份配置 cp /etc/opencode/opencode.json /backup/opencode-config-$(date %Y%m%d).json # 恢复配置 cp /backup/opencode-config-20250101.json /etc/opencode/opencode.json 调试与监控实时监控配置变更# 监控配置目录变化 inotifywait -m /usr/share/witty/opencode/config.d/ # 查看配置生成日志 tail -f /var/log/witty-opencode/config.log配置状态检查# 检查配置片段数量 ls -la /usr/share/witty/opencode/config.d/*.json | wc -l # 检查最终配置大小 ls -lh /etc/opencode/opencode.json【免费下载链接】witty-opencodeAI agent client built on top of OpenCode, including the TUI frontend, agent backend, and SDK.项目地址: https://gitcode.com/openeuler/witty-opencode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考