speccore 8.3.189 → 8.3.191

package/dist/core/agents/defaults/_INDEX.md

@@ -0,0 +1,68 @@
+# AGENTS 注册表
+
+> 本文件定义各命令/阶段下激活的 Agent 列表。
+> 新增角色后，在本文件中添加一行即可挂载到对应流程。
+
+---
+
+## analyze / clarify
+
+| 角色 | 优先级 | 条件 | 说明 |
+|------|--------|------|------|
+| product-analyst | 100 | — | 业务流程完整性、遗漏识别、术语统一 |
+| interaction-designer | 90 | — | 交互状态矩阵、前后端一致性、用户路径（叠加 RULES/ 技术栈交互约束） |
+| security-reviewer | 70 | project.securityLevel > 2 | 需求中的安全风险预判（叠加 RULES/ 技术栈安全规则） |
+
+## analyze / confirm-check
+
+| 角色 | 优先级 | 条件 | 说明 |
+|------|--------|------|------|
+| product-analyst | 100 | — | 最终确认清单 |
+
+## split / default
+
+| 角色 | 优先级 | 条件 | 说明 |
+|------|--------|------|------|
+| task-decomposer | 100 | — | 任务拆分专家 |
+| dependency-analyst | 90 | — | 依赖关系分析（叠加 RULES/ 技术栈依赖模式） |
+| effort-estimator | 70 | — | 工时估算 |
+
+## plan / default
+
+| 角色 | 优先级 | 条件 | 说明 |
+|------|--------|------|------|
+| schedule-planner | 100 | — | 排期规划 |
+| risk-assessor | 90 | — | 风险评估 |
+
+## execute / quality-gate
+
+| 角色 | 优先级 | 条件 | 说明 |
+|------|--------|------|------|
+| compiler | 100 | — | 编译可行性检查（叠加 RULES/ 技术栈构建规则） |
+| test-engineer | 90 | — | 单元测试执行与覆盖率（叠加 RULES/ 技术栈测试规范） |
+| security-reviewer | 80 | — | 安全漏洞扫描（叠加 RULES/ 技术栈安全规则） |
+| performance-expert | 50 | — | 性能回归检测（叠加 RULES/ 技术栈性能规范） |
+| doc-sync-agent | 40 | — | 文档与实际代码一致性（叠加 RULES/ 技术栈文档格式） |
+
+## change / impact
+
+| 角色 | 优先级 | 条件 | 说明 |
+|------|--------|------|------|
+| impact-analyst | 100 | — | 变更影响范围分析（叠加 RULES/ 技术栈模块结构） |
+| regression-tester | 80 | — | 回归测试范围（叠加 RULES/ 技术栈测试策略） |
+
+## pr / review
+
+| 角色 | 优先级 | 条件 | 说明 |
+|------|--------|------|------|
+| code-reviewer | 100 | — | 代码质量审查（叠加 RULES/ 技术栈编码规范） |
+| security-reviewer | 90 | — | 安全审查（叠加 RULES/ 技术栈安全规则） |
+| test-reviewer | 80 | — | 测试完整性审查（叠加 RULES/ 技术栈测试规范） |
+
+## audit / default
+
+| 角色 | 优先级 | 条件 | 说明 |
+|------|--------|------|------|
+| security-reviewer | 100 | — | 安全审计（叠加 RULES/ 技术栈安全规则） |
+| compliance-checker | 90 | project.industry == 'finance' | 合规检查（金融行业） |
+| performance-expert | 70 | — | 性能基线审计（叠加 RULES/ 技术栈性能规范） |

