项目设置技能用于查看或修改 Claude Code Game Studios 项目的配置。它管理两个配置文件:project.yaml 是团队共享、提交到版本库的配置;project.local.yaml 是每位开发者的本地覆盖,被 git 忽略。使用该技能可以检查当前设置或修改设置,而无需手动编辑 YAML。
主要能力
该技能支持四种调用形式。无参数时查看全部生效配置;只给一个键时查看该项的值与来源;使用 key=value 形式时写入 project.yaml;使用 --local key=value 形式时写入 project.local.yaml。键为点分 YAML 路径,例如 modes.review_mode 或 testing.strict.logic。
来源解析
查看配置时,技能会沿解析链读取:project.local.yaml → project.yaml → 旧版文件 → rigor 派生 → 默认值,并标注每个值的来源,例如 (project.yaml)、本地覆盖、由 rigor 派生 (derived from rigor: <level>) 或 (default)。同时会检查该设置是否允许被本地覆盖;不允许时标为 locked(项目级设置),并说明 locked 不等于不可改,显式写入的值仍会覆盖 rigor 派生值。查看全部配置时还会追加 rigor 相关的设置项,以展示派生值。
写入与校验
写入前会做枚举值校验;若值无效,会显示允许的取值并终止写入。写入 project.yaml 时会进行已知键检查:如果没有任何技能或钩子读取该键,则提示这通常意味着拼写错误,并让用户选择最近的键、仍然写入或取消。若该设置在 project.local.yaml 中已有本地覆盖,会提示写入 project.yaml 不会改变当前生效值。所有配置写入都需要用户确认,即使处于自主模式,除非用户已将 schema_changes 从 always-ask 列表中移除。写入 modes.rigor 时,还会重新读取并展示随之变化的六项派生设置。
保留设置提示
部分设置有文档但不被任何技能或钩子读取,修改它们不会改变行为。该技能会在查看全部、查看单项和两条写入路径中都标记此类设置,避免用户误以为行为已被强制。写入保留键不会被拒绝,但会事先警告值会被保存而行为不变。
限制
该技能仅适用于包含 .claude/hooks/yaml-helper.sh 的 Claude Code Game Studios 项目;缺失时会报错退出。若 project.yaml 不存在,会提示运行 /start 创建。当文件结构异常(如注释掉同名键、嵌套歧义、YAML 格式错误)时,技能会停止并询问用户如何处理,而不是自行猜测插入位置。