speccore 6.76.0 → 6.77.0

package/.agents/skills/spec-analyze/SKILL.md

@@ -1,10 +1,180 @@
 ---
 name: spec-analyze
-description: 路由到 speccore ask 引擎
-allowed-tools: ["Bash"]
+description: >
+  需求分析专属 Skill。在调用 speccore ask 之前，执行参数提取、
+  前置校验（迭代存在性、需求文档检测、专业度评估、端列表读取），
+  参数缺失时输出交互式提示。不影响 speccore ask 的意图识别能力。
+allowed-tools: ["Bash", "Read"]
 disable-model-invocation: false
 ---
 
-直接执行: execute_command("speccore ask '用户原话'")
+# spec-analyze — 需求分析（专属逻辑）
 
-不要输出命令文本，不要分析意图，一切交给 speccore ask。
+> **定位**：`/analyze` 快捷入口的专属预处理层
+> **原则**：不影响 `speccore ask` 的意图识别能力
+
+---
+
+## 调用方式
+
+```
+/analyze [参数]
+/analyze -I Iteration-001 --auto
+/analyze -I Iteration-001 --scope global --with-code
+/analyze -I Iteration-001 --clarify
+```
+
+---
+
+## 执行流程
+
+```
+用户输入 /analyze [参数]
+        │
+        ▼
+┌───────────────────────────────────────┐
+│ Step 1: 参数提取                        │
+│ 从用户输入提取 iteration/scope/auto 等   │
+└───────────────┬───────────────────────┘
+                │
+        参数缺失？
+                │
+        是 ──► 输出交互式提示
+                │
+        否 ──► 继续
+                │
+                ▼
+┌───────────────────────────────────────┐
+│ Step 2: 参数补全                        │
+│ iteration 缺失 → 读 context.json         │
+│ scope 缺失 → 根据上下文推断              │
+└───────────────┬───────────────────────┘
+                │
+                ▼
+┌───────────────────────────────────────┐
+│ Step 3: 前置校验                        │
+│ - 迭代是否存在？                        │
+│ - 需求文档是否存在？                    │
+│ - 需求专业度评估（clarify）             │
+│ - CONSTITUTION 端列表读取               │
+└───────────────┬───────────────────────┘
+                │
+                ▼
+┌───────────────────────────────────────┐
+│ Step 4: 调用 speccore ask               │
+└───────────────────────────────────────┘
+```
+
+---
+
+## Step 1: 参数提取
+
+| 参数 | 短名 | 长名 | 必填 | 说明 |
+|:---|:---|:---|:---|:---|
+| iteration | -i | --iteration | 否 | 目标迭代名 |
+| scope | -s | --scope | 否 | 分析范围: global / iteration / task |
+| auto | -a | --auto | 否 | 全自动模式（不交互）|
+| with-code | -c | --with-code | 否 | 结合源码分析 |
+| full | -f | --full | 否 | 全自动三阶段合成（原 synthesize）|
+| phase | -p | --phase | 否 | 单阶段执行 1/2/3 |
+| clarify | - | --clarify | 否 | 需求专业度检测，口语化时触发 clarify |
+| dev-guide | - | --dev-guide | 否 | 生成 DEV_GUIDE.md 实现指南 |
+| platforms | - | --platforms | 否 | 只分析指定端 |
+| prompt | - | --prompt | 否 | 只输出 Prompt，不执行 |
+| apply | - | --apply | 否 | 应用 AI 分析结果（支持 @file.json）|
+
+---
+
+## Step 2: 参数缺失 → 交互式提示
+
+```
+🔍 speccore analyze — 需求分析
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📋 当前环境
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+迭代: Iteration-001-meeting-system（从 context.json 读取）
+端列表: api, h5-mobile, admin-web（从 CONSTITUTION.md 读取）
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📖 可用参数
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  -I, --iteration <name>    目标迭代（默认: 当前迭代）
+  -s, --scope <scope>       分析范围:
+                            global    — 全局层分析（项目级，跨端）
+                            iteration — 迭代级分析（默认）
+                            task      — 任务级分析
+  -a, --auto                全自动模式（不交互，直接输出）
+  -c, --with-code           结合源码分析（扫描各端源码）
+      --full                全自动三阶段合成（原 synthesize --full）
+      --phase <N>           单阶段执行: 1(逐端) | 2(跨端) | 3(索引)
+      --clarify             需求专业度检测，口语化时自动触发澄清
+      --dev-guide           同时生成 DEV_GUIDE.md 开发者实现指南
+      --platforms <list>    只分析指定端（如 api,h5）
+      --prompt              只输出 Prompt，不执行分析
+      --apply <json|@file>  应用 AI 分析结果（支持 @file.json 文件方式）
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+💡 使用示例
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  /analyze -I Q1 --auto                   # 全自动分析迭代
+  /analyze --scope global --with-code     # 全局层 + 源码分析
+  /analyze --full                         # 三阶段全量合成
+  /analyze --clarify                      # 检测需求专业度
+  /analyze --dev-guide                    # 分析 + 生成实现指南
+  /analyze --platforms api,h5             # 只分析 api 和 h5 端
+  /analyze --prompt                       # 只输出 Prompt
+
+请补充参数后重新调用，或直接调用 /analyze 使用默认设置。
+```
+
+---
+
+## Step 3: 前置校验
+
+### 3.1 检查迭代是否存在
+```bash
+# 检查迭代目录是否存在
+# 如果不存在 → 提示用户先创建迭代
+```
+
+### 3.2 检查需求文档
+```bash
+# 检查 010-requirements/REQUIREMENT.md 或 converted/*.md 是否存在
+# 如果不存在 → 提示用户先准备需求文档
+```
+
+### 3.3 需求专业度检测（--clarify）
+```bash
+# 读取 REQUIREMENT.md 或用户输入
+# 检测指标：
+#   - 口语化表达（"我要/我想/能不能"）
+#   - 缺少结构化标题（## / ###）
+#   - 缺少验收标准
+#   - 缺少技术约束
+#   - 缺少错误处理
+#   - 缺少数据模型
+# 如果专业度低 → 提示用户先执行 clarify
+```
+
+### 3.4 读取端列表
+```bash
+# 从 CONSTITUTION.md 读取项目配置的端列表
+# 如果 --platforms 指定了不存在的端 → 提示可用端
+```
+
+### 3.5 检查 --apply 文件
+```bash
+# 如果 --apply 以 @ 开头，从文件读取 JSON
+# 检查文件是否存在
+```
+
+---
+
+## Step 4: 调用 speccore ask
+
+```bash
+execute_command("speccore ask '分析 Iteration-XXX...'")
+```
+
+> ⚠️ 最终仍然调用 `speccore ask`，不要绕过 ask 引擎。

