state-scannerlisted

# 状态扫描与智能推荐 (State Scanner v3.0) > **版本**: 3.0.0 | **角色**: 十步循环统一入口 > **机械化**: v3.0.0 起 Phase 1.x 由 `scripts/scan.py` (stdlib-only Python) 机械产出 JSON snapshot, AI 读 snapshot 进入阶段 2 推荐。v2.x prose 路径保留 `mechanical_mode=false` opt-out, 计划下一 minor (v1.19.0+) 移除 (AD-SSME-5;v1.18.0 ship 时仍保留 — 监测使用量后决定)。 ## 快速开始 ### 我应该使用这个 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"` | 审计日志路径 | | `state_scanner.mechanical_mode` | `true` | v3.0.0+: `true` 走 scan.py 路径, `false` 回退 v2.x prose 路径 (计划 v1.19.0+ 移除, v1.18.0 ship 时仍保留) | | `state_scanner.issue_scan.platform_hostnames.forgejo` | `["forgejo.10cg.pub"]` | v1.30.0+: Forgejo hosts 可通过 `ARIA_FORGEJO_HOSTS` env var (comma-separated) 覆盖, 优先级 env > config > default; 同时影响 `forgejo_config` 和 `issue_scan`