技能 claude-code-debug
📦

claude-code-debug

内容修订 r1 高风险 ⚙️ 外部命令📁 文件系统访问🔑 环境变量🌐 网络访问

调试 Claude Code 扩展问题

Claude Code 扩展可能会因文件布局、frontmatter、权限、hooks、agents 或 MCP 配置而失败。此技能提供实用的诊断流程和命令参考，用于隔离原因。

支持: Claude Codex Code(CC)
⚠️ 38 差

使用我的智能体安装

将此请求复制给你的智能体，其中包含权威 Skill 页面和清单。

智能体请求
Review the Skillstore skill "claude-code-debug" from https://skillstore.io/skills/0xdarkmatter-claude-code-debug.md and its manifest at https://skillstore.io/api/skills/0xdarkmatter-claude-code-debug/manifest. Verify the artifact. Stop and obtain explicit user consent before installing or changing files.

你的智能体仍应展示其计划，并按安全策略请求必要确认。

Agent 可读资源

当 AI Agent、爬虫或脚本需要干净上下文，而不是读取完整页面时，请使用这些链接。

Markdown 详情 GET /skills/0xdarkmatter-claude-code-debug.md 已签名 manifest GET /api/skills/0xdarkmatter-claude-code-debug/manifest 已签名 lockfile GET /api/skills/0xdarkmatter-claude-code-debug/lockfile

测试它

正在使用“claude-code-debug”。 My hook appears in settings but never blocks a tool call.

预期结果:

  • 确认 hook 已为确切的工具名称和事件类型注册。
  • 检查脚本是否可执行，并且能从标准输入读取示例输入。
  • 验证阻止行为是否使用预期的退出代码，并将消息写入正确的流。

正在使用“claude-code-debug”。 My custom agent file exists, but Claude Code never selects it.

预期结果:

  • 验证 agent 文件位于受支持的用户或项目 agent 目录中。
  • 检查 frontmatter name 和 description，确保它们提供清晰的使用信号。
  • 使用 agent 列表视图在测试委派前确认发现情况。

正在使用“claude-code-debug”。 An MCP server is configured, but its tools do not appear.

预期结果:

  • 测试 server package 是否可以在 Claude Code 外部启动。
  • 审查传输设置和引用的环境变量。
  • 确认权限规则允许预期的 MCP tool 名称。

安全审计

高风险
v6 • 2026/7/4 打开版本化报告

This skill is a documentation-only troubleshooting aid for Claude Code extensions. Most static findings are false positives from Markdown examples, local Claude path references, and official documentation links. Confirmed risks remain where the references tell users to display token values or print Claude session logs.

4
已扫描文件
823
分析行数
5
复核项
0
已忽略误报

已确认安全问题 (2)

高
references/common-issues.md:137references/debug-commands.md:240-241
Sensitive Token Display Guidance
The debugging references instruct users to echo GitHub and Anthropic API token values. This can leak credentials into terminals, logs, copied bug reports, or chat transcripts.
The cited commands explicitly display token material, so the risk is semantic and intentional, not only a variable-name match.
高
references/debug-commands.md:227-231
Sensitive Session Log Disclosure Guidance
The debug commands tell users to print the most recent Claude session file. Session logs can contain prompts, tool outputs, local paths, and secret values.
The command directly reads the latest file from the Claude sessions directory and prints it, which confirms session content disclosure risk.
能力复核项 (5)

这些是真实的本地能力，对此技能可能是预期行为，因此需要复核，但不会按已确认恶意行为计分。

高
references/common-issues.md:137
Git platform tokens
echo $GITHUB_TOKEN
The documentation tells the user to print GITHUB_TOKEN directly. That can expose a GitHub credential in terminal output, logs, or copied diagnostics.
高
references/debug-commands.md:231
Shell command substitution
cat ~/.claude/sessions/$(ls -t ~/.claude/sessions/ | head -1)
The command substitution selects a session file and prints it with cat. This is a documentation example, but it can expose private Claude session content and should use safer filtering or redaction.
高
references/debug-commands.md:231
Hidden file in home directory
cat ~/.claude/sessions/$(ls -t ~/.claude/sessions/ | head -1)
The example reads a file under the user home Claude sessions directory. Session files can contain prompts, outputs, paths, and secrets, so displaying them is a real privacy risk.
高
references/debug-commands.md:231
Hidden file access
cat ~/.claude/sessions/$(ls -t ~/.claude/sessions/ | head -1)
The example reads hidden Claude session data from the user home directory. This goes beyond a harmless path reference because it prints private session contents.
高
references/debug-commands.md:241
Generic API/secret keys
echo ${ANTHROPIC_API_KEY:0:10}...
The command displays the first characters of ANTHROPIC_API_KEY. Even partial API key disclosure is unnecessary for troubleshooting and can leak credential material.

风险因素

⚙️ 外部命令 (20)
references/common-issues.md:26 references/debug-commands.md:231 SKILL.md:16-25 SKILL.md:25-32 SKILL.md:32 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
📁 文件系统访问 (46)
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: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/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
🔑 环境变量 (2)
references/common-issues.md:137 references/debug-commands.md:241
🌐 网络访问 (4)
SKILL.md:109 SKILL.md:110 SKILL.md:111 SKILL.md:112
审计者: codex 查看审计历史 →
分享与引用此报告

