Back to Details

advise

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

/advise

/advise

Interactive, conversational guidance as you implement a task yourself.
交互式对话式指导，助你亲手完成任务实现。

Usage

使用方法

bash
/advise 001              # Guide through issue 001
/advise yourbench 001    # Explicit project
/advise 001 --phase 2.1  # Start at specific phase
bash
/advise 001              # 指导完成编号001的任务
/advise yourbench 001    # 指定具体项目
/advise 001 --phase 2.1  # 从特定阶段开始

Comparison: /implement vs /advise vs /teach

对比：/implement vs /advise vs /teach

Aspect/implement/advise/teach
Who writes codeAIYouYou
SpeedFastMediumSlower
DepthTask completionTask guidanceConceptual learning
QuestionsFewAs neededFrequent, Socratic
维度/implement/advise/teach
代码编写者AI用户用户
速度快中等较慢
深度完成任务任务指导概念学习
提问情况很少按需提问频繁（苏格拉底式）

What to Expect

预期体验

Conversational Flow

对话流程

AI: "First step: Initialize Next.js. The directory has some docs,
     so we'll move those temporarily..."

User: "What does the --no-git flag do?"

AI: "Good question! It tells create-next-app to skip running
     'git init' since you already have a repo..."

User: "Done"

AI: "Let me check... Looks good. Next, we need to clean up
     the boilerplate..."
AI：“第一步：初始化Next.js。当前目录已有一些文档，我们先临时移走它们……”

用户：“--no-git参数有什么作用？”

AI：“好问题！它会告诉create-next-app跳过执行'git init'，因为你已经有一个代码仓库了……”

用户：“完成了”

AI：“我检查一下……看起来没问题。接下来，我们需要清理样板代码……”

Guidance Style

指导风格

  • Explains WHAT to do - Clear instructions per step
  • Answers questions - Responds to clarifications
  • Checks your work - Reviews when you say "done"
  • Adapts pace - Moves forward when ready
  • Practical focus - Task-focused, not teaching concepts
  • 明确告知操作内容 - 每一步都有清晰的指令
  • 解答疑问 - 回应你的澄清请求
  • 检查工作成果 - 当你说“完成”时进行审核
  • 适配节奏 - 准备就绪后进入下一步
  • 注重实用性 - 聚焦任务本身，不教授概念

Execution Flow

执行流程

1. Load Context

1. 加载上下文

bash
Read: ideas/[project]/issues/###-*/TASK.md
Read: ideas/[project]/issues/###-*/PLAN.md
Read: ideas/[project]/specs/SPEC-###.md (if linked)
Glob: spaces/[project]/docs/project/adrs/ADR-*.md
bash
读取: ideas/[project]/issues/###-*/TASK.md
读取: ideas/[project]/issues/###-*/PLAN.md
读取: ideas/[project]/specs/SPEC-###.md（如果已关联）
全局匹配: spaces/[project]/docs/project/adrs/ADR-*.md

2. Conversational Guidance

2. 对话式指导

  1. Explain the current step simply
  2. Wait for user questions or confirmation
  3. Answer questions as they come up
  4. Check work when user says "done"
  5. Move to next step when ready
  1. 简洁解释当前步骤
  2. 等待你的提问或确认
  3. 随时解答你的疑问
  4. 当你说“完成”时检查工作成果
  5. 准备就绪后进入下一步

3. Research as Needed

3. 按需调研

  • Use Context7 for library docs
  • WebSearch for best practices
  • Reference codebase patterns
  • 使用Context7查阅库文档
  • 通过WebSearch获取最佳实践
  • 参考代码库模式

4. Check Work

4. 工作成果检查

When user says "done":
  • Read the modified file
  • Check for common mistakes
  • Verify it matches requirements
  • Suggest fixes if needed
当你说“完成”时：
  • 读取修改后的文件
  • 检查常见错误
  • 验证是否符合需求
  • 如有需要，建议修复方案

5. Update WORKLOG

5. 更新工作日志

At checkpoints:
markdown
undefined
在检查点：
markdown
undefined

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

YYYY-MM-DD HH:MM - 指导记录：第一阶段完成

Guided user through Next.js initialization. Completed: ... Next: Phase 2
undefined
指导用户完成Next.js初始化。 已完成：…… 下一步：第二阶段
undefined

When to Use

使用场景

  • Know the stack, need guidance on THIS task
  • Want control but avoid mistakes
  • Prefer hands-on implementation
  • Task has complexity worth discussing
Use /implement instead: Just want it done quickly, boilerplate code Use /teach instead: Learning the technology, need conceptual understanding
  • 熟悉技术栈，需要针对当前任务的指导
  • 想要掌控任务但避免出错
  • 偏好亲手实践实现
  • 任务具有值得讨论的复杂性
建议使用/implement替代：只想快速完成任务，处理样板代码 建议使用/teach替代：学习技术，需要理解概念

Workflow

工作流

/issue -> /plan -> /advise -> [you implement] -> /worklog -> /commit
/issue -> /plan -> /advise -> [你进行实现] -> /worklog -> /commit