Skip to content

📄 本页由源文件 skills/dev-flow/references/interaction-mode.md 自动投影生成(单一权威源)。请勿直接编辑本页。

精简交互模式(Interaction Mode)

替代"自动驾驶"模式。核心理念:减少交互次数,但不跳过任何步骤。 按风险等级分级处理交互点,让用户只在关键决策点介入。

交互模式定义

模式标识交互次数适用场景
标准模式interaction: standard4~7 次默认模式,关键交互点暂停等待用户
精简模式interaction: streamlined2~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范围+方案确认+执行决策方向错误 → 全部返工
步骤 7Commit Message 确认进入 git 历史,不可逆

步骤 2+3+4 合并展示:步骤 2(范围)和步骤 3(方案)仍完整执行,但合并到步骤 4 一次性展示给用户确认。 用户在步骤 4 一次性确认"范围+方案",如有异议可说"范围需要调整"或"方案需要修改"。 这减少了 2 次中间确认交互,但不跳过任何分析步骤。

🟡 质量决策点(精简模式下智能默认,异常时才打断)

步骤交互点标准模式行为精简模式行为
步骤 3方案展示暂停等用户确认展示方案但自动进入步骤4(方案只有1个时)
步骤 5.5L1 审查 🟡 项逐项询问自动修复所有 🟡 项
步骤 6验证结果暂停展示报告全部通过→一行摘要继续;有失败→暂停
步骤 7L2 审查 🟡 项合并审查报告(见下方)自动修复所有 🟡 项
步骤 7规范沉淀确认展示+确认自动沉淀,完成后简要告知
收尾环节 B清理检查逐项确认自动全部清理
收尾环节 GL2 审查 🟡 项合并审查报告自动修复所有 🟡 项

🟢 流程决策点(精简模式下一行摘要,标准模式简要告知)

步骤交互点标准模式行为精简模式行为
步骤 1研究结果展示展示文件表格一行摘要:✅ 步骤1完成:定位到 N 个相关文件
步骤 4.5环境检查结果简要告知一行摘要(异常时才暂停)
步骤 5.5文档同步简要告知一行摘要
步骤 7清理结果简要告知一行摘要

合并审查报告(步骤 7 交互优化)

步骤 7 的环节 A~E 静默执行,与环节 G(L2 审查)合并为一次"清理与审查报告":

📌 强制:改动汇总表格的「文件」列必须按 AI 行为规范「文件/代码位置引用」使用反引号包裹相对路径格式(`相对路径`);问题定位若涉及具体行号,必须附空格后缀 L行号

markdown

## 📋 清理与审查报告

### 改动汇总(从工作上下文步骤清单提取)
| 文件 | 操作 | 改动说明 |
| --- | --- | --- |
| `{相对路径}` | 修改 | 说明 |

### 清理结果
- ✅ 预期外变更:无
- ✅ 调试代码:清理了 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 字段:

yaml
---
interaction_mode: streamlined  # standard | streamlined
---

基于「单一权威源」哲学构建 —— 文档由源文件投影生成