Skill :project-structure(目录结构)
技术栈选型完成后,并不意味着可以马上进入编码阶段。真正开始写代码前,还需要先回答一个关键问题:项目文件应该如何组织?
很多项目在早期文件较少时,目录结构看起来并不重要。组件、页面、工具函数随手放,似乎也能正常运行。但随着功能增加,问题会逐渐暴露:页面和组件混在一起,公共方法散落在不同文件夹中,同一个业务功能被拆到多个无关目录里。到后期,不管是开发者还是 AI,想修改一个功能,都要先花大量时间找文件、理解依赖关系,维护成本会明显上升。
project-structure 这个 Skill 的作用,就是在编码前先完成项目目录规划。它会以系统架构师的角色,同时读取《产品概述》和《技术栈》文档,把产品中的核心板块映射成实际代码模块,再结合所选技术栈的最佳实践,设计出清晰、可扩展的目录结构。
它遵循的核心原则是高内聚、低耦合。也就是说,相关代码应该放在一起,不相关的代码要尽量隔离。例如,在一个 Next.js 博客项目中,可以将用户认证、文章管理、阅读统计等功能拆分到不同业务模块中;公共组件、工具函数和第三方服务封装则单独放置,避免业务代码相互污染。
最终,这个 Skill 会输出specs/项目结构.md。这份文档不仅告诉 AI 代码应该写在哪里,也为后续开发提供统一规范。目录结构越清晰,AI 在生成、修改和扩展代码时越不容易跑偏,项目后期维护也会更加稳定。
