用途:该技能面向已有代码库,帮助从代码中提取业务需求、领域知识与技术规格,适用于棕地(brownfield)分析或理解遗留系统业务逻辑。
主要能力:围绕五个目标展开——领域模型(核心实体及关系)、业务规则(校验、计算、工作流)、集成(外部系统与数据流)、用户能力(系统中用户可做什么)、技术约束(架构模式与限制)。分析过程分五个阶段:一、结构发现(项目结构、组件分层、配置与入口点、构建与部署);二、领域模型提取(实体定义、关系、领域词汇、数据类型与约束);三、业务逻辑识别(服务层、校验规则、计算公式、状态机与工作流);四、集成映射(API 端点与契约、外部服务调用、数据流入流出、认证模式);五、能力文档化(用户功能、权限与访问控制、用户工作流、边界与错误处理)。此外提供代码模式识别提示(如 C#/Java/TypeScript 的实体写法、校验关键词 Validate/Check/Ensure、服务类与处理器、REST/Express/GraphQL 端点模式)、启发式查找方法、grep 搜索示例,以及领域模型、业务规则、集成的输出文档模板。
使用方式:按阶段推进分析,从入口点(main() 或启动配置)出发,沿依赖注入与 API—服务—数据链路追踪;从数据库模式或实体入手跟随数据流;借助单元测试、集成测试、测试数据和 README、Swagger/OpenAPI、代码注释辅助理解。资料给出的命令示例包括:grep -r "@Entity" --include=".java"、grep -r "app.(get|post|put|delete)(" --include=".js" 等。
适用场景:存量系统重构前的需求还原、遗留代码接手、文档缺失时的业务规则梳理。
限制:资料未提供安装方式、运行环境、平台支持或收费信息;分析效果依赖代码可读性与测试、文档的完整程度。