用途
encourage 技能用于在活动循环会话期间，向鼓励列表（encouraged list）添加条目。被加入鼓励列表的条目会在机会发现（opportunity discovery）中获得优先权，并且可以覆盖禁止模式（forbidden patterns）。该技能在有无活动循环的情况下均可使用，属于运行时配置，更改会在下一次迭代时生效。
主要能力
- 向鼓励列表添加短语，使其在机会发现中获得优先权。
- 列出当前鼓励列表中的所有条目。
- 清空所有鼓励条目。
- 按短语（模糊匹配）移除条目的能力。
- 鼓励条目可覆盖禁止模式。
- 鼓励条目会显示在
## USER GUIDANCE部分中。 - 配置写入
.claude/ru-config.json文件，由 Stop 钩子在每次迭代时重新读取。 - 自进化特性：如果指令错误、参数漂移或需要变通方法，鼓励立即修复该文件，仅针对真实、可复现的问题进行更新。
使用方式
/ru:encourage test coverage - 将 "test coverage" 添加到鼓励列表
/ru:encourage --list - 显示当前鼓励条目
/ru:encourage --clear - 清空所有鼓励条目
/ru:encourage --remove <phrase> - 移除匹配短语的条目（模糊匹配）
无参数调用时会显示用法说明和当前鼓励条目。
技能通过运行一段 bash 脚本执行，脚本内容涉及 PROJECT_DIR、CONFIG_FILE、ARGS 等变量，使用 jq 处理 JSON 配置。脚本会确保配置文件存在并保持 guidance 结构（包含 forbidden 和 encouraged 数组）。
适用场景
- 正在运行的活动循环会话期间，希望某些主题的工作获得优先处理。
- 需要临时调整机会发现的优先级，并希望更改在下一轮迭代中自动生效。
- 需要查看、清空或移除鼓励条目的管理操作。
限制与注意事项
- 配置依赖于
.claude/ru-config.json文件及其中正确的 guidance 结构。 - 若 jq 在添加时出错，可能因为配置文件格式错误，可使用
/ru:settings reset重新创建。 - 若条目未出现，可能因为拼写或大小写不同，应使用
--list核对确切文本。 - 若鼓励未生效，可能是因为 RU 未运行，应以
/ru:start启动。 - 按短语移除失败可能是因为未找到匹配，可用
--list查看确切条目名称。 - 若找不到配置文件，可能因为
.claude目录缺失，可用mkdir -p .claude创建。 - 关于定价、平台支持等具体信息，资料暂未提供。
故障排查
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 添加时 jq 错误 | 配置文件格式错误 | 运行 /ru:settings reset 重新创建 |
| 条目未出现 | 拼写或大小写不同 | 使用 --list 核对确切文本 |
| 鼓励未生效 | RU 未运行 | 使用 /ru:start 启动 |
| 按短语移除失败 | 未找到匹配 | 使用 --list 查看确切条目名称 |
| 找不到配置文件 | .claude 目录缺失 |
使用 mkdir -p .claude 创建 |
执行后反思
技能完成后，在关闭前应检查：命令是否成功，若不成功则修复导致失败的指令或错误表；参数或输出是否变化，若底层工具接口漂移则更新用法示例和参数表；是否需要变通方法，若进行了临时调整则更新 SKILL.md 以避免下次重复。仅当问题真实且可复现时才更新。