bug-review
追踪并定位代码缺陷,提供证据链辅助排查
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:bug-review。 它的用途是:追踪并定位代码缺陷,提供证据链辅助排查 完整的 Skill 内容见:https://321skill.com/skills/bug-review/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘服务在每晚凌晨2点左右会偶发性超时,这是近期的错误日志片段。’ 它会分析日志中的时间模式、错误堆栈和可能的资源瓶颈,结合代码变更历史,构建一个关于定时任务、数据库连接或外部API调用的证据链,指出最可能的根因区域。或者,
对AI说:‘帮我审查这段新提交的支付接口代码,看看是否有潜在的并发问题。’ 它会模拟多线程场景,分析代码逻辑和数据竞争可能性,并追溯相关模块的修改历史,给出风险点和测试建议。
介绍
bug-review 是一个专注于提升代码质量与调试效率的 AI 技能。它旨在解决开发者在面对复杂或偶发性 Bug 时,难以快速定位根因、梳理证据链的痛点。该技能通过分析代码变更、系统日志、错误信息等多维度数据,智能关联线索,帮助开发者系统性地追踪问题源头,而非仅提供孤立的错误提示。
使用时,开发者只需向 AI 助手描述遇到的 Bug 现象或提供相关上下文(如错误日志片段、代码文件),bug-review 便会引导性地提问或主动分析,逐步构建从现象到根因的证据链条,可能包括代码审查、日志分析、环境配置检查等步骤,最终给出清晰的排查路径和可能的修复建议。
该技能特别适合需要处理线上故障、维护复杂遗留系统或进行深度代码审查的开发者。无论是前端、后端还是全栈工程师,在需要高效、严谨地排查问题时,都能从中受益。项目经理和测试工程师也可利用它来更准确地理解问题本质,评估修复风险。
建议在问题复现环境或拥有完整项目上下文(如代码库访问权限、日志文件)时使用,效果最佳。对于完全无法复现或缺乏关键日志的偶发问题,其分析能力可能受限。使用时注意保护代码中的敏感信息,避免在公共会话中泄露密钥或内部业务逻辑。
核心特点
与一般代码检查工具不同,它强调构建“证据链”,不仅指出问题,更还原问题发生的逻辑路径和上下文关联,帮助开发者理解“为什么”会出现这个 Bug,而不仅仅是“哪里”有错。
注意事项
不适合用于分析完全缺乏日志、无法复现或与特定硬件/网络环境强相关的偶发性问题。
常见问题
bug-review 能直接修复 Bug 吗?
不能直接修复。它的核心价值在于辅助定位根因和梳理证据链,为开发者提供清晰的排查方向和修复建议,具体的代码修改仍需开发者完成。
需要提供哪些信息才能有效使用?
建议提供尽可能详细的上下文,如错误信息、相关代码片段、系统日志、复现步骤以及最近的相关代码变更,信息越完整,分析越精准。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/bug-review/raw/index.md 读取 bug-review 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/bug-review/raw/index.md(查看排版版本)