package/.agents/skills/spec-change/SKILL.md

@@ -1,13 +1,166 @@
 ---
 name: spec-change
-description: 需求变更/新增 — AI 澄清 → 用户确认 → 持久化
+description: >
+  需求变更专属 Skill。在调用 speccore ask 之前，执行参数提取、
+  前置校验（当前迭代、已有 Task 列表、变更类型判断），
+  参数缺失时输出交互式提示。不影响 speccore ask 的意图识别能力。
 allowed-tools: ["Bash", "Read"]
 disable-model-invocation: false
 ---
 
-# spec-change — 需求变更与新增
+# spec-change — 需求变更与新增（专属逻辑）
 
-## 核心流程
+> **定位**：`/change` 快捷入口的专属预处理层
+> **原则**：不影响 `speccore ask` 的意图识别能力
+
+---
+
+## 调用方式
+
+```
+/change [参数]
+/change --prompt "新增一个通知功能"
+/change --prompt "订单模块加个退款接口" -I Iteration-001
+```
+
+---
+
+## 执行流程
+
+```
+用户输入 /change [参数]
+        │
+        ▼
+┌───────────────────────────────────────┐
+│ Step 1: 参数提取                        │
+│ 从用户输入提取 iteration/prompt/response │
+└───────────────┬───────────────────────┘
+                │
+        参数缺失？
+                │
+        是 ──► 输出交互式提示
+                │
+        否 ──► 继续
+                │
+                ▼
+┌───────────────────────────────────────┐
+│ Step 2: 参数补全                        │
+│ iteration 缺失 → 读 context.json         │
+│ intent 推断 → 新增 or 变更               │
+└───────────────┬───────────────────────┘
+                │
+                ▼
+┌───────────────────────────────────────┐
+│ Step 3: 前置校验                        │
+│ - 当前迭代是否存在？                    │
+│ - 已有 Task 列表扫描                    │
+│ - 变更类型判断（新增/变更）             │
+│ - 附件检测（inbox/ 目录）               │
+└───────────────┬───────────────────────┘
+                │
+                ▼
+┌───────────────────────────────────────┐
+│ Step 4: 调用 speccore ask               │
+└───────────────────────────────────────┘
+```
+
+---
+
+## Step 1: 参数提取
+
+| 参数 | 短名 | 长名 | 必填 | 说明 |
+|:---|:---|:---|:---|:---|
+| iteration | -i | --iteration | 否 | 目标迭代名 |
+| prompt | -p | --prompt | 否 | 生成澄清 Prompt（传入用户原话）|
+| response | -r | --response | 否 | 应用 AI 澄清结果（JSON）|
+| file | -f | --file | 否 | 附件文件路径 |
+| task | -t | --task | 否 | 指定受影响的 Task |
+
+---
+
+## Step 2: 参数缺失 → 交互式提示
+
+```
+🔄 speccore change — 需求变更与新增
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📋 当前环境
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+迭代: Iteration-001-meeting-system（从 context.json 读取）
+已有任务: 3 个（Task-001, Task-002, Task-003）
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📖 可用参数
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  -I, --iteration <name>    目标迭代（默认: 当前迭代）
+  -p, --prompt <text>       用户原始需求描述（用于生成澄清 Prompt）
+  -r, --response <json>     AI 澄清后的结构化结果（JSON）
+  -f, --file <path>         附件文件路径
+  -t, --task <id>           指定受影响的 Task（可选）
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+💡 使用示例
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  /change --prompt "新增一个通知功能"              # 生成澄清 Prompt
+  /change --prompt "订单模块加个退款接口"          # 变更现有功能
+  /change --response '{...json...}'               # 应用澄清结果
+  /change --prompt "新增功能" -f ./PRD.pdf        # 带附件的变更
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🔄 核心流程
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  1. /change --prompt "你的需求描述"     → 生成澄清 Prompt
+  2. AI 根据 Prompt 生成结构化 JSON       → 展示给用户确认
+  3. 用户确认后                         → /change --response '{JSON}'
+  4. CLI 解析 JSON 并写入文件            → 完成变更/新增
+
+请补充 --prompt 参数后重新调用。
+```
+
+---
+
+## Step 3: 前置校验
+
+### 3.1 检查迭代是否存在
+```bash
+# 检查迭代目录是否存在
+# 如果不存在 → 提示用户先创建迭代
+```
+
+### 3.2 扫描已有 Task
+```bash
+# 读取 030-tasks/ 下的 Task 列表
+# 用于判断变更影响范围（直接/间接/无影响）
+```
+
+### 3.3 变更类型判断
+```bash
+# 根据用户输入判断意图：
+#   "新增/加/创建/实现 + 描述" → 🆕 新增需求
+#   "{task} 需求变了/要改/修改" → 🔄 需求变更
+#   模糊描述 → AI 判断并询问用户
+```
+
+### 3.4 附件检测
+```bash
+# 检查 .speccore/inbox/ 目录是否有文件
+# 检查用户是否通过 --file 指定了附件
+# 有附件时，澄清 Prompt 自动包含附件内容
+```
+
+---
+
+## Step 4: 调用 speccore ask
+
+```bash
+execute_command("speccore ask '处理需求变更...'")
+```
+
+> ⚠️ 最终仍然调用 `speccore ask`，不要绕过 ask 引擎。
+
+---
+
+## 核心流程（保留）
 
 ```
 用户自然语言输入（如 "新增一个通知功能" 或 "订单模块加个退款接口"）
@@ -70,20 +223,3 @@ disable-model-invocation: false
 2. **用户不满意就反复澄清** — 直到用户说"可以"为止
 3. **澄清 = 需求分析** — 结果必须持久化到 REQ.md，不是临时判断
 4. **不要输出命令文本** — 用 execute_command 执行
-
-## 附件支持
-
-用户可能通过以下方式提供附件:
-- 拖入文件（图片/文档）
-- 放到 `.speccore/inbox/` 目录
-- 用 `--file` 参数指定
-
-有附件时，澄清 Prompt 会自动包含附件内容。
-
-## 意图检测
-
-| 用户说法 | 意图 |
-|:---|:---|
-| "新增/加/创建/实现 + 描述" | 🆕 新增需求 |
-| "{task} 需求变了/要改/修改" | 🔄 需求变更 |
-| 模糊描述 | AI 判断并询问用户 |

package/.agents/skills/spec-doc2spec/SKILL.md

@@ -1,10 +1,127 @@
 ---
 name: spec-doc2spec
-description: 路由到 speccore ask 引擎
-allowed-tools: ["Bash"]
+description: >
+  文档转规格专属 Skill。在调用 speccore ask 之前，执行参数提取、
+  前置校验（文件存在性、格式检测），参数缺失时输出交互式提示。
+  不影响 speccore ask 的意图识别能力。
+allowed-tools: ["Bash", "Read"]
 disable-model-invocation: false
 ---
 
-直接执行: execute_command("speccore ask '用户原话'")
+# spec-doc2spec — 文档转规格（专属逻辑）
 
-不要输出命令文本，不要分析意图，一切交给 speccore ask。
+> **定位**：`/doc2spec` 快捷入口的专属预处理层
+> **原则**：不影响 `speccore ask` 的意图识别能力
+
+---
+
+## 调用方式
+
+```
+/doc2spec [参数]
+/doc2spec --file PRD.pdf -I Iteration-001
+/doc2spec --file requirements.docx --output 010-requirements/converted/
+```
+
+---
+
+## 执行流程
+
+```
+用户输入 /doc2spec [参数]
+        │
+        ▼
+┌───────────────────────────────────────┐
+│ Step 1: 参数提取                        │
+│ 从用户输入提取 file/iteration/output 等 │
+└───────────────┬───────────────────────┘
+                │
+        参数缺失？
+                │
+        是 ──► 输出交互式提示
+                │
+        否 ──► 继续
+                │
+                ▼
+┌───────────────────────────────────────┐
+│ Step 2: 前置校验                        │
+│ - 文件是否存在？                        │
+│ - 格式是否支持？                        │
+│ - 迭代是否存在？                        │
+└───────────────┬───────────────────────┘
+                │
+                ▼
+┌───────────────────────────────────────┐
+│ Step 3: 调用 speccore ask               │
+└───────────────────────────────────────┘
+```
+
+---
+
+## Step 1: 参数提取
+
+| 参数 | 短名 | 长名 | 必填 | 说明 |
+|:---|:---|:---|:---|:---|
+| file | -f | --file | 是 | 源文档路径（PDF/DOCX/MD/HTML）|
+| iteration | -i | --iteration | 否 | 目标迭代名 |
+| output | -o | --output | 否 | 输出目录 |
+| prompt | - | --prompt | 否 | 只输出 Prompt，不执行 |
+
+---
+
+## Step 2: 参数缺失 → 交互式提示
+
+```
+📄 speccore doc2spec — 文档转规格
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📖 可用参数
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  -f, --file <path>         源文档路径（必填）
+                            支持: .pdf, .docx, .md, .html, .txt
+  -I, --iteration <name>    目标迭代（默认: 当前迭代）
+  -o, --output <dir>        输出目录（默认: 010-requirements/converted/）
+      --prompt              只输出 Prompt，不执行转换
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+💡 使用示例
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  /doc2spec -f PRD.pdf                      # 转换 PDF 到当前迭代
+  /doc2spec -f requirements.docx -I Q1      # 转换到指定迭代
+  /doc2spec -f design.md -o ./output/       # 指定输出目录
+  /doc2spec -f PRD.pdf --prompt             # 只生成 Prompt
+
+请补充 --file 参数后重新调用。
+```
+
+---
+
+## Step 3: 前置校验
+
+### 3.1 检查文件是否存在
+```bash
+# 检查 --file 指定的路径
+# 如果不存在 → 提示用户确认路径
+```
+
+### 3.2 检查文件格式
+```bash
+# 支持的格式: .pdf, .docx, .md, .html, .txt
+# 如果格式不支持 → 提示用户
+```
+
+### 3.3 检查迭代是否存在
+```bash
+# 如果指定了 -I，检查迭代目录是否存在
+# 如果不存在 → 提示用户先创建迭代
+```
+
+---
+
+## Step 4: 调用 speccore ask
+
+```bash
+execute_command("speccore ask '将文档转为规格...'")
+```
+
+> ⚠️ 最终仍然调用 `speccore ask`，不要绕过 ask 引擎。

package/.agents/skills/spec-execute/SKILL.md

@@ -1,13 +1,156 @@
 ---
 name: spec-execute
-description: 路由到 speccore ask 引擎
-allowed-tools: ["Bash"]
+description: >
+  执行开发专属 Skill。在调用 speccore ask 之前，执行参数提取、
+  前置校验（任务状态检查、代码模式读取、上下文准备），
+  参数缺失时输出交互式提示（参数说明 + 使用示例）。
+  不影响 speccore ask 的意图识别能力。
+allowed-tools: ["Bash", "Read"]
 disable-model-invocation: false
 ---
 
-直接执行: execute_command("speccore ask '用户原话'")
+# spec-execute — 执行开发（专属逻辑）
 
-不要输出命令文本，不要分析意图，一切交给 speccore ask。
+> **定位**：`/execute` 快捷入口的专属预处理层
+> **原则**：不影响 `speccore ask` 的意图识别能力，只在调用 ask 之前做参数校验和上下文准备
+
+---
+
+## 调用方式
+
+```
+/execute [参数]
+/execute -t Task-001
+/execute -I Iteration-001 --all
+```
+
+---
+
+## 执行流程
+
+```
+用户输入 /execute [参数]
+        │
+        ▼
+┌───────────────────────────────────────┐
+│ Step 1: 参数提取                        │
+│ 从用户输入提取 iteration/task/all 等     │
+└───────────────┬───────────────────────┘
+                │
+        参数缺失？
+                │
+        是 ──► 输出交互式提示
+                │
+        否 ──► 继续
+                │
+                ▼
+┌───────────────────────────────────────┐
+│ Step 2: 前置校验                        │
+│ - 任务是否存在？                        │
+│ - 上游文档是否有更新？                  │
+│ - 代码模式读取（.speccore/PATTERNS/）   │
+└───────────────┬───────────────────────┘
+                │
+                ▼
+┌───────────────────────────────────────┐
+│ Step 3: 调用 speccore ask               │
+└───────────────────────────────────────┘
+```
+
+---
+
+## Step 1: 参数提取
+
+| 参数 | 短名 | 长名 | 必填 | 说明 |
+|:---|:---|:---|:---|:---|
+| iteration | -i | --iteration | 否 | 目标迭代名 |
+| task | -t | --task | 否 | 指定任务（与 --all 互斥）|
+| all | -a | --all | 否 | 全部待执行任务 |
+| force | -f | --force | 否 | 跳过确认直接执行 |
+| resume | -r | --resume | 否 | 断点续跑 |
+| batch-size | -b | --batch-size | 否 | 每批任务数（默认 3）|
+| verify | -v | --verify | 否 | 执行后自动验证 |
+| agent | - | --agent | 否 | 外部 AI 工具 |
+
+---
+
+## Step 2: 参数缺失 → 交互式提示
+
+```
+🔨 speccore execute — 执行开发
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📋 当前环境
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+迭代: Iteration-001-meeting-system（从 context.json 读取）
+待执行任务: 3 个（Task-001, Task-002, Task-003）
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📖 可用参数
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  -I, --iteration <name>    目标迭代（默认: 当前迭代）
+  -t, --task <id>           指定任务（如 Task-001）
+  -a, --all                 全部待执行任务
+  -f, --force               跳过确认直接执行
+  -r, --resume              断点续跑（从上次中断处继续）
+      --batch-size <n>      每批任务数（默认 3）
+      --verify              执行后自动运行测试验证
+      --agent <tool>        外部 AI 工具（copilot/claude/cursor/trae/qoder）
+      --ignore-upstream-update  跳过上游变更检测
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+💡 使用示例
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  /execute -t Task-001                    # 执行单个任务
+  /execute --all                          # 执行全部待完成任务
+  /execute --all --force                  # 全部执行，跳过确认
+  /execute --resume                       # 断点续跑
+  /execute --all --batch-size 5           # 每批 5 个任务
+  /execute -t Task-001 --verify           # 执行后自动验证
+
+请补充参数后重新调用。
+```
+
+---
+
+## Step 3: 前置校验
+
+### 3.1 检查任务是否存在
+```bash
+# 扫描 030-tasks/ 目录
+# 如果 Task 不存在 → 提示用户
+```
+
+### 3.2 检查任务状态
+```bash
+# 读取 Task/.meta/status
+# 如果状态为 done → 提示用户是否重新执行
+# 如果状态为 pending → 正常执行
+```
+
+### 3.3 上游变更检测
+```bash
+# 比较 020-specs/ 和 Task/00-specs/ 的 mtime
+# 如果有更新 → 提示用户建议重新拆分
+```
+
+### 3.4 读取代码模式
+```bash
+# 读取 .speccore/PATTERNS/ 中匹配的代码模式
+# 为 AI 提供参考代码片段
+```
+
+---
+
+## Step 4: 调用 speccore ask
+
+```bash
+execute_command("speccore ask '执行 Task-XXX 的开发...'")
+```
+
+> ⚠️ 最终仍然调用 `speccore ask`，不要绕过 ask 引擎。
+
+---
 
 ## 📦 批次执行模式（防止上下文溢出）
 
@@ -38,7 +181,7 @@ speccore execute --response '<代码JSON>' --task=<任务ID> -i <迭代名>
 3. 在新对话中，先读取 `<path>` 文件恢复上下文（约 1K tokens，包含已完成任务摘要、待执行任务、依赖关系）
 4. 然后执行提示的命令继续下一批次
 
-> 💡 “文件即记忆”机制：每个任务完成后，CLI 自动将进度、产出摘要、依赖关系写入摘要文件。
+> 💡 "文件即记忆"机制：每个任务完成后，CLI 自动将进度、产出摘要、依赖关系写入摘要文件。
 > 新会话只需读取这个文件（~1K tokens）就能恢复全局视角，无需重新扫描全部文件。
 
 ### 为什么需要批次执行？