用途：在改动代码前提供基于 Git 历史的主动情报，防止引入 bug、保持一致性并从历史中学习。适用于修复、重构、新增功能以及回答“为什么这样实现”的问题。
主要能力：smart 自适应风险分析（自动计算提交范围、风险评分、回退检测、相似问题）；file 函数级热点检测（高频修改、复杂度增长、耦合、生命周期）；pattern-adoption 模式采用率与违规检查（覆盖异步、错误处理、上下文管理器、输入校验、日志、装饰器、工厂、依赖注入、重试、缓存、单例、观察者、限流、熔断等 14 种模式）；dep-graph 循环依赖与上帝对象检测；context 历史上下文；design 生成带历史情报的设计文档；analyze、dependencies、patterns、discover 等辅助命令。
使用方式：需 Python 3.8+ 与 Git，且仓库为 git 仓库。常用命令如 python3 .claude/skills/code_archaeologist/skill.py smart <folder> --question "$ARGUMENTS"、file <file_path> --function <function_name>、pattern-adoption、dep-graph、context、design 等。默认分析最近 500 次提交。
限制：函数检测基于正则，复杂语法可能漏检；性能随提交量增加，可用 --format compact 或减少深度；输出中的风险等级与模式阈值仅为建议，需结合人工判断。具体安装与集成细节暂未提供。