项目导读
cursor-rules 的核心价值,不是“提供一堆能复制的提示词”,而是把 AI 协作约束沉淀成可版本控制、可审查、可持续维护的规则资产。阅读这套站点时,最有效的方法不是顺着目录逐页浏览,而是先建立心智模型,再回到规则目录做筛选。
建议阅读顺序
| 阶段 | 去哪里 | 你会得到什么 |
|---|---|---|
| 1. 规则地图 | 首页 | 先按规则家族理解 26 条 .mdc 规则 |
| 2. 分类选择 | 规则分类 | 判断项目需要哪些规则组合 |
| 3. 快速接入 | 快速开始 | 把选中的规则复制到目标项目 |
| 4. 架构证明 | 系统架构 | 理解目录、规则页和 JSON 资产如何生成 |
| 5. 研究参考 | 相关工作 | 了解同类方案和理论背景 |
三类读者的最短路径
面试官 / 架构评审
先看首页,再看系统架构总览和相关工作。这两页会直接回答”它解决什么问题””它与同类实践相比先进在哪里””它的工程设计是否自洽”。
准备接入的团队
先看规则哲学,再回到首页浏览目录。这样能先统一采用原则,再决定最小规则集合。
维护者与贡献者
在读完公开文档后,再跳到 docs/openspec/。公开站点负责解释产品定位,OpenSpec 负责项目控制、治理边界与维护工作流。
站点不是 README 的镜像
README 负责最短公开入口;站点负责建立信任、解释架构与降低采用摩擦;OpenSpec 负责项目控制。三者分工明确,才不会互相稀释信息密度。