Back to Details

bmad-advanced-elicitation

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Advanced Elicitation

高级引导

Goal: Push the LLM to reconsider, refine, and improve its recent output.
目标： 推动LLM重新考量、优化并改进其近期输出。

CRITICAL LLM INSTRUCTIONS

关键LLM指令

  • MANDATORY: Execute ALL steps in the flow section IN EXACT ORDER
  • DO NOT skip steps or change the sequence
  • HALT immediately when halt-conditions are met
  • Each action within a step is a REQUIRED action to complete that step
  • Sections outside flow (validation, output, critical-context) provide essential context - review and apply throughout execution
  • YOU MUST ALWAYS SPEAK OUTPUT in your Agent communication style with the 
    communication_language
  • 强制要求： 严格按照顺序执行流程部分的所有步骤
  • 不得跳过步骤或更改顺序
  • 满足终止条件时立即停止
  • 步骤内的每项操作都是完成该步骤的必填操作
  • 流程外的部分（验证、输出、关键上下文）提供了核心上下文信息——执行全程需查阅并遵循
  • 必须始终以Agent的沟通风格，使用
    communication_language
    指定的语言输出内容

INTEGRATION (When Invoked Indirectly)

集成（间接调用场景）

When invoked from another prompt or process:
  1. Receive or review the current section content that was just generated
  2. Apply elicitation methods iteratively to enhance that specific content
  3. Return the enhanced version back when user selects 'x' to proceed and return back
  4. The enhanced content replaces the original section content in the output document
当从其他提示词或流程调用时：
  1. 接收或查阅刚刚生成的当前章节内容
  2. 迭代应用引导方法来优化该特定内容
  3. 当用户选择'x'继续并返回时，回传优化后的版本
  4. 优化后的内容将替换输出文档中原章节的内容

FLOW

执行流程

Step 1: Method Registry Loading

步骤1：加载方法库

Action: Load and read 
./methods.csv
and '{project-root}/_bmad/_config/agent-manifest.csv'
操作： 加载并读取
./methods.csv
和
{project-root}/_bmad/_config/agent-manifest.csv

CSV Structure

CSV结构

  • category: Method grouping (core, structural, risk, etc.)
  • method_name: Display name for the method
  • description: Rich explanation of what the method does, when to use it, and why it's valuable
  • output_pattern: Flexible flow guide using arrows (e.g., "analysis -> insights -> action")
  • category： 方法分组（核心、结构、风险等）
  • method_name： 方法的展示名称
  • description： 关于方法作用、适用场景、价值的详细说明
  • output_pattern： 使用箭头表示的灵活流程指南（例如："analysis -> insights -> action"）

Context Analysis

上下文分析

  • Use conversation history
  • Analyze: content type, complexity, stakeholder needs, risk level, and creative potential
  • 参考对话历史
  • 分析维度：内容类型、复杂度、干系人需求、风险等级、创意潜力

Smart Selection

智能选法

  1. Analyze context: Content type, complexity, stakeholder needs, risk level, creative potential
  2. Parse descriptions: Understand each method's purpose from the rich descriptions in CSV
  3. Select 5 methods: Choose methods that best match the context based on their descriptions
  4. Balance approach: Include mix of foundational and specialized techniques as appropriate
  1. 分析上下文：内容类型、复杂度、干系人需求、风险等级、创意潜力
  2. 解析描述：从CSV的详细说明中理解每种方法的用途
  3. 选择5种方法：根据方法描述选择最匹配上下文的方法
  4. 平衡策略：按需结合基础技术和专业技术

Step 2: Present Options and Handle Responses

步骤2：展示选项并处理响应

Display Format

展示格式

**Advanced Elicitation Options**
_If party mode is active, agents will join in._
Choose a number (1-5), [r] to Reshuffle, [a] List All, or [x] to Proceed:

1. [Method Name]
2. [Method Name]
3. [Method Name]
4. [Method Name]
5. [Method Name]
r. Reshuffle the list with 5 new options
a. List all methods with descriptions
x. Proceed / No Further Actions
**Advanced Elicitation Options**
_If party mode is active, agents will join in._
Choose a number (1-5), [r] to Reshuffle, [a] List All, or [x] to Proceed:

1. [Method Name]
2. [Method Name]
3. [Method Name]
4. [Method Name]
5. [Method Name]
r. Reshuffle the list with 5 new options
a. List all methods with descriptions
x. Proceed / No Further Actions

Response Handling

响应处理

Case 1-5 (User selects a numbered method):
  • Execute the selected method using its description from the CSV
  • Adapt the method's complexity and output format based on the current context
  • Apply the method creatively to the current section content being enhanced
  • Display the enhanced version showing what the method revealed or improved
  • CRITICAL: Ask the user if they would like to apply the changes to the doc (y/n/other) and HALT to await response.
  • CRITICAL: ONLY if Yes, apply the changes. IF No, discard your memory of the proposed changes. If any other reply, try best to follow the instructions given by the user.
  • CRITICAL: Re-present the same 1-5,r,x prompt to allow additional elicitations
