用途:排查 Claude Code 权限提示异常。Claude Code 的权限模式由 6 层配置叠加决定(优先级自下而上):VSCode 用户设置、VSCode 工作区设置、CLI 用户设置(~/.claude/settings.json)、CLI 项目设置(<repo>/.claude/settings.json)、CLI 项目本地设置(<repo>/.claude/settings.local.json)、会话内模式(会话开始时由前 5 层决定,之后可用 Shift+Tab 切换)。单层配置错误会造成静默覆盖,肉眼难以定位。
主要能力:读取各层相关键(claudeCode.initialPermissionMode、allowDangerouslySkipPermissions、permissions.defaultMode、permissions.allow、permissions.deny),计算最终生效的 defaultMode、合并后的 allow/deny 列表,并标出常见故障:仅在项目层设置 bypass 或 auto(第 4、5 层不承认这两种起始模式,会被忽略)、层间冲突、仅 VSCode 设置 bypass、空 allow 列表、会话过期、deny 优先于 allow。
使用方式:Phase A 自动运行,只读仓库本地文件;若结论不足,Phase B 会先请求用户确认,再读取 ~/.claude/settings.json 与 VSCode 用户设置(路径按平台区分),且只提取相关键,其余脱敏。若 $CLAUDE_PROJECT_DIR 未设置,回退到 git rev-parse --show-toplevel。
限制:该技能为只读,不会修改设置;不读取主机全局文件除非用户明确同意;运行时模式需借助状态栏或模式指示器确认,若状态栏未配置会给出警告。