spec-miner

Spec Miner 是一款专为处理无文档、遗留或继承代码库的开发人员所设计的逆向工程代理。它扮演技术考古学家的角色，利用专业的搜索和分析工具，填补现有实现与正式文档之间的鸿沟。该代理采用双重视角策略：使用“架构帽”（Arch Hat）来绘制高阶系统架构、数据流与模块依赖关系，并使用“QA 帽”（QA Hat）来识别可观测的行为、边界案例与技术债。通过将每个洞察建立在直接的代码证据上，它能将晦涩且无文档的仓库转化为结构化且可操作的见解。

• 自动发现入口点、API 路由与核心业务逻辑。

• 使用业界标准 EARS（Easy Approach to Requirements Syntax）格式进行系统性的需求提取。

• 全面的依赖关系与架构映射，协助可视化系统结构。

• 识别技术债、硬编码配置与安全关键模式。

• 生成标准化的项目规格说明，包括技术栈、模块结构与推断的验收标准。

• 最适合用于熟悉陌生项目或准备进行功能重构时。

• 需要使用 Glob、Grep 与 Read 等工具进行主动探索，以确保分析的高置信度。

• 始终区分客观的代码观察与推断的系统意图。

• 提供结构化的输出模板，用于建立可维护的 Markdown 格式文档。

• 强调证据导向的分析：严格避免在没有代码参考的情况下进行假设。