SuperAPI AI 工具集

planning-clarification

智能体与模型

查看项目

更新于 10-15 10:05

技能介绍

用途

planning-clarification 用于在路线图分解之前,解决那些会阻塞路线图规划的歧义。它只处理阻塞规划的歧义,不在此处分解路线图结构。

何时使用

  • 文档或提示中确实存在关于目标、约束、成功标准或“现在做还是以后做”边界的歧义。
  • 不先选择方向就无法进行路线图分解。
  • 下一步取决于澄清哪些属于现在、哪些属于以后,或者第一个规划切片应针对什么。

何时不使用

  • 唯一的问题是文档缺失。
  • 路线图方向已经足够清晰,可以进行分解。
  • 当前工作是里程碑分解、任务本地设计或执行。

先读内容

  • docs/tasks/index.md
  • docs/tasks/planning-inbox.md
  • 相关的 docs/tasks/ 材料
  • docs/architecture/
  • docs/context/
  • 当前用户提示

负责范围

  • 识别阻塞路线图规划的歧义
  • 为 grilling 构建阻塞路线图规划的歧义框架
  • 明确“现在做还是以后做”的边界
  • 推荐一个澄清后的方向
  • 移交澄清后的规划上下文

不负责范围

  • 里程碑、模块或任务分解
  • 任务本地的 spec.md 或 plan.md
  • 实现或执行隔离
  • 超出解除路线图规划阻塞所需的开放式产品发现

入口检查

  • 仅在有明确歧义证据时使用此技能,而不是仅因文档缺失。
  • 使用外部 grilling 技能进行访谈循环。如果不可用,请用户安装,而不是在此重新创建其完整协议。
  • 如果代码库或文档能回答问题,先检查它们再询问用户。
  • 如果问题已经涉及路线图结构而非方向,则路由到 milestone-planning。

默认流程

  1. 识别阻塞路线图规划的具体歧义。
  2. 启动一个受限于阻塞路线图规划歧义的 grilling 会话。
  3. 让 grilling 运行访谈协议,同时此技能保持路线图边界。
  4. 明确每个分支的后果:哪些属于现在、哪些属于以后,以及下一个规划目标变成什么。
  5. 一旦方向足够清晰可以进行分解,停止并移交给 milestone-planning。

澄清规则

  • 将此视为阻塞路线图的澄清,而非广泛的产品发现。
  • 使用 grilling 进行访谈循环,而不是在此重复其提问协议。
  • 保持问题面狭窄:只问会改变路线图方向、阶段边界、成功标准或第一切片范围的问题。
  • 将目标视为期望的未来状态、产品成果、机会或阶段方向。不要仅为了将已经具体的任务型条目重新标记为目标而使用澄清。
  • 如果提示条目已经有具体成果、大致范围和明显的验收面,则将其交给 milestone-planning 进行放置,而不是问抽象的目标问题。
  • 当存在真实替代方案时,简要比较 2-3 个可能方向并推荐一个。
  • 如果范围太大,无法在一次规划中完成,则澄清第一个连贯的规划目标,而不是试图一次性确定整个产品。
  • 不要在完成澄清的同一响应中开始路线图分解。

如果受阻

  • 当阻塞是未解决的决策时,继续通过 grilling 进行。
  • 如果用户尚未回答当前路由问题,不要代其回答。

审查与跟进

  • 在澄清后的方向被确认或纠正后停止。
  • 在此停止后,将清晰的前进语言视为进入推荐下一规划阶段的许可。
  • 默认跟进是移交给 milestone-planning。

输出

  • 当前歧义
  • 下一个问题或选项集
  • 推荐方向
  • 澄清后的“现在做还是以后做”边界

停止点

  • 一个阻塞性澄清问题
  • 或澄清后的方向移交给 milestone-planning

移交

  • 已决定
  • 未决定
  • 下一个技能
  • 停止点