SuperAPI AI 工具集

nav-triz

通用与其它

查看项目

更新于 10-25 16:17

技能介绍

Navigator TRIZ Skill 是 qf-studio/navigator 中的一个技能,专门用于处理少数存在“改善 X 会使 Y 变差”这类技术矛盾的任务。它不替代常规快速拟合方案,而是强制在 PLAN 阶段之前给出三个真正不同的候选方案,并记录解决方式供后续会话检索。

用途:当用户明确要求“为 X 寻找更好的解决方案”、“X 的替代方案”、“解决矛盾”或“triz this”,或者 nav-brief 的 Contradict 行不为 none 且任务较复杂(复杂度 ≥ 0.5 或涉及多个子系统)时触发。常规工作、brief 中 Contradict 为 none、“直接做”/“快速修复”式直接通过,或用户已指定方法时不触发;技能说明强调“仪式感是失败模式”,不确定时跳过并一句话说明。

主要能力与协议(一屏输出):

  1. 用一行陈述矛盾,技术形式(“改善 A 与恶化 B”)或物理形式(“X 必须同时是 A 和 not-A”)。无法陈述则停止。
  2. 理想最终结果(IFR):如果功能存在且无需新代码会怎样?说明必须为真什么。若可达,则为候选 0,通常就是答案。
  3. 复用清单:已有什么完成了 ≥80%?给出 path:line 或 none found。
  4. 先例解决 + 原则提示:运行代码块中的 Python 脚本,打印图中解决过相关张力的决策,然后给出三个来自不同分离模式的原则提示(若无匹配则用通用三件套)。仅在提示不清时阅读 reference/PRINCIPLES.md。
  5. 三个候选,每个对应一个提示,填入表格;每个候选必须说明它恶化什么。没有副作用的候选是描述错误的妥协,或是 IFR。
  6. 推荐一个,并给出一句话理由。最多一个开放问题。
  7. 工作后,若解决方式不明显,使用 graph_manager.py 捕获为决策记忆。

输出模板:固定表格包含矛盾、IFR、复用、先例、三个候选(模式/原则、变化内容、成本、恶化项)、推荐和开放问题。规则:三个候选而非五个;不同分离模式而非同一动作的三种变体;每行“恶化”单元格必填;总输出一屏。

使用方式:通过提供的 Python 命令调用 functions/triz_suggest.py,需指定矛盾字符串,可选图路径、限制和格式。该脚本确定性、仅用标准库、始终退出 0;按关键词对约 20 个映射原则排序,先为每个分离模式选一个,再用先例行动/动态化/分割填充,并通过 query_contradictions 列出图中先前的决策。

适用场景:需要为存在技术矛盾的复杂任务寻找创新替代方案时。限制:不适用于常规工作、无矛盾或用户已指定方法的情况;技能说明强烈建议不要过度使用。

相关文件:reference/PRINCIPLES.md(分离模式+映射原则,懒加载)、skills/nav-brief/SKILL.md(Contradict 行)、skills/nav-graph/SKILL.md Step 3B(捕获带标签决策)。

安装与配置:资料中给出了环境变量 CLAUDE_PLUGIN_ROOT 和插件目录的默认路径,但未提供独立安装命令或收费信息。