perfux-opencode-plugin

为OpenCode提供研究代理与调试技能的增强插件。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:perfux-opencode-plugin。
它的用途是:为OpenCode提供研究代理与调试技能的增强插件。
完整的 Skill 内容见:https://321skill.com/skills/perfux-opencode-plugin/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'@research 如何在Node.js中高效处理大文件流?',它会调用研究代理为你搜集并总结相关的技术方案和最佳实践。当遇到一个难以定位的异步错误时,

对AI说:'/debug',它会指导你如何在关键路径添加带有`[DEBUG:PERFUX]`标记的日志,并在问题解决后通过脚本一键清理。

介绍

perfux-opencode-plugin 是一个专为OpenCode设计的插件,旨在增强开发者在编码过程中的研究能力和调试效率。它主要解决了开发者在需要快速调研技术问题或为复杂代码添加临时调试日志时的痛点。

使用方式非常便捷,安装后,开发者可以通过简单的指令调用其功能。例如,在聊天中输入 @research <查询> 即可启动研究代理进行信息搜集;输入 /debug 则会指导你如何添加带有特定标记的、易于后期移除的调试日志。

这个插件特别适合那些在开发中经常需要查阅外部资料、验证技术方案,或是在调试复杂逻辑时需要快速插入和清理临时日志的开发者。无论是全栈开发、后端开发还是智能体开发者,都能从中受益。

建议在项目开发初期或深度调试阶段启用此插件。需要注意的是,其研究功能依赖于外部网络和数据源,而调试技能主要提供的是方法论指导,具体的日志实现仍需开发者手动完成。

核心特点

核心区别在于集成了Context7 MCP工具,能直接调用其能力进行深度研究;同时,其调试技能提供了标准化的日志标记和便捷的一键清理脚本,避免了调试代码污染代码库。

注意事项

不适合对代码侵入性有严格要求的生产环境直接使用调试日志,且研究功能的效果受限于Context7 MCP的数据源和网络状况。

常见问题

如何移除所有调试日志?

运行插件提供的脚本:`bun .opencode/skill/debug/scripts/remove-debug-logs.ts`,可使用 `--dry-run` 参数预览将要删除的内容。

研究代理支持哪些查询?

支持广泛的技术概念、API用法、错误解决方案等查询,其能力基于集成的Context7 MCP工具。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/perfux-opencode-plugin/raw/index.md 读取 perfux-opencode-plugin 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。