分享版本化评估报告、中性徽章、嵌入卡片和引用。Skillstore 只报告证据，不判断该 Skill 是否安全。

打开版本化报告
安全评估

复制报告链接

https://skillstore.io/skills/0xdarkmatter-claude-code-debug/audits/6?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/0xdarkmatter-claude-code-debug/security.svg)](https://skillstore.io/skills/0xdarkmatter-claude-code-debug?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/0xdarkmatter-claude-code-debug?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/0xdarkmatter-claude-code-debug/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/0xdarkmatter-claude-code-debug.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
学术引用 (APA · BibTeX · CFF)

APA 引用

0xDarkMatter. (2026). claude-code-debug security audit report (audit version 6) [Author version unspecified]. Skillstore. https://skillstore.io/skills/0xdarkmatter-claude-code-debug/audits/6

BibTeX 引用

@techreport{0xdarkmatter-0xdarkmatter-claude-code-debug-2026, author = {0xDarkMatter}, title = {claude-code-debug security audit report (audit version 6)}, institution = {Skillstore}, year = {2026}, number = {6}, url = {https://skillstore.io/skills/0xdarkmatter-claude-code-debug/audits/6}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "claude-code-debug security audit report (audit version 6)" version: "unspecified" type: report authors: - name: "0xDarkMatter" date-released: "2026-07-04" url: "https://skillstore.io/skills/0xdarkmatter-claude-code-debug/audits/6" identifiers: - type: other value: "skillstore:0xdarkmatter-claude-code-debug:audit:6" description: "Skillstore immutable audit report identifier"

Skillstore 评分

评分依据 证据置信度: 中
45
架构
85
可维护性
87
内容
73
社区
91
规范符合性

你能构建什么

修复技能激活

通过检查结构、元数据和触发措辞，找出 Claude Code 技能未加载或未激活的原因。

追踪 Hook 故障

识别 PreToolUse 或 PostToolUse hook 缺失、不可执行、matcher 不匹配或返回错误退出代码的原因。

验证 Agent 和 MCP 设置

在 Claude Code 工具不可用或不稳定时，检查自定义 agent 可见性和 MCP server 注册情况。

试试这些提示

检查无法加载的技能 
Debug my Claude Code skill. The skill name is [name], it is located at [path], and the symptom is [what happens]. Start with file structure and frontmatter checks.
找出 Hook 未运行的原因 
Troubleshoot my Claude Code hook. The hook type is [PreToolUse or PostToolUse], the matcher is [matcher], and the script path is [path]. Check registration, permissions, input, and exit behavior.
诊断 Agent 或 MCP 发现问题 
Help diagnose why my Claude Code agent or MCP server is not available. Review the expected location, metadata, configuration entry, transport, and environment variable references.
审计完整扩展设置 
Create a diagnostic plan for my Claude Code setup. It includes skills, hooks, agents, MCP servers, and project settings. Prioritize checks that isolate loading, permission, and configuration failures.

最佳实践

  • 在共享诊断输出前，对 tokens、secrets、本地路径和会话内容进行脱敏。
  • 从预期的项目根目录运行检查，并在检查用户级配置前确认作用域。
  • 从 Claude Code debug output 开始，然后按顺序验证结构、权限和元数据。

避免

  • 将完整 API tokens 打印出来，或将原始会话日志粘贴到聊天、issue 或支持请求中。
  • 在检查 deny rules、hook matchers 和精确命令模式之前扩大工具权限。
  • 在验证文件名、目录位置和 frontmatter 语法之前，就假定扩展已经加载。

常见问题

此技能帮助调试哪些问题？
它帮助调试 Claude Code skills、hooks、agents、MCP servers、settings、permissions 以及相关的扩展加载行为。
它会更改我的 Claude Code 配置吗？
此技能提供诊断步骤。任何配置更改都应单独审查并批准。
它可以检查全局 Claude settings 吗？
某些示例会检查用户级 Claude settings。在将输出共享到你的机器之外之前，请审查并脱敏。
调试时打印 API keys 安全吗？
不可以。请使用存在性检查或脱敏后的值，而不是打印完整或部分 API keys。
它能帮助处理 MCP server 故障吗？
可以。它涵盖 package checks、configuration entries、transport settings、environment references 和 tool permissions。
它能替代官方 Claude Code 文档吗？
不能。它会组织故障排除步骤，并链接到官方文档以供更深入参考。

开发者详情

许可证

MIT

Skillstore 修订

r1

版本提示

作者未声明版本。

仓库

https://github.com/0xDarkMatter/claude-mods/tree/main/skills/claude-code-debug

引用

b94843b1014e2052f8a7cd64f580a4023b48fd5f

维护新鲜度

2026/7/18

使用量

6 次下载 · 389 次浏览

文件结构

📁 references/

📄 common-issues.md

📄 debug-commands.md

📄 troubleshooting-flow.md

📄 SKILL.md

0xDarkMatter 的更多技能

查看全部

相关技能

查看全部