SuperAPI AI 工具集

advise

编程与开发

查看项目

更新于 10-16 05:29

技能介绍

advise

交互式、对话式的引导,帮助你自己动手实现任务。

用法

/advise 001              # 引导完成 issue 001
/advise yourbench 001    # 显式指定项目
/advise 001 --phase 2.1  # 从指定阶段开始

对比:/implement vs /advise vs /teach

方面 /implement /advise /teach
谁写代码 AI 你 你
速度 快 中等 较慢
深度 完成任务 任务引导 概念学习
提问 少 按需 频繁、苏格拉底式

可以期待什么

对话流程

AI:第一步:初始化 Next.js。目录里有一些文档,
    所以我们会先把它们临时移走……

用户:--no-git 标志是做什么的?

AI:好问题!它告诉 create-next-app 跳过运行
    'git init',因为你已经有仓库了……

用户:完成

AI:让我检查一下……看起来不错。接下来,我们需要清理
    样板代码……

引导风格

  • 解释要做什么——每一步给出清晰指令
  • 回答问题——回应澄清性提问
  • 检查你的工作——当你说“done”时进行审查
  • 适应节奏——准备好时再继续推进
  • 注重实用——以任务为中心,而不是讲授概念

执行流程

1. 加载上下文

读取:ideas/[project]/issues/###-*/TASK.md 读取:ideas/[project]/issues/###-*/PLAN.md 读取:ideas/[project]/specs/SPEC-###.md(如果有关联) Glob:spaces/[project]/docs/project/adrs/ADR-*.md

2. 对话式引导

  • 简单解释当前步骤
  • 等待用户提问或确认
  • 随时回答出现的问题
  • 当用户说“done”时检查工作
  • 准备好后进入下一步

3. 按需研究

  • 使用 Context7 查询库文档
  • 用 WebSearch 查找最佳实践
  • 参考代码库中的模式

4. 检查工作

当用户说“done”时:

  • 读取被修改的文件
  • 检查常见错误
  • 验证是否符合需求
  • 如有需要,建议修复

5. 更新 WORKLOG

在检查点记录:

## YYYY-MM-DD HH:MM - ADVICE: Phase 1 Complete

Guided user through Next.js initialization.
Completed: ...
Next: Phase 2

何时使用

  • 了解技术栈,但需要针对当前任务的引导
  • 想要掌控过程,同时避免出错
  • 偏好自己动手实现
  • 任务有一定复杂度,值得讨论

改用 /implement:只想快速完成、样板代码。 改用 /teach:学习技术、需要概念性理解。

工作流

/issue -> /plan -> /advise -> [你来实现] -> /worklog -> /commit