package/dist/core/ask-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ask-engine.d.ts","sourceRoot":"","sources":["../../src/core/ask-engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,aAAa;AACb,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC;AAE/E,aAAa;AACb,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,kBAAkB;AAClB,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,kBAAkB;AAClB,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,aAAa;AACb,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACjE;AAED,eAAe;AACf,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD,QAAA,MAAM,UAAU,EAAE,gBAAgB,EA0EjC,CAAC;AA2FF,QAAA,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAgD7C,CAAC;AAMF,iBAAiB;AACjB,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CA0CnD;AAkuBD,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CAqJ7F;AA4OD,uCAAuC;AACvC,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA4BjD;AAED,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"ask-engine.d.ts","sourceRoot":"","sources":["../../src/core/ask-engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,aAAa;AACb,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC;AAE/E,aAAa;AACb,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,kBAAkB;AAClB,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,kBAAkB;AAClB,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,aAAa;AACb,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACjE;AAED,eAAe;AACf,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD,QAAA,MAAM,UAAU,EAAE,gBAAgB,EA0EjC,CAAC;AA2FF,QAAA,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAgD7C,CAAC;AAMF,iBAAiB;AACjB,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CA2DnD;AA4xBD,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CAqJ7F;AA4OD,uCAAuC;AACvC,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA4BjD;AAED,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC"}

package/dist/core/ask-engine.js

