名称: 更新设置模式 描述: 更新自定义Claude Code设置JSON模式，通过研究官方文档、解析CHANGELOG并合并发现的设置。 参数提示: [–dry-run | --validate-only | --diff] 允许的工具: Read, Bash, Skill, Task, WebFetch
更新设置模式命令
更新Claude Code设置的自定义JSON模式，通过研究官方文档、解析CHANGELOG并合并发现的设置。
参数
| 参数 | 描述 |
|---|---|
| (无) | 完整更新：研究、生成、验证、写入 |
--dry-run |
显示更改而不写入 |
--validate-only |
仅验证当前模式而不更新 |
--diff |
显示当前和生成模式之间的差异 |
--sync-env-vars |
强制从规范文档同步环境变量 |
工作流程
步骤 1: 加载当前状态
读取当前模式并提取版本元数据：
模式位置: plugins/claude-ecosystem/skills/settings-management/references/claude-code-settings.schema.json
提取: x-schema-version, x-claude-code-version, x-changelog-hash
步骤 2: 提取环境变量
从规范文档运行环境变量提取（存储在docs-management中）：
python plugins/claude-ecosystem/skills/settings-management/scripts/schema/extract_env_vars.py
这从settings.md文档中提取68+个环境变量，包括：
- 完整描述
- 类别标签（认证、模型配置、提供商、bash行为等）
- 布尔标志检测（
enum: ["0", "1"]） - 弃用标记
- 版本注释（
x-since）
步骤 3: 研究来源（并行）
在同一消息中调用所有三个研究来源：
-
docs-management 技能 - 查询设置文档：
使用查询调用 docs-management 技能："settings.json available settings schema options table env hooks permissions sandbox" -
claude-code-guide 代理 - 实时网络搜索：
生成 claude-code-guide 子代理，提示： "首先 WebFetch https://code.claude.com/docs/en/claude_code_docs_map.md 以找到关于设置配置的相关文档页面。然后 WebFetch settings.md 页面。仅在需要关于新设置字段的额外上下文时使用 WebSearch。返回所有设置字段及其类型和描述的列表。" -
Changelog 获取 - 获取最新的 CHANGELOG.md：
WebFetch https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md 从 v2.1.0 开始提取与设置相关的条目。
步骤 4: 合并和去重
冲突信息的优先级顺序：
- 官方文档（通过 docs-management） - 最高优先级
- 网络搜索（通过 claude-code-guide） - 中等优先级
- Changelog（通过 WebFetch） - 最低优先级
对于每个设置字段：
- 如果在官方文档中：标记
x-source: "official" - 如果仅在网络搜索中：标记
x-source: "web" - 如果仅在 changelog 中：标记
x-source: "changelog" - 为 changelog 发现的字段添加
x-since: "version"
步骤 5: 验证
运行验证脚本：
python plugins/claude-ecosystem/skills/settings-management/scripts/schema/validate_schema.py --verbose
模式必须：
- 是有效的 JSON Schema draft-07
- 具有所有必需的 x- 元数据字段
- 通过示例验证（如果使用 --check-examples）
步骤 6: 写入（除非使用 --dry-run）
如果验证通过且未使用 --dry-run：
- 更新模式文件
- 递增 x-schema-version（补丁版本）
- 更新 x-last-updated 为今天
- 使用新哈希更新 x-changelog-hash
- 使用当前环境变量计数更新 x-env-var-count
步骤 7: 报告
显示摘要：
模式更新摘要
--------------------
先前版本: 1.0.0
新版本: 1.1.0
Claude Code 跟踪版本: 2.1.9
属性: 40 (+3 新)
+ plansDirectory (v2.1.9, changelog)
+ showTurnDuration (v2.1.7, changelog)
+ mcpToolSearch (v2.1.7, changelog)
环境变量: 68
类别: 认证 (6), 模型配置 (10), 提供商 (6),
bash 行为 (7), 配置 (15), 禁用标志 (13),
代理 (3), mcp (5), vertex-bedrock (5), 工具 (2)
验证: 通过
写入到: .../claude-code-settings.schema.json
此命令不执行的操作
- 不直接修改 SchemaStore（需要向 SchemaStore 仓库提交 PR）
- 不抓取任意网页（仅限官方 Claude 文档）
- 不自动提交更改（用户必须手动提交）
模式特定行为
–validate-only
跳过研究和写入步骤。仅验证当前模式：
python .../validate_schema.py --verbose --check-examples
报告验证结果并退出。
–dry-run
执行完整工作流程但跳过步骤 5（写入）。显示将会更改的内容。
–diff
执行完整工作流程，在内存中生成新模式，显示差异：
+ 添加: mcpToolSearch (string)
~ 修改: hooks.PreToolUse（添加了 additionalContext 注释）
x-schema-version: 1.0.0 -> 1.0.1
x-last-updated: 2026-01-15 -> 2026-01-16
相关命令
/audit-settings- 根据此模式审核 settings.json 文件/list settings- 列出可用的设置字段
相关文件
| 文件 | 目的 |
|---|---|
references/claude-code-settings.schema.json |
带有 68 个环境变量的自定义模式文件 |
scripts/schema/generate_schema.py |
模式生成和环境变量同步 |
scripts/schema/extract_env_vars.py |
从规范文档提取环境变量 |
scripts/schema/validate_schema.py |
独立验证器 |
.claude/ecosystem-health.yaml |
跟踪模式版本 |