📄 本页由源文件
skills/dev-flow/references/interaction-mode.md自动投影生成(单一权威源)。请勿直接编辑本页。
精简交互模式(Interaction Mode)
替代"自动驾驶"模式。核心理念:减少交互次数,但不跳过任何步骤。 按风险等级分级处理交互点,让用户只在关键决策点介入。
交互模式定义
| 模式 | 标识 | 交互次数 | 适用场景 |
|---|---|---|---|
| 标准模式 | interaction: standard | 4~7 次 | 默认模式,关键交互点暂停等待用户 |
| 精简模式 | interaction: streamlined | 2~3 次 | 用户信任度高 / 简单任务 / 用户主动选择 |
触发方式
⚠️ 2026-06-01 改版重要前提:以下"自然语言"修饰层切换仅在 dev-flow 已激活的流程内生效。 普通对话(dev-flow 未激活)中说「少问我」「你决定就好」等不会触发任何行为,也不会自动启动 dev-flow。 要启动 dev-flow 必须用显式命令(详见
SKILL.md§「触发规则」)。
| 用户说的话 | 模式 | 生效场景 |
|---|---|---|
dev: --fast / dev-flow --fast(与命令组合) | 精简模式 | 启动 dev-flow 时的命令修饰 |
默认(命令未带 --fast) | 标准模式 | 启动 dev-flow 时 |
切换精简模式 / 少问我 / 你决定就好 / 你自己判断就行 / 别老问我 | 运行中切换为精简模式 | 仅 dev-flow 已激活流程内 |
切换标准模式 / 每步都问我 / 我要确认 / 多问我 | 运行中切换为标准模式 | 仅 dev-flow 已激活流程内 |
📌 同义词集合维持单一真相源:完整触发关键词清单同步于
references/mode-matrix.md§九「修饰层」与steps/step-router.md§「口语意图消歧规则」,三处必须保持一致。
交互点风险分级
🔴 关键决策点(两种模式都必须暂停等待用户)
| 步骤 | 交互点 | 原因 |
|---|---|---|
| 步骤 4 | 范围+方案确认+执行决策 | 方向错误 → 全部返工 |
| 步骤 7 | Commit Message 确认 | 进入 git 历史,不可逆 |
步骤 2+3+4 合并展示:步骤 2(范围)和步骤 3(方案)仍完整执行,但合并到步骤 4 一次性展示给用户确认。 用户在步骤 4 一次性确认"范围+方案",如有异议可说"范围需要调整"或"方案需要修改"。 这减少了 2 次中间确认交互,但不跳过任何分析步骤。
🟡 质量决策点(精简模式下智能默认,异常时才打断)
| 步骤 | 交互点 | 标准模式行为 | 精简模式行为 |
|---|---|---|---|
| 步骤 3 | 方案展示 | 暂停等用户确认 | 展示方案但自动进入步骤4(方案只有1个时) |
| 步骤 5.5 | L1 审查 🟡 项 | 逐项询问 | 自动修复所有 🟡 项 |
| 步骤 6 | 验证结果 | 暂停展示报告 | 全部通过→一行摘要继续;有失败→暂停 |
| 步骤 7 | L2 审查 🟡 项 | 合并审查报告(见下方) | 自动修复所有 🟡 项 |
| 步骤 7 | 规范沉淀确认 | 展示+确认 | 自动沉淀,完成后简要告知 |
| 收尾环节 B | 清理检查 | 逐项确认 | 自动全部清理 |
| 收尾环节 G | L2 审查 🟡 项 | 合并审查报告 | 自动修复所有 🟡 项 |
🟢 流程决策点(精简模式下一行摘要,标准模式简要告知)
| 步骤 | 交互点 | 标准模式行为 | 精简模式行为 |
|---|---|---|---|
| 步骤 1 | 研究结果展示 | 展示文件表格 | 一行摘要:✅ 步骤1完成:定位到 N 个相关文件 |
| 步骤 4.5 | 环境检查结果 | 简要告知 | 一行摘要(异常时才暂停) |
| 步骤 5.5 | 文档同步 | 简要告知 | 一行摘要 |
| 步骤 7 | 清理结果 | 简要告知 | 一行摘要 |
合并审查报告(步骤 7 交互优化)
步骤 7 的环节 A~E 静默执行,与环节 G(L2 审查)合并为一次"清理与审查报告":
📌 强制:改动汇总表格的「文件」列必须按 AI 行为规范「文件/代码位置引用」使用反引号包裹相对路径格式(
`相对路径`);问题定位若涉及具体行号,必须附空格后缀L行号。
## 📋 清理与审查报告
### 改动汇总(从工作上下文步骤清单提取)
| 文件 | 操作 | 改动说明 |
| --- | --- | --- |
| `{相对路径}` | 修改 | 说明 |
### 清理结果
- ✅ 预期外变更:无
- ✅ 调试代码:清理了 2 处 console.log
- ✅ 可选链检查:优化了 3 处链式调用
- ✅ 即时验证:lint 通过
### L2 审查结果
- 🔴 必须修复(已自动修复):1 项
- 🟡 建议修复:2 项
1. xxx
2. xxx
- 🟢 提示:1 项
请选择:
**A.** 🔧 修复所有 🟡 建议项
**B.** ⏭️ 跳过 🟡 项,直接生成 commit
**C.** ✏️ 部分修复(告诉我修哪几项)当清理结果全部 ✅ 且 L2 审查无 🟡 项时,精简模式下合并为一行摘要:
✅ 清理+L2审查完成:清理 2 项,审查通过,无需用户决策
精简模式的安全保障
| 保障机制 | 说明 |
|---|---|
| 步骤完整性 | 所有步骤仍按顺序执行,完成标记 JSON 仍必须输出 |
| 门控不降级 | gate-validator.md 的校验规则不因模式变化而放松 |
| 🔴 不可跳过 | 关键决策点在任何模式下都必须暂停等待用户 |
| 异常升级 | 精简模式下遇到异常自动升级为标准模式交互 |
| 随时切换 | 用户可在任何步骤中途切换模式,立即生效 |
| 步骤完成反馈 | 精简模式下仍输出一行摘要反馈(如 ✅ 步骤N完成:...),不完全静默 |
工作上下文集成
交互模式记录在工作上下文 YAML 头部的 interaction_mode 字段:
---
interaction_mode: streamlined # standard | streamlined
---