cc-general-skills
为Claude Code提供系统化调试与自动排错技能合集
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:cc-general-skills。 它的用途是:为Claude Code提供系统化调试与自动排错技能合集 完整的 Skill 内容见:https://321skill.com/skills/cc-general-skills/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
当你发现一段刚修改的代码导致单元测试失败时,可以
对AI说:“刚才的修改让测试用例X失败了,输出是Y,但预期是Z。” AI会触发debug技能,按照医学诊断步骤,引导你收集事实、列出所有可能原因、设计实验逐一排除,并最终定位问题根因。或者,当AI执行一个部署命令后没有报错但服务并未启动,error-troubleshooter技能会自动触发,开始调查这种“静默失败”。
介绍
本仓库为Claude Code提供了两个核心技能:debug和error-troubleshooter,旨在解决开发者在编码和调试过程中遇到的各类问题。
debug技能借鉴医学鉴别诊断原理,提供了一套七步走的系统化调试方法论。当AI修改了原本正常的代码后出现异常,或用户报告了意外的测试结果时,该技能会被触发,引导AI从客观观察到预防机制,进行严谨的根因分析。
error-troubleshooter技能则专注于主动识别和解决错误。它不仅能处理显式的错误(如异常、构建失败),还能敏锐地发现“静默失败”——即命令执行成功但未产生预期效果的情况,并自动启动调查流程。
这套技能非常适合需要处理复杂、偶发性问题,或希望提升代码调试科学性的开发者。无论是排查一个难以复现的Bug,还是理解一段陌生代码为何行为异常,都能从中受益。
使用建议:建议将这两个技能配合使用。error-troubleshooter可作为第一道防线,自动捕获和初步分析问题;对于更复杂或需要深度分析的问题,则可手动或由AI触发debug技能进行系统化调查。注意,技能本身不直接修复代码,而是提供严谨的分析框架和决策支持。
核心特点
区别于通用的“帮忙看看代码”式调试,`debug`技能引入了医学诊断的严谨框架,强制进行“鉴别诊断列表”枚举和证据链推理,极大减少了基于直觉的猜测。`error-troubleshooter`的核心在于其“主动性”和“双模式”,能自动发现并处理那些容易被忽略的“静默失败”,而无需用户明确请求。
注意事项
该技能集主要面向代码开发和调试场景,不适合处理非技术性问题(如业务逻辑设计、产品需求讨论)或纯粹的知识问答。
常见问题
debug和error-troubleshooter有什么区别?
debug是系统化的深度调试框架,需主动触发,用于复杂问题根因分析;error-troubleshooter是自动触发的轻量级排错工具,用于即时捕获和初步解决各类错误与异常。
安装后如何触发这些技能?
技能会根据预设条件自动触发(如遇到错误),也可在对话中通过描述问题(如“这个测试失败了,帮我系统调试一下”)来引导AI使用相应技能。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/cc-general-skills/raw/index.md 读取 cc-general-skills 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/cc-general-skills/raw/index.md(查看排版版本)