Case r (Reshuffle):
  • Select 5 random methods from methods.csv, present new list with same prompt format
  • When selecting, try to think and pick a diverse set of methods covering different categories and approaches, with 1 and 2 being potentially the most useful for the document or section being discovered
Case x (Proceed):
  • Complete elicitation and proceed
  • Return the fully enhanced content back to the invoking skill
  • The enhanced content becomes the final version for that section
  • Signal completion back to the invoking skill to continue with next section
Case a (List All):
  • List all methods with their descriptions from the CSV in a compact table
  • Allow user to select any method by name or number from the full list
  • After selection, execute the method as described in the Case 1-5 above
Case: Direct Feedback:
  • Apply changes to current section content and re-present choices
Case: Multiple Numbers:
  • Execute methods in sequence on the content, then re-offer choices
场景1-5（用户选择编号对应的方法）：
  • 参照CSV中的描述执行选中的方法
  • 基于当前上下文调整方法的复杂度和输出格式
  • 创造性地将方法应用到当前正在优化的章节内容上
  • 展示优化后的版本，说明该方法发现的问题或带来的改进
  • 关键要求： 询问用户是否要将更改应用到文档中（y/n/其他），并终止操作等待响应
  • 关键要求： 仅当用户选择是时应用更改。如果选择否，清除你关于拟议更改的记忆。如果是其他回复，尽量遵循用户给出的指令
  • 关键要求： 重新展示相同的1-5、r、x选项提示，以支持进行更多引导操作
场景r（重新生成列表）：
  • 从methods.csv中随机选择5种方法，使用相同的提示格式展示新列表
  • 选择时尽量挑选覆盖不同类别和方法的多样化组合，其中1和2号方法应当是对当前正在处理的文档或章节最可能有用的选项
场景x（继续）：
  • 完成引导流程并继续后续操作
  • 将完全优化后的内容回传给调用的skill
  • 优化后的内容将成为该章节的最终版本
  • 向调用的skill发送完成信号，继续处理下一个章节
场景a（列出全部）：
  • 以紧凑表格形式列出CSV中所有方法及其描述
  • 允许用户从完整列表中按名称或编号选择任意方法
  • 选择完成后，按照上述场景1-5的说明执行方法
场景：直接反馈：
  • 将更改应用到当前章节内容，然后重新展示选项
场景：选择多个编号：
  • 按顺序对内容执行选中的方法，然后重新提供选项

Step 3: Execution Guidelines

步骤3：执行指南

  • Method execution: Use the description from CSV to understand and apply each method
  • Output pattern: Use the pattern as a flexible guide (e.g., "paths -> evaluation -> selection")
  • Dynamic adaptation: Adjust complexity based on content needs (simple to sophisticated)
  • Creative application: Interpret methods flexibly based on context while maintaining pattern consistency
  • Focus on actionable insights
  • Stay relevant: Tie elicitation to specific content being analyzed (the current section from the document being created unless user indicates otherwise)
  • Identify personas: For single or multi-persona methods, clearly identify viewpoints, and use party members if available in memory already
  • Critical loop behavior: Always re-offer the 1-5,r,a,x choices after each method execution
  • Continue until user selects 'x' to proceed with enhanced content, confirm or ask the user what should be accepted from the session
  • Each method application builds upon previous enhancements
  • Content preservation: Track all enhancements made during elicitation
  • Iterative enhancement: Each selected method (1-5) should:
    1. Apply to the current enhanced version of the content
    2. Show the improvements made
    3. Return to the prompt for additional elicitations or completion
  • 方法执行： 参照CSV中的描述理解并应用每种方法
  • 输出模式： 将模式作为灵活指南使用（例如："paths -> evaluation -> selection"）
  • 动态适配： 根据内容需求调整复杂度（从简单到复杂）
  • 创造性应用： 在保持模式一致性的前提下，根据上下文灵活解读方法
  • 聚焦可落地的洞察
  • 保持相关性： 将引导操作与正在分析的特定内容绑定（除非用户另有说明，否则指正在创建的文档的当前章节）
  • 识别角色： 对于单人或多角色方法，明确识别不同视角，如果记忆中已存在团队成员则可调用
  • 关键循环逻辑： 每次执行完方法后，始终重新提供1-5、r、a、x选项
  • 持续执行直到用户选择'x'继续使用优化后的内容，确认或询问用户本次会话中哪些内容应当被采纳
  • 每次方法应用都基于之前的优化结果构建
  • 内容留存： 记录引导过程中做出的所有优化
  • 迭代优化： 每个选中的方法（1-5）应当：
    1. 应用到当前已优化的内容版本上
    2. 展示做出的改进
    3. 返回提示以进行更多引导操作或结束流程