SuperAPI AI 工具集

pathfinding

智能体与模型

查看项目

更新于 10-16 07:44

技能介绍

Pathfinding 是一个面向需求澄清与头脑风暴的智能体技能(skill),核心理念是「自适应问答 → 模糊需求 → 清晰路径」。它帮助在需求不清晰时,通过逐级提问把模糊意图梳理为可执行的明确方案。

用途与适用场景 Pathfinding 用于以下情形:需求含糊或不完整;需要探索的复杂功能;存在开放问题的全新(greenfield)项目;协作式头脑风暴或共同解题。它明确不适用于:时间紧迫的 bug、定义明确的任务、显而易见的问题。

主要能力 该技能内置一条从 0 到 5 的置信度刻度,每一级带有百分比区间、名称和对应动作:

  • 0 级(0–19%,Prepping):收集基础上下文
  • 1 级(20–39%,Scouting):提出宽泛问题
  • 2 级(40–59%,Exploring):提出聚焦问题
  • 3 级(60–74%,Charting):继续推进有风险,仍有缺口
  • 4 级(75–89%,Mapped):可行,但需推向第 5 级
  • 5 级(90–100%,Ready):交付 要求诚实评估起始等级:需求清晰则从 4–5 级开始,模糊则从 0–2 级开始。第 4 级时可提示「可以继续,但再问 1–2 个问题能达到完全信心,是继续还是现在交付?」。低于第 5 级时应附带 △ 注意事项章节。

阶段与任务跟踪 技能会加载 maintain-tasks 技能用于阶段跟踪,阶段只前进不回退。四个阶段及触发条件为:Prep(0–1 级,activeForm「Prepping」)、Explore(2–3 级,「Exploring」)、Clarify(4 级,「Clarifying」)、Deliver(5 级,「Delivering」)。每个阶段生成带上下文的标题,例如「Prep {domain} requirements」「Explore {approach} options」「Clarify {key unknowns, 3-4 words}」「Deliver {artifact type}」。此外还有按需插入的阶段:Resolve Conflicts(出现 ◆ 谨慎或 ◆◆ 高危阻力时)、Validate Assumptions(交付前验证高风险假设)。

工作流 开始时创建一个与初始置信度匹配的阶段并标记为进行中;过渡时把当前阶段标记为已完成并新增下一阶段为进行中。若起始等级高(4 级以上),可直接跳到 Clarify 或 Deliver;若提前交付,则跳到 Deliver 并附 △ 注意事项。技能强调先校准:用户可能已提供文档、先前对话或指向文件,若上下文足够,应跳到 3–4 级,不要重复询问已经清楚的内容。

提问关注点 若仍有缺口,则从以下相关方面探索:Purpose(解决什么问题、为何是现在)、Constraints(时间、技术、团队、依赖)、Success(如何确认有效)、Scope(包含什么、排除什么)。当存在多个方案时,提出 2–3 个带权衡的选项,以 ★ 标注推荐并说明理由,让用户选择、组合或转向。

设计原则 遵循 YAGNI(砍掉不需要的)、DRY(不重复努力或逻辑)、Simplest thing(偏好朴素方案)。每个问题使用 EnterPlanMode,以支持用键盘导航选项。结构上:工具上方写散文(上下文、推理,有明确倾向时给 ★ 推荐),工具内只放选项(简洁易扫读)。

各级提问方式 第 0 级从会话意图开始:是快速确认还是深入探讨?是探索可能性还是解决具体问题?「完成」是什么样子?第 1–4 级聚焦实质:每个问题提供 2–4 个选项加「5. 其它」,在推荐项内联 [★] 并附斜体理由,用户可用编号、修改或组合来回复。循环方式为:回答 → 复述 → 更新置信度 → 下一步动作。

