Requirement Agent
轻量级需求澄清 + 执行前确认控制。
与 brainstorming 的区分
| 场景 | Skill |
|---|
| "帮我设计一个微服务架构" | brainstorming — 10+ 轮深度追问,强制设计流程,输出 design doc |
| "帮我优化一下这个函数" |
requirement-agent — 3-5 轮快速澄清,方案确认后执行 |
| "帮我重构用户模块" |
requirement-agent — 追问澄清范围,执行前确认 |
| "帮我写一个支付系统" |
brainstorming — 复杂系统,需要完整设计 |
触发场景
使用 requirement-agent 当:
- - 用户说"优化一下"、"重构"、"改进"
- 用户说"加个注释"、"格式化"
- 用户说"帮我改改这个文件"
- 用户说"删掉 XXX"、"重命名 YYY"
- 任何日常代码任务,而非全新系统设计
触发 brainstorming 当:
- - 用户说"帮我设计 XXX"
- 用户说"帮我规划 XXX"
- 用户说"帮我创建一个新系统"
- 需求涉及全新架构、技术选型、多模块协调
工作流程
1. 需求澄清(Questioning)
当检测到模糊需求时,按 references/questioning-guide.md 进行追问:
- - 第一轮:结构化快速确认(多选题)
- 第 2-3 轮:针对模糊点深入提问
- 第 4-5 轮:查漏补缺
跳过条件:需求已足够明确(包含具体文件、目标、技术栈)
2. 执行前确认(Confirmation)
根据 config/rules.yaml 判断是否需要确认:
自动执行(无需确认):
- - 纯文本修改(注释、格式化)
- 单文件小改动
- 明确安全的操作(如"加注释"、"格式化")
需要确认:
- - 多文件修改(2+ 文件)
- 删除操作
- 逻辑变更
- 添加依赖
- 不可逆操作
3. 方案展示(可选)
如果需要确认但情况复杂,先展示方案再执行:
CODEBLOCK0
配置文件
规则定义:config/rules.yaml
配置说明: INLINECODE3
参考文档
- -
references/questioning-guide.md - 追问流程详解 - INLINECODE5 - 配置文件说明
技能名称: requirement-agent
详细描述:
需求代理
轻量级需求澄清 + 执行前确认控制。
与头脑风暴的区分
| 场景 | 技能 |
|---|
| 帮我设计一个微服务架构 | 头脑风暴 — 10+ 轮深度追问,强制设计流程,输出设计文档 |
| 帮我优化一下这个函数 |
需求代理 — 3-5 轮快速澄清,方案确认后执行 |
| 帮我重构用户模块 |
需求代理 — 追问澄清范围,执行前确认 |
| 帮我写一个支付系统 |
头脑风暴 — 复杂系统,需要完整设计 |
触发场景
使用需求代理当:
- - 用户说优化一下、重构、改进
- 用户说加个注释、格式化
- 用户说帮我改改这个文件
- 用户说删掉 XXX、重命名 YYY
- 任何日常代码任务,而非全新系统设计
触发头脑风暴当:
- - 用户说帮我设计 XXX
- 用户说帮我规划 XXX
- 用户说帮我创建一个新系统
- 需求涉及全新架构、技术选型、多模块协调
工作流程
1. 需求澄清(提问)
当检测到模糊需求时,按 references/questioning-guide.md 进行追问:
- - 第一轮:结构化快速确认(多选题)
- 第 2-3 轮:针对模糊点深入提问
- 第 4-5 轮:查漏补缺
跳过条件:需求已足够明确(包含具体文件、目标、技术栈)
2. 执行前确认(确认)
根据 config/rules.yaml 判断是否需要确认:
自动执行(无需确认):
- - 纯文本修改(注释、格式化)
- 单文件小改动
- 明确安全的操作(如加注释、格式化)
需要确认:
- - 多文件修改(2+ 文件)
- 删除操作
- 逻辑变更
- 添加依赖
- 不可逆操作
3. 方案展示(可选)
如果需要确认但情况复杂,先展示方案再执行:
🤔 在执行之前,我想确认一下:
📝 变更摘要:
- - 文件:A.js(第 10-15 行)
- 操作:将 foo() 改为 bar()
✅ 确认执行?
[继续执行] [修改方案] [取消]
配置文件
规则定义:config/rules.yaml
配置说明:references/config-guide.md
参考文档
- - references/questioning-guide.md - 追问流程详解
- references/config-guide.md - 配置文件说明