SuperAPI AI 工具集

codebase-archaeology

通用与其它

查看项目

更新于 10-16 06:42

技能介绍

用途:为不熟悉的代码库建立实用心智模型,避免随机浏览文件。核心原则是“先文档、后数据流”,从项目指引与文档入手,再沿入口点追踪领域逻辑、存储、集成、配置与测试。

主要能力:读取 AGENTS.md、README 与 docs 获取约定;分类仓库形态(CLI、前端、后端、全栈、库、monorepo、数据管道、基础设施);用 rg 识别入口点(main、路由、CLI 命令、worker);定位 3-5 个核心类型;追踪入口→控制器→服务→领域→存储→输出的数据流;映射数据库、外部 API、队列、文件 I/O、环境变量与配置;阅读测试推断预期行为;最终输出带 file:line 引用的简明架构总结,而非原始代码堆砌。

使用方式:该技能面向 Codex CLI、IDE 和 app,SKILL.md 位于 .agents/skills/<skill-name>/ 等 Codex 技能发现位置。默认单智能体流程;仅当用户明确要求子智能体或并行探索时,才使用 archaeology_docs、archaeology_entrypoints、archaeology_domain、archaeology_dataflow、archaeology_integrations、archaeology_tests 等只读自定义智能体,父智能体负责综合。快速提示示例:Use $codebase-archaeology to map this repo...

适用场景:新仓库上手、理解遗留代码、迁移/重构前架构梳理、追踪某个功能或 Bug 路径、生成可复用技术架构总结。

限制:不兼容 Claude Code 的 Task、Agent、subagent_type 等语法;子智能体默认只读;不假定 agents/ 文件夹会自动创建子智能体;需遵循证据包契约并标注推断与未决问题;未提供具体收费、价格或平台支持信息。