技能 claude-code-debug
🔧
claude-code-debug
安全 ⚙️
外部命令📁
檔案系統存取🔑
環境變數🌐
網路存取
Déboguer les problèmes de Claude Code
也可從以下取得: 0xDarkMatter
Les extensions, hooks et agents de Claude Code cessent parfois de fonctionner. Cette compétence fournit des guides de dépannage étape par étape et des commandes de diagnostic pour identifier et résoudre les problèmes courants rapidement. Utilisez-la lorsque les compétences ne se chargent pas, les hooks ne s'exécutent pas ou les agents ne sont pas utilisés.
支援: Code(CC)
1
下載技能 ZIP
2
在 Claude 中上傳
前往 設定 → 功能 → 技能 → 上傳技能
3
開啟並開始使用
測試它
正在使用「claude-code-debug」。 My skill is not activating
預期結果:
- Check if the skill directory exists at .claude/skills/skill-name/
- Verify SKILL.md exists with exact capitalization
- Confirm YAML frontmatter starts and ends with ---
- Ensure name: field matches directory name exactly
- Add trigger keywords: Triggers on: keyword1, keyword2
- Run: claude --debug and look for skill loading errors
正在使用「claude-code-debug」。 My hook is not running
預期結果:
- Check if script is executable: chmod +x script.sh
- Validate settings.json with: jq '.' ~/.claude/settings.json
- Verify matcher is case-sensitive: use Bash not bash
- Test script manually: echo '{"tool_name":"Test"}' | ./hook.sh
- Run /hooks to see registered hooks
安全審計
安全v3 • 1/16/2026
This skill is a pure documentation resource containing troubleshooting guides, diagnostic command references, and decision trees for Claude Code. All 219 static findings are FALSE POSITIVES - they represent bash command examples in markdown documentation, not executable code. The skill contains no JavaScript/TypeScript code, makes no network calls, and performs no file system operations beyond reading its own markdown files. The allowed-tools field explicitly limits the skill to Bash and Read tools for helping users run diagnostic commands.
5
已掃描檔案
1,022
分析行數
4
發現項
3
審計總數
風險因素
⚙️ 外部命令 (133)
references/common-issues.md:12 references/common-issues.md:13 references/common-issues.md:13 references/common-issues.md:14 references/common-issues.md:15 references/common-issues.md:18-28 references/common-issues.md:28-35 references/common-issues.md:35-44 references/common-issues.md:44-45 references/common-issues.md:45-46 references/common-issues.md:46 references/common-issues.md:46-47 references/common-issues.md:47-51 references/common-issues.md:51-64 references/common-issues.md:64-70 references/common-issues.md:70-71 references/common-issues.md:71-78 references/common-issues.md:78-79 references/common-issues.md:79-89 references/common-issues.md:89 references/common-issues.md:89-90 references/common-issues.md:90 references/common-issues.md:90-94 references/common-issues.md:94-107 references/common-issues.md:107-113 references/common-issues.md:113 references/common-issues.md:113-115 references/common-issues.md:115-123 references/common-issues.md:123-124 references/common-issues.md:124 references/common-issues.md:124-125 references/common-issues.md:125-126 references/common-issues.md:126-129 references/common-issues.md:129-138 references/common-issues.md:138-144 references/common-issues.md:144 references/common-issues.md:144-145 references/common-issues.md:145-154 references/common-issues.md:154 references/common-issues.md:154-155 references/common-issues.md:155-159 references/common-issues.md:159-168 references/common-issues.md:168-174 references/common-issues.md:174-175 references/common-issues.md:175-184 references/common-issues.md:184-185 references/common-issues.md:185-189 references/common-issues.md:189-198 references/common-issues.md:198-202 references/common-issues.md:202-203 references/common-issues.md:203 references/common-issues.md:203-204 references/common-issues.md:204-205 references/common-issues.md:205-208 references/common-issues.md:208 references/common-issues.md:208 references/common-issues.md:208 references/common-issues.md:26 references/common-issues.md:18-28 references/debug-commands.md:7-14 references/debug-commands.md:14-33 references/debug-commands.md:33-43 references/debug-commands.md:43-49 references/debug-commands.md:49-65 references/debug-commands.md:65-77 references/debug-commands.md:77-89 references/debug-commands.md:89-97 references/debug-commands.md:97-111 references/debug-commands.md:111-117 references/debug-commands.md:117-128 references/debug-commands.md:128-134 references/debug-commands.md:134-153 references/debug-commands.md:153-157 references/debug-commands.md:157-166 references/debug-commands.md:166-170 references/debug-commands.md:170-179 references/debug-commands.md:179-185 references/debug-commands.md:185-194 references/debug-commands.md:194-198 references/debug-commands.md:198-207 references/debug-commands.md:207-213 references/debug-commands.md:213-222 references/debug-commands.md:222-226 references/debug-commands.md:226-232 references/debug-commands.md:232-236 references/debug-commands.md:236-248 references/debug-commands.md:248-252 references/debug-commands.md:252-264 references/debug-commands.md:264-270 references/debug-commands.md:270-271 references/debug-commands.md:271-272 references/debug-commands.md:272-273 references/debug-commands.md:273-274 references/debug-commands.md:274-275 references/debug-commands.md:275-276 references/debug-commands.md:231 references/debug-commands.md:226-232 references/troubleshooting-flow.md:7-17 references/troubleshooting-flow.md:17-21 references/troubleshooting-flow.md:21-50 references/troubleshooting-flow.md:50-54 references/troubleshooting-flow.md:54-83 references/troubleshooting-flow.md:83-87 references/troubleshooting-flow.md:87-113 references/troubleshooting-flow.md:113-117 references/troubleshooting-flow.md:117-134 references/troubleshooting-flow.md:134-138 references/troubleshooting-flow.md:138-165 references/troubleshooting-flow.md:165-169 references/troubleshooting-flow.md:169-198 references/troubleshooting-flow.md:198-204 references/troubleshooting-flow.md:204-206 references/troubleshooting-flow.md:206-209 references/troubleshooting-flow.md:209-213 SKILL.md:16-25 SKILL.md:25-32 SKILL.md:32 SKILL.md:32-34 SKILL.md:34-39 SKILL.md:39-47 SKILL.md:47-53 SKILL.md:53-64 SKILL.md:64-68 SKILL.md:68-78 SKILL.md:78-82 SKILL.md:82-92 SKILL.md:92-96 SKILL.md:96-105 SKILL.md:105-116 SKILL.md:116-117 SKILL.md:117-118 SKILL.md:118-122 SKILL.md:122
📁 檔案系統存取 (48)
references/common-issues.md:13 references/common-issues.md:60 references/common-issues.md:89 references/common-issues.md:99 references/common-issues.md:191 references/common-issues.md:203 references/common-issues.md:13 references/common-issues.md:60 references/common-issues.md:89 references/common-issues.md:99 references/common-issues.md:154 references/common-issues.md:191 references/common-issues.md:203 references/common-issues.md:164 references/common-issues.md:194 references/debug-commands.md:82 references/debug-commands.md:137 references/debug-commands.md:141 references/debug-commands.md:145 references/debug-commands.md:149 references/debug-commands.md:159 references/debug-commands.md:228 references/debug-commands.md:231 references/debug-commands.md:231 references/debug-commands.md:82 references/debug-commands.md:84 references/debug-commands.md:109 references/debug-commands.md:110 references/debug-commands.md:137 references/debug-commands.md:141 references/debug-commands.md:145 references/debug-commands.md:149 references/debug-commands.md:159 references/debug-commands.md:228 references/debug-commands.md:231 references/debug-commands.md:231 references/troubleshooting-flow.md:91 references/troubleshooting-flow.md:121 references/troubleshooting-flow.md:173 references/troubleshooting-flow.md:179 references/troubleshooting-flow.md:91 references/troubleshooting-flow.md:121 references/troubleshooting-flow.md:173 references/troubleshooting-flow.md:179 SKILL.md:77 SKILL.md:84 SKILL.md:77 SKILL.md:84
審計者: claude 查看審計歷史 →
品質評分
45
架構
100
可維護性
85
內容
30
社群
100
安全
83
規範符合性
你能建構什麼
Compétence qui ne se charge pas
Lorsqu'une compétence récemment installée ne s'active pas malgré une structure de fichiers et un frontmatter YAML corrects
Hook qui ne s'exécute pas
Lorsque les hooks configurés dans settings.json ne s'exécutent pas ou ne bloquent pas les outils comme prévu
Problèmes de serveur MCP
Lorsque les serveurs Model Context Protocol échouent à se connecter ou que les outils ne sont pas disponibles
試試這些提示
Demande de débogage de base
Ma compétence Claude Code ne s'active pas. Comment puis-je résoudre ce problème ?
Problème de hook
Mon script de hook ne s'exécute pas lorsque les outils sont utilisés. Quelles étapes de diagnostic dois-je suivre ?
Problème d'agent
Claude Code n'utilise pas mon agent personnalisé. Comment vérifier s'il est correctement configuré ?
Débogage MCP
Mon serveur MCP ne se connecte pas. Parcourez avec moi le flux de débogage pour identifier le problème.
最佳實務
- Exécutez 'claude --debug' pour voir les informations détaillées sur le chargement et les permissions
- Validez tous les fichiers JSON avec 'jq .' avant de sauvegarder
- Testez les scripts de hook manuellement avant de vous y fier
避免
- Sauter l'étape de validation du frontmatter YAML
- Utiliser des chemins relatifs dans les configurations de hook sans $CLAUDE_PROJECT_DIR
- Supposer qu'une compétence s'active sans ajouter de mots-clés de déclencheur spécifiques
常見問題
Quels outils cette compétence utilise-t-elle ?
La compétence utilise les outils Bash et Read pour vous aider à exécuter des commandes de diagnostic et afficher les fichiers de configuration.
Quelles sont les limites de cette compétence ?
Cette compétence fournit uniquement des conseils. Elle ne peut pas exécuter de commandes sur votre système ni modifier vos fichiers de configuration.
Comment cela s'intègre-t-il avec Claude Code ?
La compétence s'active lorsque vous décrivez des scénarios de débogage. Elle fournit des commandes documentées que vous exécutez vous-même.
Mes données sont-elles en sécurité ?
Oui. Cette compétence lit uniquement la documentation et suggère des commandes. Elle n'accède jamais à vos fichiers ni n'envoie de données nulle part.
Pourquoi mon hook ne s'exécute-t-il pas ?
Causes fréquentes : script non exécutable (chmod +x), nom d'outil de correspondance incorrect (sensible à la casse), JSON invalide dans settings.json.
En quoi est-ce différent du débogage intégré ?
Cette compétence fournit des arbres de décision et des exemples complets au-delà des commandes /hooks et /agents de base.