docs: 重构文档体系

openspec/config.yaml

@@ -3,8 +3,15 @@ schema: fast-drive
 context: |
   - 使用中文（注释、文档、交流），面向中文开发者
   - openspec文档的关键字按openspec规范使用，不要翻译为中文
-  - **优先阅读README.md和DEVELOPMENT.md**获取项目概览与开发规范，所有代码风格、命名、注解、依赖、API等规范以DEVELOPMENT.md为准
-  - 涉及模块结构、API、实体等变更时同步更新README.md
+  - **优先阅读docs/README.md**判断文档归属和本次任务需要读取的专题文档
+  - README.md用于项目概览、快速开始和用户入口；DEVELOPMENT.md用于开发入口、全局规则和质量门禁；CONTRIBUTING.md仅在新增或修改checker、贡献流程时必读
+  - 所有代码风格、命名、注解、依赖、API等开发规范以DEVELOPMENT.md和docs/development/下对应专题文档为准
+  - 新增或修改checker时必须阅读CONTRIBUTING.md和docs/development/checker-development.md
+  - 每次代码变更都必须执行文档影响分析：判断是否影响用户可见行为、配置格式、checker行为、expect规则、API、部署方式、开发流程、架构边界、测试规范或构建发布流程
+  - 若影响用户使用方式、配置格式、checker行为、expect规则、部署方式或运行行为，必须同步更新docs/user/下对应文档；README.md仅在项目定位、快速开始、核心能力列表或文档导航变化时更新
+  - 若影响开发流程、架构边界、质量门禁、测试规范、构建发布流程或checker开发机制，必须同步更新DEVELOPMENT.md、CONTRIBUTING.md或docs/development/下对应文档
+  - 若影响文档同步规则或文档归属矩阵，必须同步更新docs/README.md和openspec/config.yaml
+  - 若无需更新文档，必须在收尾说明中说明原因
   - 新增代码优先复用已有组件、工具、依赖库，不引入新依赖
   - 新增的逻辑必须编写完善的测试，并保证测试的正确性，不允许跳过任何测试
   - 这是基于bun实现的前端后一体化项目，使用bun作为唯一包管理器，严禁使用pnpm、npm，使用bunx运行工具，严禁使用npx、pnpx
@@ -20,10 +27,14 @@ context: |
   - （当前项目未上线，不需要考虑向前兼容）
 
 rules:
+  explore:
+    - 本项目openspec使用fast-drive自定义schema，变更文档只包含design.md和tasks.md，无proposal.md和specs
   design:
     - 先前的讨论技术方案要尽可能体现在设计文档中，便于指导实现阶段不偏离已定的技术路线
   tasks:
     - 一行一个任务，严禁任务内容跨行
     - 如果是代码存在更新必须
       - 执行完整的测试、代码检查、格式检查等质量保障手段
-      - 更新 README.md 和/或 DEVELOPMENT.md
+      - 执行文档影响分析，并按影响范围更新对应文档；若无需更新文档，必须在任务或收尾说明中明确写出原因
+      - 新增或修改checker时必须更新docs/user/checkers/下对应用户文档，并在checker开发机制变化时更新CONTRIBUTING.md或docs/development/checker-development.md
+      - 新增或修改配置字段时必须更新probe-config.schema.json、probes.example.yaml、docs/user/configuration.md或对应checker文档