Appearance
⚡ SpecFlow AI Agent 技能架构、命名规范与智能交互沉淀指南
文档标识：
KB-SPECFLOW-20260812
更新主题：specflow-命名空间前缀 /Interactive Clarification Loop智能澄清循环 / 全局双向软链接与生态分发
📌 一、 SpecFlow AI 技能与 CLI 命令对比剖析
| 对比维度 | 技能指令 /specflow-specify (AI Chat 中) | CLI 命令 specflow specify (Terminal 中) |
|---|---|---|
| 驱动引擎 | AI Agent 大脑 Reasoning 深度推理 + CLI 物理落地 | 确定性 Node.js 物理引擎 (+ 本地 AI 润色) |
| 需求扩展能力 | 极强 (大模型自动扩充)：哪怕用户只说了一句话，Agent 会结合工程上下文与 CodeGraph 自动补全逼真 JSON Schema、UI 阻断规则与 AC 验收标准。 | 确定性格式化转换：严格根据命令行输入的 --description 或美事文档原文进行结构化格式化落盘。 |
| 交互与对齐 | 主动启动澄清问询与多轮 Confirm：发现信息密度较低或有歧义时，主动提问 1~3 个关键切面。 | 单向确定性输出：以命令行参数或终端 Inquirer 问答方式完成物理落盘。 |
| ** Token 消耗** | 消耗当前 AI IDE (Claude Code/Codex/Cursor) 的对话 Token。 | 本地毫秒级完成，极低/零 Token 消耗。 |
📌 二、 specflow- 强命名空间规范与 8 大快捷指令集
为了防止与通用 AI 技能（如 /review、/plan、/init）产生名称碰撞，SpecFlow 统一采用 specflow-<action> 前缀命名空间：
| 斜杠技能名 | CLI 对应指令 | 核心功能与推理动作 |
|---|---|---|
/specflow-init | specflow init | 物理隔离 Sibling 双仓与 VitePress 架构站点初始化 |
/specflow-specify | specflow specify | 智能澄清问询 + 5 维高保真 SDD 需求规格书生成 |
/specflow-plan | specflow plan | 基于 CodeGraph 的架构拆解与非破坏性逻辑补丁设计 |
/specflow-task | specflow task | 物理真实业务源码落地与硬拦截逻辑植入 |
/specflow-testcase | specflow testcase | 自动化生成单元测试与验收用例矩阵 |
/specflow-review | specflow review | 执行零依赖 P1~P7 阶段门禁审计与静态打分 |
/specflow-mr | specflow mr | 自动化生成 Discussion 审查复盘并物理发起 MR |
/specflow-sddx | specflow sddx | 一键自动化贯穿 P1 ~ P5 全流程 |
📌 三、 /specflow-specify 智能澄清与对齐循环 (Interactive Clarification Loop)
当用户仅提供粗颗粒度想法（如 “想加个快递费拦截”）时，技能会主动启动 4 步澄清流程，彻底告别空模板：
📌 四、 工作区根目录建仓与全平台双向软链接
- 统一复数
.agents：所有规范仓与工作区统一采用全网标准复数.agents目录； - 工作区根软链映射：
specflow init会全自动在根工作区建好.agents/，并将子技能全量软链接至.agents/skills/； - 家目录全网注册：自动向
~/.gemini/config/skills/与~/.claude/skills/写入软链，实现跨项目跨 IDE 100% 弹出斜杠菜单。