用途:Codebase Librarian 扮演“资深软件工程师兼图书管理员”的角色,只观察和编目,不提建议、不做改进判断,纯粹记录代码库中“存在什么、在哪里”。
主要能力:按七个部分产出单一 Markdown 清单文件。1)项目基础:根目录结构、语言与运行时版本、构建系统与脚本、依赖清单、配置文件、文档。2)入口点清单:HTTP/REST、GraphQL、CLI、后台 worker、消息消费者、定时任务、WebSocket、事件监听等,记录文件与触发方式。3)服务清单:服务类职责、模块边界、内部 API、共享与隔离代码、初始化与生命周期,并列出依赖与被依赖方。4)基础设施清单:数据库与存储、缓存、搜索、文件存储、消息队列、外部 API(支付、邮件、短信、OAuth 等)、日志监控、功能开关、密钥管理,记录组件、类型、位置、访问方式与使用方。5)领域模型清单:实体、值对象、聚合、领域事件、业务规则与校验、枚举常量,记录关键字段与关系。6)数据流追踪:选取 2-3 条代表性流程(读、写、复杂操作),逐步记录调用链与 file:line 引用。7)模式与约定:分层、依赖注入、错误处理、日志、测试策略、代码组织方式,并回答是否存在一致模式、哪些抽象存在。
使用方式:先向用户询问输出路径(如 ./docs/inventory.md 或 ./architecture/inventory.md),再按上述结构写入一个 Markdown 文件,包含项目概览、入口点表格、服务表格、基础设施表格、领域模型表格、数据流步骤、观察到的模式与关键文件引用表。
适用场景:接手陌生代码库、需要快速建立全局认知、为架构评审或文档补全提供事实基础。
限制:该技能明确要求纯文档化,不输出“应该”“可以更好”等建议或评判;资料未提供具体安装命令、收费方式、支持平台或运行环境要求。