用途:对已有代码库进行逆向分析,生成结构化 SPEC 文档,记录项目做什么、如何构建、暴露哪些契约,可用于从零重建项目或帮助新成员上手。
主要能力:先与用户确认分析范围(整个仓库、指定目录或特定方面)和深度(概览、标准、深度);随后系统扫描项目标识(package.json、go.mod、Cargo.toml、pyproject.toml、pom.xml、README、LICENSE、Git 历史)、架构与入口点、技术栈、功能与行为、数据模型、API 表面(HTTP、GraphQL、gRPC、WebSocket、CLI、导出库 API)、配置与环境变量、外部依赖、测试与质量、部署与运维。
输出结构:SPEC 包含概述、技术栈表、项目结构、数据模型、API 表面、配置、外部依赖、业务规则与约束、非功能特性(性能、安全、错误处理)、测试策略、已知缺口与假设、附录(依赖图、环境搭建)。生成后请用户审阅并迭代,确认后保存到 docs/SPEC.md、项目根目录或自定义路径。
适用场景:理解现有项目、新人入职、为无规格项目补文档、对比实现与设计、准备重写或重构、审计项目实际行为。
限制:不编造意图,无法确定原因时如实说明;不把代码复制进 SPEC;不包含瞬时运行状态;不过度描述内部实现;不假设 README 准确。大型项目(超过 500 或 1000 个文件)建议从概览或特定模块开始。具体安装命令与收费信息暂未提供。