用途:该技能在 /ralph:start 的 Step 1.6 中由 Skill 工具调用,用于配置 Ralph 循环的会话指引,包括禁止项(forbidden)与鼓励项(encouraged)。用户也可主动要求重新配置,或提到“forbidden items”“encouraged items”时触发。
主要能力:读取约束扫描结果(.claude/ralph-constraint-scan.jsonl,NDJSON 格式),按严重程度(critical/high/medium/low)统计并动态生成选项;先展示 critical、high 约束,不足 4 项时用静态类别(文档更新、依赖升级、重构、CI/CD 修改)补齐;随后收集自定义禁止项与鼓励项(鼓励项为封闭列表:ROADMAP P0、性能改进、Bug 修复、研究实验)。写入 .claude/ralph-config.json 的 guidance 字段,并保存 constraint_scan。已选约束会追加到 .claude/ralph-acknowledged-constraints.jsonl,后续展示时过滤。
使用方式:前置条件为 Step 1.4 约束扫描完成、Step 1.5 预设确认完成。若配置中已有 guidance,会先询问保留或重新配置;首次运行直接进入加载扫描结果。写入前会备份配置,写入后校验 JSON 结构、字段类型,失败则回滚。
适用场景:Ralph 循环启动前的会话指引配置,或需要调整禁止/鼓励项时。
限制:依赖 jq、bash 及上述文件存在;AUQ 选项最多 4 个;无扫描文件时仅显示静态类别;具体平台与收费信息暂未提供。