spec-miner

Spec Miner 是一款专注于代码逆向工程与规范提取的专业 Agent Skill，旨在帮助开发团队理解和记录遗留系统或未经文档化的代码库。该工具采用软件考古学方法论，通过系统化的静态分析流程，从现有实现中提炼出结构化的技术规范。

核心用法
Spec Miner 遵循"Scope-Explore-Trace-Document-Flag"五阶段工作流。首先确定分析边界（Scope），明确是针对全系统还是特定功能模块；随后利用 Glob、Grep、Read 等工具探索代码库结构（Explore），建立目录与模块映射；接着追踪数据流与请求路径（Trace），理解系统运行时行为；最终将观察到的需求以 EARS（Easy Approach to Requirements Syntax）格式文档化（Document），并标记需要澄清的不确定区域（Flag）。整个过程强调"Arch Hat"架构视角与"QA Hat"行为视角的双重分析，确保既捕捉系统结构也记录可观测行为。

显著优点
该 Skill 的最大优势在于其严谨的实证方法论——所有结论必须基于实际代码证据，严禁无依据假设。通过强制引用代码位置，生成的规范文档具有高度可追溯性。EARS 格式的采用使得输出的需求规范具备标准化、可测试的特点，可直接用于后续开发或验收。此外，内置的分析清单（Analysis Checklist）和模板系统降低了使用门槛，确保即使是复杂的遗留系统也能被系统化地解析。

潜在缺点与局限性
作为静态分析工具，Spec Miner 无法捕捉运行时动态行为，对于依赖特定环境状态或复杂并发场景的系统可能分析不足。其效率高度依赖使用者的代码探索能力，面对超大规模代码库（百万行级以上）时，人工主导的探索流程可能耗时较长。此外，虽然申请了 Bash 权限用于结构分析，但在某些受限环境中可能面临权限不足的问题。对于重度依赖框架魔法或元编程的代码，静态推断可能产生误报。

适合的目标群体
该 Skill 特别适合以下场景：技术负责人需要评估遗留系统以规划重构；新团队成员快速 onboard 到无文档的老项目；架构师提取现有系统的隐式约束以指导新功能开发；QA 团队基于实现反推验收标准。对于从事代码审计、合规检查或技术尽职调查的专业人员同样具有价值。

使用风险
主要风险在于性能方面：分析大型代码库时，频繁的 Grep/Glob 操作可能消耗较长时间。Bash 工具的使用虽限于代码结构探索，但在共享环境或包含敏感配置文件的代码库中仍需谨慎，建议始终在隔离环境或本地副本中运行。此外，该 Skill 仅生成文档规范，不具备代码修改能力，若需实施变更需配合 Fullstack Guardian 等其他 Skill 使用。