@@ -21,7 +21,7 @@ const knowledge_graph_1 = require("./knowledge-graph");
 // ============================================================
 const COMMAND_KB = [
     { name: 'init', aliases: ['in'], description: '初始化 SpecCore 项目，创建 .speccore 目录和配置',
-        usage: 'speccore init [--interactive] [--name <name>]', examples: ['speccore init', 'speccore init --name my-project'], related: ['dev', 'config'], triggers: ['初始化', 'init', '开始', '新建项目', '创建项目'] },
+        usage: 'speccore init [--interactive] [--name <name>]', examples: ['speccore init', 'speccore init --name my-project'], related: ['run', 'config'], triggers: ['初始化', 'init', '开始', '新建项目', '创建项目'] },
     { name: 'doc2spec', aliases: ['d2s'], description: '导入 PRD/Word 文档，AI + Pandoc 双路转换为 SpecCore MD。--classify 智能分类 sources/ 文档到 staging/（按类型提取 feature/bug/refactor/research）',
         usage: 'speccore doc2spec -f <file> --iter <iteration> [--task <task>] [--no-ai] [--classify [--prompt] [--response <json>]]', examples: ['speccore doc2spec -f PRD.docx --iter Q3', 'speccore doc2spec -f 需求.docx --iter Q2 --task T-01 --no-ai', 'speccore doc2spec --classify --prompt -I Q3', 'speccore doc2spec --classify -I Q3'], related: ['spec2doc', 'analyze'], triggers: ['导入', 'doc2spec', 'word转', '文档转换', 'PRD', '需求文档', '智能分类', 'classify', '分类文档', '提取需求'] },
     { name: 'spec2doc', aliases: ['s2d'], description: 'SpecCore MD 导出为 Word/PDF/HTML/PPTX',
@@ -31,7 +31,7 @@ const COMMAND_KB = [
     { name: 'analyze', aliases: ['al'], description: '统一分析：需求文档+源码→分析报告。支持 --full 三阶段合成，--deep 单文档深度分析（字数/图表翻倍），--iterative 迭代式生成（大纲→逐节填充），--filter 按需分析指定模块，--with-code 注入代码结构化数据，--phase 单阶段合成，--feature 局部分析功能模块，--doc 局部分析类型文档，--sync 任务分析后局部回写 020-specs/，--no-source 跳过源码，--supplement 追加源码',
         usage: 'speccore analyze [--task <id>] [--iteration <name>] [--full] [--deep <doc>] [--iterative] [--filter <keywords>] [--with-code] [--phase <n>] [--feature <module>] [--doc <type/slug>] [--no-source] [--source-scope <dirs>] [--supplement] [--sync] [--scope global] [--dev-guide]', examples: ['speccore analyze', 'speccore analyze --full -i Q2', 'speccore analyze --deep ARCHITECTURE.md --iterative', 'speccore analyze --filter "订单,支付" --with-code', 'speccore analyze --phase 1 -i Q2', 'speccore analyze --feature 支付模块', 'speccore analyze --doc bugs/login-timeout', 'speccore analyze --with-code', 'speccore analyze --supplement --source-scope src/core', 'speccore analyze --task Task-001 --apply "..." --sync'], related: ['dashboard', 'validate', 'code-index', 'refresh', 'synthesize'], triggers: ['分析', 'analyze', '审计', 'audit', '检查', '结合源码', '连代码', '带代码', '源码分析', '迭代分析', '分析迭代', '倒推需求', '反推', '从代码生成', '分析代码', '不读源码', '不读代码', '跳过源码', '指定目录分析', '只扫描', '补充分析', '追加分析', '补充源码', '追加源码', '遗漏', '没分析到', '没覆盖', '漏掉', '再分析', '多读几个', '局部分析', '单个模块', '单独分析', 'bug分析', '重构分析', '局部回写', '回写spec', '同步spec', '合成需求', '合并需求', '需求合成', '智能合成', '需求合并', '多端合成', '全量分析', '跨端综合', '全量合成', '开发指南', '生成开发指南', '带开发指南', '深度分析', '深入分析', '详细分析', '迭代生成', '逐节分析', '大纲分析', '按需分析', '只分析', '过滤分析', '聚焦分析'] },
     { name: 'code-index', aliases: ['ci', 'idx'], description: '源码索引：扫描项目代码，自动识别多端/模块/依赖，生成 Markdown 索引',
-        usage: 'speccore code-index [--full] [--scope <dirs>] [--show]', examples: ['speccore code-index', 'speccore code-index --full', 'speccore code-index --scope src/commands,src/core', 'speccore code-index --show'], related: ['analyze', 'dev'], triggers: ['代码索引', '源码索引', 'code-index', '索引', '建索引', '更新索引', '扫描代码', '代码结构', '模块索引', '项目结构'] },
+        usage: 'speccore code-index [--full] [--scope <dirs>] [--show]', examples: ['speccore code-index', 'speccore code-index --full', 'speccore code-index --scope src/commands,src/core', 'speccore code-index --show'], related: ['analyze', 'run'], triggers: ['代码索引', '源码索引', 'code-index', '索引', '建索引', '更新索引', '扫描代码', '代码结构', '模块索引', '项目结构'] },
     { name: 'execute', aliases: ['ex'], description: '执行开发任务：依赖排序+分批+交互引导+计划联动',
         usage: 'speccore execute [--task <id>] [--batch-size <n>] [--auto]', examples: ['speccore execute', 'speccore execute --batch-size 3'], related: ['plan', 'done'], triggers: ['执行', 'execute', '开发', '开始做', '干活'] },
     { name: 'plan', aliases: ['pl'], description: '生成执行计划+管理历史：创建/交互/列表/详情/取消',
@@ -46,21 +46,21 @@ const COMMAND_KB = [
     { name: 'validate', aliases: ['vl'], description: '合规验证：检查 Spec 完整性与一致性',
         usage: 'speccore validate [--iteration <name>]', examples: ['speccore validate', 'speccore validate --iteration Q2'], related: ['analyze', 'audit'], triggers: ['验证', 'validate', '检查', '合规', '校验'] },
     { name: 'sync', aliases: ['sy'], description: '双向同步：代码↔Spec，--global 同步到全局层（原 sync-global）',
-        usage: 'speccore sync [--task <id>] [--iteration <name>] [--global] [--direction to_global|from_global]', examples: ['speccore sync --task Task-001', 'speccore sync --global', 'speccore sync --global --direction from_global'], related: ['dev'], triggers: ['同步', 'sync', '对齐', '更新', '同步全量', '同步全局', '更新全量层', '同步到全量'] },
+        usage: 'speccore sync [--task <id>] [--iteration <name>] [--global] [--direction to_global|from_global]', examples: ['speccore sync --task Task-001', 'speccore sync --global', 'speccore sync --global --direction from_global'], related: ['run'], triggers: ['同步', 'sync', '对齐', '更新', '同步全量', '同步全局', '更新全量层', '同步到全量'] },
     { name: 'change', aliases: ['ch'], description: '需求变更：联动更新所有关联 Spec，支持口语化输入',
         usage: 'speccore change "<description>" [--task <id>]', examples: ['speccore change "把登录改成验证码登录"', 'speccore change "加上支付功能" --task T-03'], related: ['analyze'], triggers: ['变更', 'change', '修改', '改', '更新需求'] },
     { name: 'done', aliases: ['dn'], description: '收尾归档：校验→同步→审计，--all 批量归档',
         usage: 'speccore done [--task <id>] [--all] [--interactive]', examples: ['speccore done --task T-01', 'speccore done --all'], related: ['execute', 'pr'], triggers: ['完成', 'done', '归档', '结束', '做完'] },
-    { name: 'dev', aliases: ['d'], description: '智能级联：--auto 全自动流水线 detect→execute',
-        usage: 'speccore dev [--auto] [--from <phase>] [--to <phase>]', examples: ['speccore dev --auto', 'speccore dev --from analyze --to execute'], related: ['execute', 'plan'], triggers: ['dev', '流水线', '自动', '级联'] },
-    { name: 'run', aliases: ['r'], description: '端到端流水线：一句话需求→澄清→分析→拆分→执行→验证→部署（默认三闸口，--demo 放宽 A/B）',
-        usage: 'speccore run [需求描述] [--from <phase>] [--to <phase>] [--demo]', examples: ['speccore run "做用户积分功能"', 'speccore run --demo "做演示页面"', 'speccore run --from split'], related: ['dev', 'clarify', 'execute'], triggers: ['run', '跑一遍', '端到端', '全流程', '一键开发', '自动开发', '从头到尾', '完整流程'] },
+    { name: 'next', aliases: ['n'], description: '检测当前迭代进度，提示下一步操作（只指引，不执行）',
+        usage: 'speccore next [--iteration <name>]', examples: ['speccore next', 'speccore next -i Q2'], related: ['run', 'status'], triggers: ['下一步', '接下来', '该做什么', '接下来做什么', 'next', '做到哪了', '下一步做什么', '现在到哪了'] },
+    { name: 'run', aliases: ['r'], description: '端到端命名流水线：支持 preset（full/import/analyze/develop/deliver/deploy/docs）或起止点（--from/--to），默认 develop（分析→验证），三闸口',
+        usage: 'speccore run [--preset <name>] [--from <phase>] [--to <phase>] [--demo]', examples: ['speccore run --preset deploy', 'speccore run --from analyze --to execute', 'speccore run --demo'], related: ['next', 'req-doc', 'execute'], triggers: ['run', '跑一遍', '端到端', '全流程', '一键开发', '自动开发', '从头到尾', '完整流程', '全自动', '流水线'] },
     { name: 'task', aliases: ['tk'], description: '任务管理：创建/列表/状态。子命令: new, list, status',
         usage: 'speccore task new --name <name> [--id <id>] | speccore task list | speccore task status', examples: ['speccore task new --name "用户登录"', 'speccore task list'], related: ['plan', 'execute'], triggers: ['task', '任务列表', '查看任务', '列出任务'] },
     { name: 'iteration', aliases: ['it'], description: '迭代管理：创建时自动生成唯一编码（Iteration-001-功能名），支持拆分/列表',
         usage: 'speccore iteration create -n <name> | speccore iteration split | speccore iteration list', examples: ['speccore iteration create -n Q3 → Iteration-001-Q3', 'speccore iteration list'], related: ['task', 'plan'], triggers: ['迭代', 'iteration', '迭代', 'sprint'] },
     { name: 'context', aliases: ['ctx'], description: '查看/设置当前上下文：迭代、任务、阶段',
-        usage: 'speccore context [--set --iteration <name>] [--list]', examples: ['speccore context --list', 'speccore context --set --iteration Q1'], related: ['dashboard', 'dev'], triggers: ['切换', '上下文', 'context', '当前.*迭代', '设置.*迭代', '换到', '切换到'] },
+        usage: 'speccore context [--set --iteration <name>] [--list]', examples: ['speccore context --list', 'speccore context --set --iteration Q1'], related: ['dashboard', 'run'], triggers: ['切换', '上下文', 'context', '当前.*迭代', '设置.*迭代', '换到', '切换到'] },
     { name: 'search', aliases: ['sh'], description: '全文搜索：跨所有 Spec 文件关键词检索',
         usage: 'speccore search <query> [--task <id>] [--iteration <name>]', examples: ['speccore search "登录"', 'speccore search "支付" --iteration Q2'], related: ['track'], triggers: ['搜索', 'search', '查找', '检索', 'grep'] },
     { name: 'track', aliases: ['trk', 'tr'], description: 'REQ→Task→Code 全链路追踪（合并原 trace + tracker）',
@@ -86,9 +86,9 @@ const COMMAND_KB = [
         usage: 'speccore graph query <question> | speccore graph entity <id> | speccore graph related <id> | speccore graph path <from> <to> | speccore graph stats',
         examples: ['speccore graph query "订单相关代码"', 'speccore graph entity SRC:auth-AuthController', 'speccore graph related Task-001', 'speccore graph path Task-001 Task-002', 'speccore graph stats'], related: ['knowledge', 'code-index', 'search', 'track'], triggers: ['图谱', 'graph', '知识图谱', '代码图谱', '查询图谱', '图谱查询', '查图谱', '找关联', '找路径', '实体查询', '图谱统计'] },
     // v8.3.0+: 需求澄清
-    { name: 'clarify', aliases: ['cl'], description: '需求专业化：将口语化/非专业需求整理为 PRD 级文档。支持 --local 临时工作区模式',
-        usage: 'speccore clarify "<描述>" | clarify --from <file> [--to <iteration> | --local]',
-        examples: ['speccore clarify "我要加个购物车"', 'speccore clarify --from notes.md --local', 'speccore clarify --promote <entryId> --to <iteration>'], related: ['analyze', 'doc2spec'], triggers: ['澄清', '整理需求', '专业化', '规范化', '整理一下', '写成PRD', '润色需求', '需求整理', '整理成文档'] },
+    { name: 'req-doc', aliases: ['rd'], description: '需求文档化：将口语化/非专业需求整理为 PRD 级文档。支持 --local 临时工作区模式',
+        usage: 'speccore req-doc "<描述>" | req-doc --from <file> [--to <iteration> | --local]',
+        examples: ['speccore req-doc "我要加个购物车"', 'speccore req-doc --from notes.md --local', 'speccore req-doc --promote <entryId> --to <iteration>'], related: ['analyze', 'doc2spec'], triggers: ['整理需求', '专业化', '规范化', '整理一下', '写成PRD', '润色需求', '需求整理', '整理成文档', '需求文档化', '需求专业化'] },
     // v8.3.24+: 契约冲突裁决
     { name: 'verdict', aliases: ['vd'], description: '契约冲突裁决：查看待裁决冲突、进行人工裁决、查看裁决书',
         usage: 'speccore verdict [--list] [--conflict <id> --decide <pass|reject|defer> --reason <reason>] [--report] [--task <id>]',
@@ -150,8 +150,8 @@ const SYNONYM_MAP = {
     '建索引': 'code-index', '扫描代码': 'code-index', '代码结构': 'code-index',
     // ── iteration ──
     'sprint': 'iteration',
-    // ── dev ──
-    '流水线': 'dev', '全自动': 'dev',
+    // ── run（原 dev，v8.3.189 合并）──
+    '流水线': 'run', '全自动': 'run',
     // ── verify ──
     '冒烟': 'verify', 'smoke': 'verify', '视觉检查': 'verify', 'ui验证': 'verify', '跑测试': 'verify', '测一下': 'verify', '检查页面': 'verify',
     // ── refresh ──
@@ -246,11 +246,28 @@ function classifyMode(input) {
     ];
     if (explainPatterns.some(p => p.test(lower)))
         return 'explain';
+    // v8.3.190+: run 流水线意图前置检测（"从 X 到 Y"、"跑/执行流水线"、"帮我部署/交付"等）
+    // 优先于 pipeline/guide 判定，让 run 命名流水线编排走 match 分支
+    const runPipelinePatterns = [
+        /从.+?(?:到|至).+/,
+        /(?:跑|执行|运行).{0,4}流水线/,
+        /帮我(?:部署|交付|上线|提代码|提交代码)/,
+        /(?:部署|交付|上线).{0,4}流水线/,
+        /(?:跑|执行).{0,4}全流程/,
+        /(?:生成|出).{0,2}(?:spec|规格)/,
+        /.{0,6}到拆分/,
+        /开发(?:流程|到验证|到执行)/,
+        /(?:分析|需求).{0,4}到开发/,
+    ];
+    if (runPipelinePatterns.some(p => p.test(input)))
+        return 'match';
     // 模式4: 复杂编排 — 包含多个动作词 + 时序/数量词
-    const pipelineKeywords = ['然后', '再', '接着', '最后', '同时', '之后',
+    // v8.3.189+: 补充「分析」「拆分」动作词和「并且」「以及」并列连接词，
+    // 使「分析…拆分…」这类复合意图能进入 pipeline 编排（analyze-split-plan）
+    const pipelineKeywords = ['然后', '再', '接着', '最后', '同时', '之后', '并且', '以及', '还要',
         'then', 'after', 'finally', '同时执行', 'pipeline'];
-    const actionWords = ['计划', '执行', '分批', '安排',
-        'plan', 'execute', 'batch'];
+    const actionWords = ['计划', '执行', '分批', '安排', '分析', '拆分',
+        'plan', 'execute', 'batch', 'analyze', 'split'];
     const hasTiming = /晚.*点|早上.*点|明天|今天|后天|下周|周[一到日]|(\d+)[点时]/i.test(lower);
     const hasBatch = /分批|批次|batch|一批|一组/i.test(lower);
     const hasBugfix = /bug|修复|fix|defect/i.test(lower);
@@ -546,7 +563,7 @@ function handleGuide(input) {
         `---`,
         `执行方式:`,
         `  逐步执行: 按顺序手动执行每一步`,
-        `  一键执行: speccore dev --auto（自动检测并推进）`,
+        `  一键执行: speccore run（自动检测并推进）`,
         `  编排执行: speccore ask "完整描述你的需求" --pipeline`,
     ].join('\n');
     const firstStep = matchedWorkflow[0];
@@ -574,9 +591,36 @@ async function handleMatch(input, isExplicit = false) {
     const kbMatch = matchCommandInKB(input);
     const config = await (0, ask_config_1.loadAskConfig)();
     const results = await (0, intent_recognition_1.recognizeIntent)(input);
-    const best = results[0];
+    let best = results[0];
+    // v8.3.191+: run 意图带 preset/起止点（extractParams 已精确识别编排）时优先 run 编排，
+    // 避免被 execute/analyze 的宽泛触发词（跑/开发/分析）抢占。
+    // 条件：confidence>=40 兜底，防止极低置信度的 run 误抢。
+    // runForced：preset/起止点已精确识别 → 跳过歧义检测与中置信度确认，直接编排执行。
+    let runForced = false;
+    const runWithParams = results.find(r => r.intent === 'run' && r.confidence >= 40 && (r.extractedParams?.preset || r.extractedParams?.from || r.extractedParams?.to));
+    if (runWithParams && best?.intent !== 'run') {
+        best = runWithParams;
+        runForced = true;
+    }
+    // v8.3.190+: 澄清三态 flag（仅 analyze 命令，供各分支命令展示统一使用）
+    const clarifyFlag = best && best.command === 'analyze' && best.extractedParams?.clarify === 'on' ? ' --clarify'
+        : best && best.command === 'analyze' && best.extractedParams?.clarify === 'off' ? ' --skip-clarify'
+            : '';
+    // v8.3.190+: run 流水线 flag（preset / 起止点，供各分支命令展示统一使用）
+    let runFlag = '';
+    if (best && best.command === 'run') {
+        const rp = best.extractedParams || {};
+        if (rp.preset)
+            runFlag += ` --preset ${rp.preset}`;
+        if (rp.from)
+            runFlag += ` --from ${rp.from}`;
+        if (rp.to)
+            runFlag += ` --to ${rp.to}`;
+    }
     // 如果 KB 有匹配且置信度高于意图识别，用 KB（但要整合意图识别的参数）
-    if (kbMatch && (!best || best.confidence < 60)) {
+    // v8.3.191+: run 意图有 preset/起止点时，优先 run 编排（避免被 KB 的 split/deploy 等抢占）
+    const runHasParams = best?.command === 'run' && (best.extractedParams?.preset || best.extractedParams?.from || best.extractedParams?.to);
+    if (kbMatch && (!best || best.confidence < 60) && !runHasParams) {
         const params = best?.extractedParams || {};
         let fullCommand = `speccore ${kbMatch.name}`;
         const paramNotes = [];
@@ -596,6 +640,30 @@ async function handleMatch(input, isExplicit = false) {
             fullCommand += ` --scope ${params.scope}`;
             paramNotes.push(`🌐 范围: ${params.scope}`);
         }
+        // v8.3.190+: 澄清三态 ask 单次覆盖（仅 analyze）
+        if (kbMatch.name === 'analyze' && params.clarify === 'on') {
+            fullCommand += ` --clarify`;
+            paramNotes.push(`🔍 澄清: 强制澄清`);
+        }
+        if (kbMatch.name === 'analyze' && params.clarify === 'off') {
+            fullCommand += ` --skip-clarify`;
+            paramNotes.push(`⏭️ 澄清: 跳过`);
+        }
+        // v8.3.190+: run 流水线意图（preset / 起止点）
+        if (kbMatch.name === 'run') {
+            if (params.preset) {
+                fullCommand += ` --preset ${params.preset}`;
+                paramNotes.push(`🎯 流水线: ${params.preset}`);
+            }
+            if (params.from) {
+                fullCommand += ` --from ${params.from}`;
+                paramNotes.push(`📍 起点: ${params.from}`);
+            }
+            if (params.to) {
+                fullCommand += ` --to ${params.to}`;
+                paramNotes.push(`🏁 终点: ${params.to}`);
+            }
+        }
         // 补充分析意图已在 askEngine 顶层检测，此处不再重复
         let detail = `🎯 推荐命令: ${fullCommand}\n${kbMatch.description}\n\n用法: ${kbMatch.usage}`;
         if (paramNotes.length > 0)
@@ -620,7 +688,7 @@ async function handleMatch(input, isExplicit = false) {
     }
     // ── 歧义检测: 第二候选与第一差距 < 15% ──
     const second = results[1];
-    if (second && (best.confidence - second.confidence) < 15) {
+    if (!runForced && second && (best.confidence - second.confidence) < 15) {
         const candidates = results.slice(0, 4);
         const lines = ['🤔 检测到多个可能意图，请选择:', ''];
         candidates.forEach((r, i) => {
@@ -645,7 +713,7 @@ async function handleMatch(input, isExplicit = false) {
             '🤔 我识别到你可能想执行 speccore 命令，但不确定这是调用 CLI 还是普通技术讨论：',
             '',
             `  你的输入: "${input}"`,
-            `  匹配意图: ${best.intent} → speccore ${best.command}`,
+            `  匹配意图: ${best.intent} → speccore ${best.command}${clarifyFlag}${runFlag}`,
             '',
             '如果是 speccore 操作，请补充明确的上下文词，例如：',
             '  • "用 speccore 分析本迭代需求"',
@@ -655,7 +723,7 @@ async function handleMatch(input, isExplicit = false) {
             '',
             '如果是普通技术讨论（解释代码、审查片段、讨论需求），请直接描述你的问题。',
             '',
-            '或输入 y 确认执行: speccore ' + best.command,
+            '或输入 y 确认执行: speccore ' + best.command + clarifyFlag + runFlag,
         ];
         return {
             mode: 'ambiguous',
@@ -665,10 +733,10 @@ async function handleMatch(input, isExplicit = false) {
         };
     }
     // ── 中置信度确认: 匹配到了但不确定，询问用户 ──
-    if (best.confidence < config.routing.highThreshold && best.confidence >= config.routing.lowThreshold) {
+    if (!runForced && best.confidence < config.routing.highThreshold && best.confidence >= config.routing.lowThreshold) {
         const lines = ['🤔 我理解你想做这个，但不太确定，请确认:', ''];
         lines.push(`🎯 我的理解: ${best.intent} (${best.confidence}%)`);
-        lines.push(`📋 建议命令: speccore ${best.command}`);
+        lines.push(`📋 建议命令: speccore ${best.command}${clarifyFlag}${runFlag}`);
         lines.push('');
         if (results.length > 1) {
             lines.push('其他可能:');
@@ -720,6 +788,32 @@ async function handleMatch(input, isExplicit = false) {
             fullCommand += ` --with-code`;
             paramNotes.push(`🔍 源码扫描: 结合工程源码分析`);
         }
+        // v8.3.190+: 澄清步骤 ask 单次覆盖（仅 analyze 命令消费 optional_steps.clarify）
+        if (best.command === 'analyze') {
+            if (params.clarify === 'on') {
+                fullCommand += ` --clarify`;
+                paramNotes.push(`🔍 澄清: 强制澄清`);
+            }
+            else if (params.clarify === 'off') {
+                fullCommand += ` --skip-clarify`;
+                paramNotes.push(`⏭️ 澄清: 跳过`);
+            }
+        }
+        // v8.3.190+: run 流水线意图 — preset 或起止点自动编排
+        if (best.command === 'run') {
+            if (params.preset) {
+                fullCommand += ` --preset ${params.preset}`;
+                paramNotes.push(`🎯 流水线: ${params.preset}`);
+            }
+            if (params.from) {
+                fullCommand += ` --from ${params.from}`;
+                paramNotes.push(`📍 起点: ${params.from}`);
+            }
+            if (params.to) {
+                fullCommand += ` --to ${params.to}`;
+                paramNotes.push(`🏁 终点: ${params.to}`);
+            }
+        }
         // v6.97.0+: 重新/补充分析模式
         if (params.supplement) {
             fullCommand += ` --supplement`;
@@ -778,7 +872,7 @@ async function handleMatch(input, isExplicit = false) {
     // v6.97.0+ 修复：强制确认命令列表 — 即使置信度高也需要用户确认
     // 这些命令会产生文件/副作用，不能误执行
     const FORCE_CONFIRM_COMMANDS = new Set([
-        'analyze', 'split', 'plan', 'execute', 'dev',
+        'analyze', 'split', 'plan', 'execute', 'run',
         'doc2spec', 'spec2doc', 'iteration', 'task',
         'pr', 'done', 'change', 'reindex',
     ]);
@@ -1356,7 +1450,7 @@ function buildGuideDetail(name, steps) {
         `---`,
         `执行方式:`,
         `  逐步执行: 按顺序手动执行每一步`,
-        `  一键执行: speccore dev --auto（自动检测并推进）`,
+        `  一键执行: speccore run（自动检测并推进）`,
         `  编排执行: speccore ask "完整描述你的需求" --pipeline`,
     ].join('\n');
 }