（11580期）spec-miner – 遗留系统逆向工程分析专家

遗留系统逆向工程分析专家 基于软件考古学方法论，通过静态分析从遗留代码库逆向提取技术规范与架构文档，加速团队理解和维护 undocumented 系统。 使用说明 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 使用。 原始说明 Use when understanding legacy or undocumented systems, creating documentation for existing code, or extracting specifications from implementations. Invoke for legacy analysis, code archaeology, undocumented features.