每次回答后的反馈 每次回答后输出:Confidence(进度条 + 名称)、Assumptions(若有实质影响)、Unknowns(可澄清的未知项,相关时注明不可知项)、Decisions(已锁定的决定)、Concerns(感觉不对之处及原因)。下一步动作按等级区分:0–2 级继续提澄清问题;3 级用最多 3 条要点总结并朝 5 级分叉;4 级提供「细化或继续」的选择;5 级交付。

顾虑处理与升级协议 当回答中途暴露出顾虑时,先暂停再问下一个问题,用 △ 加简述呈现,并询问是「现在澄清、稍后记录,还是按假设继续」。若用户在存在重大缺口时仍继续推进,则升级到阻力协议。升级分三档:◇ Alternative(轻微不一致,给出选项与理由);◆ Caution(明确冲突,推荐替代方案、说明风险并询问是否继续,触发 Resolve Conflicts);◆◆ Hazard(高失败风险,要求缓解措施或明确越权,触发 Resolve Conflicts)。越权时接受「Proceed anyway: {REASON}」,记录到下一次反思中并将 Resolve Conflicts 标记完成。

skeptic 复杂度审查 技能集成了 skeptic 智能体用于复杂度合理性检查。推荐(提供选择)触发条件:达到 5 级但有超过 2 条 △ 注意事项;决策中出现红旗措辞如「might need later」「more flexible」「best practice」。此时询问是否运行 skeptic 做合理性检查,选项为:是,快速检查 [★];是,深度分析(后台启动 skeptic 智能体);否,按原样交付。自动调用(不给选择)触发条件:4 级以上且 3 个以上未知项在 2 个以上提问周期中持续存在;会话中触发 ◆◆ 高危升级。自动调用时输出 [Auto-invoking skeptic — {REASON}],并通过 Task 工具启动,subagent_type 为 "outfitter:skeptic",提示中包含当前决定、未知项和注意事项,run_in_background 设为 false(交付前等待结论)。skeptic 返回后向用户呈现结论:若判定为 block 则新增 Resolve Conflicts 阶段;若为 caution 则提供处理或知悉的选择;若为 proceed 则继续交付。

交付与持久化 第 5 级立即产出制品(文档、计划、代码、提纲);若未指定则建议一种。交付后询问持久化位置(如适用),选项包括:{discovered path} [★](来源为 CLAUDE.md 偏好、已有目录或约定);创建 issue(依据项目上下文选择 Linear/GitHub/Beads);ADR(若为架构决策);不持久化仅保留在对话中;其它位置或格式。选项 1 的发现顺序为:CLAUDE.md 或项目说明中的显式计划存储偏好 → 已有的 .agents/plans/ 目录 → 已有的 docs/plans/ 目录 → 若都没有则回退到 .agents/plans/。始终基于主题建议文件名,若存在既有约定则沿用。制品交付后将 Deliver 标记完成(持久化为可选的后续动作)。

低于第 5 级的注意事项 低于 5 级时附加 △ Caveats:开放问题与上下文;假设的决定与默认值;已知顾虑与影响;推迟项与重访时机。

必做(ALWAYS) 开始时创建与初始置信度匹配的任务阶段;每个问题使用 EnterPlanMode(键盘导航);工具上方写散文提供上下文与 ★ 推荐;一次只问一个问题并等待回复;下一次动作前复述并更新置信度;在第 4、5 级阈值处更新待办;冲突时应用阻力协议;第 4 级以上检查 skeptic 触发条件(未知项、注意事项、红旗措辞)。

禁止(NEVER) 不得在 0–3 级未提澄清问题就推进;不得在第 5 级以下隐藏不确定性;不得堆叠问题或把决定埋在段落里;不得把推荐放进 plan 工具内(须留在散文里);不得跳过回答后的反思;不得让阶段倒退;不得忽略 skeptic 自动调用触发条件。

附带的参考文件包括 confidence.md(置信度深入说明)、questions.md(问题设计)、examples/(会话示例)以及 skeptic 智能体(outfitter:skeptic)。

限制 以上为技能自身定义的工作流程与规则。至于该技能的收费、价格、可用平台、具体使用效果等信息,资料中暂未提供。