SuperAPI AI 工具集

speak-with-dead

编程与开发

查看项目

更新于 10-20 16:16

技能介绍

用途 该技能面向“死代码/死系统考古”:当用户需要从已废弃、已弃用或已归档的系统中提取知识,而该系统原来的构建者或维护者已不可用时使用。知识必须能从现存制品(代码、提交历史、文档、配置、数据库、状态文件)中恢复,而非来自在世人员或运行中的系统。它被明确定位为考古学,而不是历史研究:只操作某个具体死系统的具体制品,回答具体问题。

主要能力

  1. 行动前先复述目标、成功条件以及不可触碰的边界。
  2. 界定死系统范围:指明具体系统,确认其确已停用/归档,并列出用户的具体问题。
  3. 盘点制品:识别留存内容,如 git 历史、提交信息、PR 描述、README、归档文档、配置文件、数据库结构、状态文件、数据包捕获、ADR(架构决策记录),并记录缺失项。
  4. 从证据重建:通过提交信息、代码结构、配置值与数据模式追踪原始意图,并将制品直接陈述的内容与推断内容分开。
  5. 带置信度标注返回:每个答案都引用具体制品(文件、提交哈希、行号、配置键),并标注为“证据”(直接陈述)或“推断”(由模式推理);证据链中断处明确标出。
  6. 按交付物打包结果,并显式列出置信度、假设与未解决风险。

交付物

  • 针对具体问题、从死系统制品中得出的答案。
  • 对系统原始意图和已知失败模式的重建。
  • 明确区分死系统实际记录的内容与推断内容。

使用方式 以斜杠命令形式调用,例如:/speak-with-dead 审问这个遗留系统,告诉我它知道什么、意图是什么,以及证据在哪里中断。执行过程遵循上述程序:复述目标与边界→界定死系统→盘点制品→从证据重建→带置信度标注返回→打包交付物。

适用场景

  • 已废弃/归档系统的知识抢救与取证式梳理。
  • 回答关于某个具体死系统的具体问题。
  • 重建系统原始设计意图与已知失败模式。

限制与护栏

  • 不得编造制品不支持的答案;推断必须显式标注。
  • 若系统可能因安全、法律或合规原因被归档,需向用户提示。
  • 若制品不足以回答问题,应直接说明而非猜测。
  • 不适用于:通用技术史(如 JavaScript 框架史、REST API 演进)→ 转研究/知识类技能;向在世人员了解公司历史(如问团队为何选 Postgres)→ 转协作/调研类技能;实时系统观测(如 staging 当前状态)→ 转监控/可观测性类技能;竞品监控(如监测其 API 变化)→ 转监控/自动化类技能;生产系统主动调试(如生产服务为何失败)→ 转调试/排障类技能;通用代码解释(如解释某函数作用)→ 转代码理解类技能。

前置条件 除 Hermes Agent 及本次会话的常规工具集外,无额外运行时依赖。