用途 该技能用于查看或修改 loop 设置(RU: Settings)。它通过运行一段 bash 脚本管理项目配置,支持显示当前配置、重置为默认值,以及设置单个配置键的值。
主要能力
- show(默认):显示当前配置与状态。状态读取 .claude/ru-state.json 中的 state 字段,无状态文件时显示 stopped。配置读取 .claude/ru-config.json,并用 python3 -m json.tool 格式化输出;无配置文件时提示使用默认值。
- reset:删除配置文件与状态文件,输出 “Config reset to defaults.”。
- set <key>=<value>:设置某个配置项。键值以首个 = 拆分;value 为空或 key 为空时报用法错误。配置文件不存在时先创建为 {}。随后用 jq 写入:若 value 为数字或布尔值则按对应类型写入,否则按字符串写入。写入完成后输出 “Set $KEY = $VALUE”。
- 参数缺省或无法匹配时,输出用法提示:/ru:settings [show|reset|set <key>=<value>]。
使用方式 触发词:ru settings、loop settings、show settings、ru configuration。执行时运行文档中提供的 bash 脚本(使用 /usr/bin/env bash 与 heredoc)。脚本中通过 CLAUDE_PROJECT_DIR(缺省为当前目录)确定 PROJECT_DIR,进而定位 CONFIG_FILE 与 STATE_FILE。命令示例:/ru:settings set <key>=<value>。
该技能标注为 “Self-Evolving Skill”:会通过使用改进;若指令有误、参数漂移或需要临时变通,应立刻修改该文件,不要拖延。仅针对真实、可复现的问题更新。执行后需进行反思:命令是否成功(失败则修正指令或错误表)、参数或输出是否变化(若底层工具接口漂移则更新用法示例与参数表)、是否使用了变通方法(若如此则更新 SKILL.md 避免下次重复)。仅在问题真实且可复现时更新,不做推测性修改。
适用场景 适用于需要查看或调整项目级 RU/loop 配置的场合,例如查看当前状态与配置、将配置重置为默认、以及修改特定配置键的值。
限制与故障排查
- 配置文件未找到:原因可能是 .claude 目录缺失;解决方式为用 mkdir -p .claude 创建。
- set 时 jq 报错:原因可能是值语法无效;需检查值类型(数字、字符串、布尔值)。
- 未找到 python3:原因可能是 python3 不在 PATH;解决方式为安装 Python 3 或改用 jq .。
- reset 会删除状态:这是有意行为,重置时状态文件也会被删除。
- 更改未生效:原因可能是使用了错误的配置文件;需检查 PROJECT_DIR 是否与当前工作目录一致。
配置项的完整列表、默认值详情,以及除上述参数外的其他功能暂未提供。