SuperAPI AI 工具集

intent

智能体与模型

查看项目

更新于 10-17 16:13

技能介绍

用途

intent 是一个面向需求澄清阶段的 AI 技能,目标是帮助使用者理解用户请求的含义,而不是讨论如何实现它。它强调先就需求本身建立共同理解,不进入设计或编码环节。

主要能力

使用该技能后,会产出一份位于 docs/context-engineering/<subject>/intent.md 的文档,需要包含以下部分:

  • Problem:试图解决什么问题
  • Definition of done:哪些信号表明任务已完成
  • Affected users and systems:影响范围
  • Constraints:由用户陈述或仓库证据给出的约束
  • Open questions:需要在后续规划阶段澄清的开放事项

使用方式

该技能通过提问来弥合理解上的重要缺口。它会调查异常路径、受影响的用户和系统以及边界条件;只有当未解决的问题会影响结果时才提问。

提问规则包括:

  • 每次最多批量提出四个问题,且这些问题属于同一主题;不把不同主题混在一组。
  • 如果用户取消,就停止并等待指示。
  • 优先问最能改变共同理解的问题。对于真正的选择,提供具体选项,并在有证据支持时给出推荐,同时保留“其他”选项;对于事实性问题,只提供有证据支持的答案,并在需要两个选项时使用“未知”和“跳过”。
  • 不编造领域答案。如果用户不知道,就记录未知及其后果,不强行猜测。
  • 不为推进而附和,指出相互冲突的陈述;用证据纠正误解,而不是悄悄调整文档。

适用场景

适合在需求或任务开始时使用,尤其是需要与用户对齐问题定义、完成标准和约束条件的协作场景。

限制与边界

  • 不追求细节级精确,细节设计由 design 阶段负责。
  • 不编写生产代码,只做澄清,不设计也不实现。
  • 不执行 git commit、不创建分支、不推送变更。
  • 在请用户描述代码已体现的行为之前,先检查仓库证据。
  • 区分用户陈述、仓库证据、推断和未知项;不把推断当作已确认的约束,推断性解读标注为 proposed,直到用户确认或纠正。
  • 挑战职责仅适用于问题框架层面。
  • 完成理解后,检查 intent.md 是否具备规定的结构。

其他

该技能的官方说明文本暂未提供。