项目全流程梳理与协作蓝图生成
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_fccf428b/project-workflow-analysis-blueprint-generator。
技能介绍
解决什么问题
接手一个跑了几年的单体或微服务系统时,业务逻辑往往散落在 API、GraphQL、消息消费者和前端组件里。没有完整的流程文档,新人只能靠读代码猜意图;想做一次重构或加个新功能,又怕触碰隐藏的依赖。这个技能把散落的入口、服务、数据映射和异常处理串起来,输出一份能当团队参考的蓝图。
它如何工作
技能不写空泛的架构图,而是深入源码做事实记录:
- 入口与服务层:识别
API、GraphQL、消息消费者的入口,记录服务类的方法签名、依赖注入方式和业务逻辑实现。 - 数据与异常:拆解
DTO到领域模型的映射、仓储查询、事务处理,以及全局异常捕获和异步任务调度。 - 规范与扩展:总结命名约定,给出新增接口或服务时的标准步骤和避坑提示。
适用边界
它依赖源码本身的结构和注释质量。如果项目没有统一约定,蓝图只会忠实描述现状,不会替你做架构决策。建议把它当作协作参考,而非机械的代码规范清单。
使用场景
- 新工程师入职后,需要快速理解整个项目的业务流程和系统结构
- 团队准备进行系统重构或迁移,需要先摸清现有模块的协作关系
- 远程协作团队需要一份结构化的流程文档来减少沟通成本
- 技术负责人想给项目新人提供一份完整的系统上手指南
适合人员
- 后端工程师:接手遗留系统,需要快速理解业务流程和代码组织方式
- 架构师:准备系统重构或技术迁移,需要基于现状分析制定方案
- 技术负责人:为团队成员生成项目文档,统一团队对系统结构的认知
- CTO 或技术管理者:评估现有项目的技术债务和扩展性,需要流程级的分析文档