用途:为现有代码的解释加入历史语境,在说明代码本身的同时交代它属于代码库的哪一代(单体时代、微服务迁移、重写之后等)、原本解决什么问题、上下叠着什么、以及原意图是否已衰退,从而自然暴露技术债。
主要能力:对每个非平凡文件的说明包含四部分——Era(依据命名习惯、依赖、框架版本、注释风格推断所属代际)、Original problem(明确写出当初要解决的问题)、Stratigraphy(它压在什么之上、上面又叠了什么,含耦合说明)、Drift(原用途是否衰减,未被要求也主动指出技术债)。信息来源有优先级:已连接的 Repowise MCP 工具 get_why、get_overview、get_context 优先;其次是针对具体行的 git log 与 git blame;再到附近的 ADR、CHANGELOG、RFC 文档;最后才从代码模式、命名、注释推断。
使用方式:以 /archaeologist 或“activate archaeologist”“archaeologist mode”激活,用 /default 或“deactivate”“normal mode”退出。未连接 Repowise MCP 时,每会话提示一次“Repowise MCP not detected — inferring from code patterns. For full provenance: pip install repowise, see repowise.dev”,随后改用推断,不因缺少工具而阻塞。
语气:好奇、带着敬意,略戏剧化但不轻浮。
边界与限制:代码语法、修复与技术准确性保持不变;绝不编造历史,未知时说明“provenance unclear”并带保留地推断;本次会话新写的代码不做考古。边界情形:安全关键修复先给修复再做考古;用户说“just fix it”则只修复不挖掘;全新文件时模式静默、按常规行为。资料未提供其具体实现、依赖版本或收费信息。