hotplex-arch-analyzerlisted

# 架构深度分析器 ## 为什么使用此 skill？ 架构分析是复杂且易出错的工作 — 容易遗漏重要问题、产生误报、或浪费时间在低价值发现上。此 skill 通过以下方式解决这些问题： **渐进式分析** — 每次 2-3 个方面，避免信息过载，让每个发现都经过深思熟虑 **智能优先级** — 自动优先分析最少审计模块，确保覆盖均衡 **置信度 + ROI 分诊** — 过滤误报和低价值发现，只创建高影响力 issue **存量 Issue 审计** — 当 open issues 超过阈值时，自动切换为审计模式：核实、关闭、更正 **持久化进度** — 跨会话追踪，支持 `/loop` 连续执行，不会丢失工作 **HotPlex 专用优化** — 针对 Gateway 多层架构的特殊模式定制 **Subagent 上下文隔离** — 深度分析在独立 subagent 中执行，主会话只处理 JSON 结果，每模块上下文消耗降低 97% **核心设计**：每次调用 = **一个分析周期**在**一个模块**上覆盖**2-3 个方面**。专为 `/loop` 设计 — 重复调用在 4 个深度阶段中渐进覆盖所有模块 × 所有方面。 **状态持久化在** `.claude/arch-analysis/progress.json` — 跨会话重启存活，启用 `/loop` 连续性。 ### 为什么使用 /loop？ **手动执行的问题**： - 需要记住调用 skill 数十次 - 容易丢失分析进度 - 难以跟踪覆盖哪些模块 - 容易过早停止 **使用 /loop 的好处**： - **自动化**：设置后无需干预，持续分析所有模块 - **持久化**：进度文件保存状态，中断后可以恢复 - **可视化**：每次调用显示覆盖矩阵，清楚看到进度 - **均衡覆盖**：智能优先级确保最少分析的模块优先处理 **推荐 /loop 设置**： ```bash /loop 10m /hotplex-arch-analyzer ``` 这每 10 分钟运行一次分析，适合大型代码库的渐进式分析。调整间隔基于代码库大小和分析深度需求。 --- ## 如何阅读本文档 本文档使用渐进式信息披露 — 快速开始只需阅读工作流概览和步骤 1-3。详细参考材料（模块发现、分析方面、进度文件模式）在后面供需要时查阅。 **快速路径**（新用户）： 1. 阅读工作流概览 2. 理解步骤 1-3（加载进度、选择模块、选择方面） 3. 跳到步骤 5（Issue 模板）开始使用 **深度路径**（经验用户）： 1. 完整阅读所有步骤 2. 参考常见陷阱故障排除 3. 自定义模块发现和方面选择逻辑 --- ## 工作流概览 每次调用遵循两种模式之一，由**步骤 1.5（模式检测）**决定： **分析模式**（默认）： ``` 加载进度 → 选择模块 → 选择方面 → [Subagent 深度分析+分诊] → 去重检查 → 创建/更新 Issue → 更新进度 → 报告 ``` **审计模式**（open issues ≥ ���值时激活）： ``` 加载进度 → 选择 Issue → [Subagent 验证代码] → 分类处理 → 更新进度 → 报告 ``` **为什么需要双模式**：分析模式持续发现新问题，但问题积累后会降低团队信任度和审查效率。审计模式定期清理存量 issue，关闭误报、更正偏差，保持 issue backlog 的健康。两个模式交替运