state-scannerlisted

# 状态扫描与智能推荐 (State Scanner v2.7) > **版本**: 2.7.0 | **角色**: 十步循环统一入口 ## 快速开始 ### 我应该使用这个 Skill 吗？ **使用场景**: - 开始任何开发任务前的状态检查 - 不确定应该使用哪个工作流 - 需要系统推荐最佳执行路径 - 查询多模块项目的整体进度 **不使用场景**: - 已知要执行特定 Phase → 直接调用 Phase Skill - 只想运行特定步骤 → 直接调用步骤 Skill --- ## 核心功能 | 功能 | 描述 | |------|------| | **状态感知** | 收集 Git 状态、UPM 进度、OpenSpec 状态、审计状态、变更分析 | | **智能推荐** | 基于状态生成工作流推荐，附带理由说明 | | **用户确认** | 展示选项，让用户确认或自定义工作流 | | **工作流启动** | 将确认的工作流传递给 workflow-runner 执行 | --- ## 配置 (config-loader) 执行前读取 `.aria/config.json`，缺失则使用默认值。参见 [config-loader](../config-loader/SKILL.md)。 | 字段 | 默认值 | 说明 | |------|--------|------| | `state_scanner.confidence_threshold` | `90` | 置信度阈值 (0-100) | | `state_scanner.auto_execute_enabled` | `false` | 高置信度自动执行 | | `state_scanner.auto_execute_rules` | `["commit_only", "quick_fix", "doc_only"]` | 允许自动执行的规则 | | `state_scanner.audit_log_path` | `".aria/audit.log"` | 审计日志路径 | | `workflow.auto_proceed` | `false` | Phase 间自动推进 | --- ## 执行流程 ### 阶段 0: 中断检测 (Pre-flight) > 详细逻辑见 [interrupt-recovery.md](./references/interrupt-recovery.md) | 状态格式见 [workflow-state-schema.md](../workflow-runner/references/workflow-state-schema.md) 检查 `.aria/workflow-state.json` — 不存在或损坏则跳过进入阶段 1 (损坏时备份并警告)。若 status=`in_progress`|`suspended`: (1) 验证 `git_anchor.branch` 匹配当前分支，不匹配仅 Abandon/Inspect; (2) 若 `session.last_active_at`<5min 且 `session_id` 不同，警告并发冲突; (3) 展示 **[1]Resume [2]Abandon [3]Inspect** — Resume→workflow-runner(resume=true)