aodw-skill 0.7.13 → 0.7.17

package/.aodw-next/README.md

@@ -1,26 +1,59 @@
-# AODW 快速指南
+# AODW — AI 编排开发工作流
 
-面向从零启动的新项目，说明这套 AI-Orchestrated Development Workflow 的组成与最小操作步骤。
+## 规则文件索引
 
-## 1. 目录与组成
-- `.aodw/`：核心规则（宪法、AI 行为、知识维护、交互、模块文档、Spec Full/Lite Profile、RT Manager、模板）以及 `.aodw/aodw_governance/` 治理与版本记录。
-- `.cursor/`：运行时规则（`aodw_all.mdc` 等）供 Cursor/Claude/Codex 等加载。
-- `RT/index.yaml`：RT 全局索引；每个 RT 放在 `RT/RT-XXX/`。
+详细索引见 `manifest.yaml`。分层概览：
 
-## 2. 初始化新仓库
-1) 直接把上述目录/文件拷贝到仓库根目录。  
-2) 在 `.aodw/06-project/modules-index.yaml` 登记实际模块；为每个模块用 `.aodw/templates/module-readme-template.md` 生成 README（建议放 `docs/modules/<name>.md`），写明职责/映射/不变量/历史。  
-3) 创建 `RT/RT-001/`（Spec-Full）：复制 `.aodw/templates/rt-meta-template.yaml` 为 `meta.yaml`，初始化 intake/decision/spec/plan/impact/invariants/tests/changelog，记录"启用 AODW"的决策；在 `RT/index.yaml` 登记并更新 `last_updated_at`（必须使用系统命令或 API 获取真实时间）。  
-4) 确认团队约定：分支前缀 `feature|bugfix|refactor/RT-XXX-short-name`，提交信息包含 `Refs: RT-XXX`。
+### 01-core（核心规范）
+- `aodw-constitution.md` — 最高行为准则
+- `git-discipline.md` — Git + Worktree + 确认门控
+- `ai-interaction-rules.md` — AI 提问与交互协议
+- `ai-knowledge-rules.md` — 文档系统与知识同步
+- `csf-thinking-framework.md` — CSF 决策思考框架
+- `module-doc-rules.md` — 模块文档编写规范
 
-> 可选：`.aodw/init.md` 中有面向 AI 工具的一键指令提示词，可直接粘贴给 Cursor/Claude/Codex 执行初始化。
+### 02-workflow（工作流）
+- `rt-manager.md` — RT 完整生命周期管理
+- `spec-full-profile.md` — Spec-Full 执行规范（复杂变更）
+- `spec-lite-profile.md` — Spec-Lite 执行规范（简单变更）
+- `ui-workflow-rules.md` — UI 专项开发流程
+- `rt-id-generation-rules.md` — RT ID 本地生成规则
 
-## 3. 日常使用流程（简）
-1) 有需求/bug/改进时，让 AI 依 `/.aodw/01-core/ai-interaction-rules.md` 提问并创建/挂接 RT（Spec-Lite vs Spec-Full 依规则判定）。  
-2) 为该 RT 填充必要文件（meta/intake/decision/spec(-lite)/plan(-lite)/impact/invariants/tests/changelog），并同步 `RT/index.yaml`。  
-3) 按 `.aodw/03-standards/ai-coding-rules.md`、`.aodw/01-core/ai-knowledge-rules.md` 开发：小步提交、保持文档与代码一致、更新模块 README。  
-4) 完成前做一致性检查（meta/index、spec/plan/impact/tests、模块 README、不变量），确认后合并并更新 RT 状态。  
+### 03-standards（编码规范）
+- `ai-coding-rules.md` — 通用编码规范
+- `ai-coding-rules-common.md` — 通用规范补充
+- `stacks/` — 技术栈专项规范（按需加载）
 
-## 4. 给 AI 工具的加载方式
-- Cursor/Claude/Codex：确保可读取 `.cursor/aodw_all.mdc` 和 `.aodw/`（含 `.aodw/aodw_governance/`）、`RT/`。  
-- 如需显式提示，参考 `.aodw/init.md` 的指令，让 AI 自动完成初始化和首个 RT-CORE 创建。
+### 04-auditors（审计器）
+- `aodw-requirement-auditor-rules.md` — 需求审计
+- `aodw-development-auditor-rules.md` — 开发审计
+- `aodw-full-auditor-rules.md` — 完整审计规则集
+
+### 05-tooling（工具配置）
+- `ai-tools-init-rules.md` — 开发工具初始化
+
+### 06-project（项目特化层 — 每个项目单独配置）
+- `ai-overview.md` — 项目技术栈与架构概览 ⚠️
+- `modules-index.yaml` — 项目模块索引 ⚠️
+
+### templates（文档模板）
+RT 生命周期各阶段文档的标准模板。
+
+---
+
+## 新项目安装
+
+1. 将 `.aodw-next/` 目录复制到新项目根目录
+2. 重写项目特化文件：
+   - `06-project/ai-overview.md` — 填写技术栈、架构、模块结构
+   - `06-project/modules-index.yaml` — 填写模块列表
+3. 在项目的 AI 配置文件中添加引用（如 CLAUDE.md）
+
+---
+
+## 版本信息
+
+- AODW 版本：0.5.1
+- Spec-Full Profile：v2.0（Skill 化）
+- Spec-Lite Profile：v2.0（Skill 化）
+- git-discipline：v2.0（Worktree + 确认门控）

package/.aodw-next/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: aodw
+description: AODW (AI-Orchestrated Development Workflow) — 完整的 AI 协作开发工作流体系。当用户涉及以下任意场景时必须加载本 skill：新建 RT / 需求 / 功能 / 任务、立项、分支管理、worktree 创建与清理、Spec-Full / Spec-Lite 开发流程、代码提交与合并、RT 审查与完成、AODW 规范检查。关键触发词：RT、立项、新需求、开发任务、feature 分支、worktree、spec、intake、决策、实现、验收。本 skill 管理从立项到合并的完整开发生命周期。
+---
+
+# AODW — AI 编排开发工作流 (v0.5.1)
+
+用 **RT（Request Ticket）** 追踪每个开发任务，通过文档驱动、分支隔离、Gate 检查点和确认门控执行。
+
+## 加载顺序（渐进式披露，优先读 summary）
+
+1. **总是加载**：`01-core/aodw-constitution-summary.md`（最高行为准则）
+2. **按场景追加**（优先读 `*-summary.md`，需要细节时再读完整版）：
+
+| 场景 | 追加加载 |
+|------|---------|
+| 立项 / 创建 RT | `rt-manager-summary.md` + `ai-interaction-rules-summary.md` + `rt-id-generation-rules.md` |
+| Spec-Lite 执行 | `spec-lite-profile-summary.md` + `git-discipline-summary.md` |
+| Spec-Full 执行 | `spec-full-profile-summary.md` + `ai-coding-rules.md`（按技术栈） |
+| Git 操作 / 合并 | `git-discipline.md`（完整版） |
+| 审计 | `04-auditors/aodw-requirement-auditor-rules.md` |
+| 知识同步 | `ai-knowledge-rules-summary.md` |
+
+## 核心概念
+
+- **RT 生命周期**：`created → intaking → decided → in-progress → reviewing → done`
+- **一个 RT = 一个 Worktree = 一个 Feature 分支**（`feature/RT-XXX-name`）
+- **Spec-Full**：跨模块/数据模型/API 变更/高风险 → 完整 spec+plan+审计
+- **Spec-Lite**：单模块/bug 修复/低风险 → 单文件 `rt-lite.md`
+- **确认门控**：commit/merge/push/worktree 操作前必须向用户确认
+- **规则索引**：详见 `manifest.yaml`
+- **新项目安装**：详见 `README.md`

package/.aodw-next/config.yaml

@@ -1,2 +1,2 @@
-mode: collaborative
-server_url: http://114.67.218.31:2005
+mode: independent
+# RT-ID 政策：统一使用本地生成，不再依赖远程分配服务

package/.aodw-next/manifest.yaml

@@ -1,98 +1,105 @@
 # AODW Manifest (Level 1 metadata)
-version: 0.4.6
-last_updated_at: 2026-01-01T22:11:47+08:00
+version: 0.5.1
+last_updated_at: 2026-04-19T10:55:00+08:00
 summary_preferred: true
 
 rules:
   - id: aodw-constitution
     name: AODW Constitution
     description: Kernel principles and universal standards for AODW.
-    path: .aodw/01-core/aodw-constitution.md
-    summary_path: .aodw/01-core/aodw-constitution-summary.md
-    size_kb: 16.2
-    priority: critical
-    tags: [core, always-load]
-    load_when: [always]
+    path: 01-core/aodw-constitution.md
 
   - id: ai-interaction-rules
     name: AI Interaction Rules
     description: Standard question/answer protocol and interaction constraints.
-    path: .aodw/01-core/ai-interaction-rules.md
-    size_kb: 7.7
-    priority: high
-    tags: [interaction, ui, questions]
-    load_when: [intake, decision, clarify]
+    path: 01-core/ai-interaction-rules.md
 
   - id: ai-knowledge-rules
     name: AI Knowledge Rules
     description: Documentation system, modules index, and knowledge sync rules.
-    path: .aodw/01-core/ai-knowledge-rules.md
-    size_kb: 9.5
-    priority: high
-    tags: [knowledge, docs]
-    load_when: [design, implementation, review]
+    path: 01-core/ai-knowledge-rules.md
 
   - id: git-discipline
     name: Git Discipline
-    description: Branching, commits, and completion rules.
-    path: .aodw/01-core/git-discipline.md
-    size_kb: 6.7
-    priority: high
-    tags: [git, workflow]
-    load_when: [implementation, review, completion]
+    description: Branching, commits, worktree management, and confirm-gated execution rules.
+    path: 01-core/git-discipline.md
 
   - id: rt-manager
     name: RT Manager
     description: RT lifecycle, branch rules, and mandatory checks.
-    path: .aodw/02-workflow/rt-manager.md
-    summary_path: .aodw/02-workflow/rt-manager-summary.md
-    size_kb: 14.7
-    priority: critical
-    tags: [workflow, rt]
-    load_when: [create-rt, manage-rt]
+    path: 02-workflow/rt-manager.md
 
   - id: spec-full-profile
     name: Spec-Full Profile
     description: Full specification workflow for complex changes.
-    path: .aodw/02-workflow/spec-full-profile.md
-    summary_path: .aodw/02-workflow/spec-full-profile-summary.md
-    size_kb: 13.7
-    priority: high
-    tags: [profile, spec-full]
-    load_when: [spec-full]
+    path: 02-workflow/spec-full-profile.md
 
   - id: spec-lite-profile
     name: Spec-Lite Profile
     description: Lightweight workflow for low-risk changes.
-    path: .aodw/02-workflow/spec-lite-profile.md
-    size_kb: 10.3
-    priority: medium
-    tags: [profile, spec-lite]
-    load_when: [spec-lite]
+    path: 02-workflow/spec-lite-profile.md
 
   - id: ui-workflow-rules
     name: UI Workflow Rules
     description: UI-specific process requirements and gates.
-    path: .aodw/02-workflow/ui-workflow-rules.md
-    size_kb: 13.0
-    priority: medium
-    tags: [ui, workflow]
-    load_when: [ui-task]
+    path: 02-workflow/ui-workflow-rules.md
 
   - id: ai-coding-rules
     name: AI Coding Rules
     description: General coding standards and style constraints.
-    path: .aodw/03-standards/ai-coding-rules.md
-    size_kb: 11.2
-    priority: medium
-    tags: [coding, standards]
-    load_when: [implementation]
+    path: 03-standards/ai-coding-rules.md
 
-  - id: requirement-auditor
+  - id: aodw-requirement-auditor
     name: Requirement Auditor Rules
     description: Spec-Full requirement audit rules and outputs.
-    path: .aodw/04-auditors/aodw-requirement-auditor-rules.md
-    size_kb: 17.0
-    priority: high
-    tags: [audit, requirements]
-    load_when: [spec-full, audit]
+    path: 04-auditors/aodw-requirement-auditor-rules.md
+
+  - id: aodw-development-auditor
+    name: Development Auditor Rules
+    description: Implementation-phase audit rules covering code quality and spec compliance.
+    path: 04-auditors/aodw-development-auditor-rules.md
+
+  - id: aodw-full-auditor
+    name: Full Auditor Rules
+    description: Complete auditor rule set combining requirement and development audits.
+    path: 04-auditors/aodw-full-auditor-rules.md
+
+  - id: csf-thinking-framework
+    name: CSF Thinking Framework
+    description: Structured thinking framework for decision-making during spec and design phases.
+    path: 01-core/csf-thinking-framework.md
+
+  - id: module-doc-rules
+    name: Module Documentation Rules
+    description: Rules for writing and maintaining module-level documentation.
+    path: 01-core/module-doc-rules.md
+
+  - id: ai-project-overview-rules
+    name: AI Project Overview Rules
+    description: Rules for initializing and maintaining project overview file.
+    path: 01-core/ai-project-overview-rules.md
+
+  - id: rt-id-generation-rules
+    name: RT ID Generation Rules
+    description: Rules for generating and managing RT sequence IDs locally.
+    path: 02-workflow/rt-id-generation-rules.md
+
+  - id: ai-tools-init-rules
+    name: AI Tools Init Rules
+    description: Rules for initializing and verifying development tooling (ESLint, Prettier, Ruff, Black, etc.).
+    path: 05-tooling/ai-tools-init-rules.md
+
+  - id: ai-coding-rules-common
+    name: AI Coding Rules Common
+    description: Common coding standards shared across all tech stacks (file size, complexity, naming).
+    path: 03-standards/ai-coding-rules-common.md
+
+  - id: project-ai-overview
+    name: Project AI Overview
+    description: Current project tech stack, architecture, and module overview. Project-specific — must be rewritten for each project.
+    path: templates/ai-overview.template.md
+
+  - id: project-modules-index
+    name: Project Modules Index
+    description: Index of all modules in current project. Project-specific — updated after each RT completion (knowledge distillation).
+    path: templates/modules-index.template.yaml

package/.aodw-next/project.yaml

@@ -0,0 +1 @@
+project_name: VoiceX

package/.aodw-next/templates/TEMPLATE-APPLICATION-GUIDE.md

@@ -2,11 +2,11 @@
 
 ## 1. 模板机制概述
 
-AODW 使用**统一模板机制**来生成各个平台的适配器文件，确保所有平台的内容保持一致。
+AODW Next 使用**统一模板机制**来生成各个平台的适配器文件，确保所有平台的内容保持一致。
 
 ### 1.1 模板位置
 
-**源模板**：`.aodw/templates/aodw-kernel-loader-template.md`
+**源模板**：`.aodw-next/templates/aodw-kernel-loader-template.md`
 
 这个模板包含所有平台的通用内容，使用占位符标记平台差异：
 - `{{REF_PREFIX}}` - 引用前缀（Cursor: `@`，其他: 空）
@@ -14,27 +14,21 @@ AODW 使用**统一模板机制**来生成各个平台的适配器文件，确
 ### 1.2 适配器文件位置
 
 **生成的适配器文件**（在源仓库中）：
-- `templates/AODW_Adapters/antigravity/.agent/rules/aodw.md`
-- `templates/AODW_Adapters/cursor/.cursor/rules/aodw.mdc`
+- `templates/AODW_Adapters/antigravity/.agent/rules/aodw-next.md`
+- `templates/AODW_Adapters/cursor/.cursor/rules/aodw-next.mdc`
 - `templates/AODW_Adapters/claude/CLAUDE.md`
-- `templates/AODW_Adapters/gemini/.agent/rules/aodw.md`
+- `templates/AODW_Adapters/gemini/.agent/rules/aodw-next.md`
 - `templates/AODW_Adapters/general/AGENTS.md`
 
-**注意**：这些文件是**回退方案**，用于向后兼容。CLI 安装时会优先使用模板直接生成。
+**注意**：适配器文件在用户项目中安装到对应位置。
 
 ---
 
 ## 2. 模板处理流程
 
-### 2.1 开发阶段（源仓库）
+### 2.1 安装阶段（用户项目）
 
-1. **修改模板**：编辑 `.aodw/templates/aodw-kernel-loader-template.md`
-2. **更新适配器**：运行 `node cli/bin/update-adapters-from-template.js`
-3. **提交更改**：提交模板和生成的适配器文件
-
-### 2.2 安装阶段（用户项目）
-
-1. **CLI 检测模板**：检查 `.aodw/templates/aodw-kernel-loader-template.md` 是否存在
+1. **CLI 检测模板**：检查 `.aodw-next/templates/aodw-kernel-loader-template.md` 是否存在
 2. **使用 Processor**：根据平台选择对应的 Processor
 3. **生成适配器文件**：在用户项目中生成适配器文件
 
@@ -47,56 +41,19 @@ AODW 使用**统一模板机制**来生成各个平台的适配器文件，确
 
 ---
 
-## 3. 如何更新模板
-
-### 3.1 修改模板文件
-
-编辑 `.aodw/templates/aodw-kernel-loader-template.md`，例如：
-
-```markdown
-| **执行需求审计** | {{REF_PREFIX}}.aodw/04-auditors/aodw-requirement-auditor-rules.md | ... |
-```
-
-### 3.2 更新适配器文件
-
-运行更新脚本：
-
-```bash
-node cli/bin/update-adapters-from-template.js
-```
-
-这个脚本会：
-1. 读取模板文件
-2. 使用各个 Processor 处理模板
-3. 生成各个平台的适配器文件到 `templates/AODW_Adapters/`
-
-### 3.3 验证更新
-
-检查生成的适配器文件：
-
-```bash
-# Antigravity（应该没有 {{REF_PREFIX}}）
-cat templates/AODW_Adapters/antigravity/.agent/rules/aodw.md | grep "执行需求审计"
-
-# Cursor（应该有 @）
-cat templates/AODW_Adapters/cursor/.cursor/rules/aodw.mdc | grep "执行需求审计"
-```
-
----
-
-## 4. Processor 说明
+## 3. Processor 说明
 
-### 4.1 AntigravityProcessor
+### 3.1 AntigravityProcessor
 
 **处理**：
 - 替换 `{{REF_PREFIX}}` 为空字符串
 - 注入 `trigger: always_on` frontmatter（仅对 kernel loader）
 
 **输出**：
-- 文件：`templates/AODW_Adapters/antigravity/.agent/rules/aodw.md`
+- 文件：`templates/AODW_Adapters/antigravity/.agent/rules/aodw-next.md`
 - 格式：Markdown with frontmatter
 
-### 4.2 CursorProcessor
+### 3.2 CursorProcessor
 
 **处理**：
 - 替换 `{{REF_PREFIX}}` 为 `@`
@@ -104,10 +61,10 @@ cat templates/AODW_Adapters/cursor/.cursor/rules/aodw.mdc | grep "执行需求
 - 文件扩展名改为 `.mdc`
 
 **输出**：
-- 文件：`templates/AODW_Adapters/cursor/.cursor/rules/aodw.mdc`
+- 文件：`templates/AODW_Adapters/cursor/.cursor/rules/aodw-next.mdc`
 - 格式：Markdown with Cursor-specific frontmatter
 
-### 4.3 ClaudeProcessor
+### 3.3 ClaudeProcessor
 
 **处理**：
 - 替换 `{{REF_PREFIX}}` 为空字符串
@@ -117,17 +74,17 @@ cat templates/AODW_Adapters/cursor/.cursor/rules/aodw.mdc | grep "执行需求
 - 文件：`templates/AODW_Adapters/claude/CLAUDE.md`
 - 格式：标准 Markdown
 
-### 4.4 GeminiProcessor
+### 3.4 GeminiProcessor
 
 **处理**：
 - 替换 `{{REF_PREFIX}}` 为空字符串
 - 不注入 frontmatter
 
 **输出**：
-- 文件：`templates/AODW_Adapters/gemini/.agent/rules/aodw.md`
+- 文件：`templates/AODW_Adapters/gemini/.agent/rules/aodw-next.md`
 - 格式：标准 Markdown
 
-### 4.5 GeneralProcessor
+### 3.5 GeneralProcessor
 
 **处理**：
 - 替换 `{{REF_PREFIX}}` 为空字符串
@@ -139,108 +96,15 @@ cat templates/AODW_Adapters/cursor/.cursor/rules/aodw.mdc | grep "执行需求
 
 ---
 
-## 5. CLI 安装流程
-
-### 5.1 安装脚本逻辑
-
-```javascript
-// 1. 检查模板是否存在
-if (fs.existsSync(SOURCE_TEMPLATE)) {
-  // 2. 使用模板 + Processor 生成适配器文件
-  await installFile(SOURCE_TEMPLATE, targetPath, Processor);
-} else {
-  // 3. 回退到旧文件（向后兼容）
-  await installFile(sourceAdapterFile, targetPath, Processor);
-}
-```
-
-### 5.2 安装路径
-
-**用户项目中的适配器文件**：
-- Antigravity: `.agent/rules/aodw.md`
-- Cursor: `.cursor/rules/aodw.mdc`
-- Claude: `.claude/CLAUDE.md`
-- Gemini: `.agent/rules/aodw.md`
-- General: `.aodw/AGENTS.md`
-
----
-
-## 6. 最佳实践
-
-### 6.1 修改模板后
-
-1. ✅ **必须运行更新脚本**：`node cli/bin/update-adapters-from-template.js`
-2. ✅ **验证生成的适配器文件**：检查各个平台的文件是否正确
-3. ✅ **提交所有更改**：包括模板和生成的适配器文件
-
-### 6.2 添加新平台
-
-1. 创建新的 Processor（继承 `BaseProcessor`）
-2. 在 `update-adapters-from-template.js` 中添加新平台的更新逻辑
-3. 在 `cli/bin/aodw.js` 中添加新平台的安装逻辑
-
-### 6.3 模板占位符
-
-**当前占位符**：
-- `{{REF_PREFIX}}` - 引用前缀
-
-**添加新占位符**：
-1. 在模板中使用 `{{PLACEHOLDER_NAME}}`
-2. 在各个 Processor 的 `transform` 方法中处理占位符
-
----
-
-## 7. 故障排查
-
-### 7.1 模板未应用
-
-**问题**：用户项目中的适配器文件还是旧内容
-
-**原因**：
-- 模板文件不存在（CLI 回退到旧文件）
-- Processor 处理失败
-
-**解决**：
-1. 检查 `.aodw/templates/aodw-kernel-loader-template.md` 是否存在
-2. 检查 Processor 是否正确处理占位符
-3. 重新运行 `aodw init`
-
-### 7.2 占位符未替换
-
-**问题**：生成的适配器文件中还有 `{{REF_PREFIX}}`
-
-**原因**：
-- Processor 的 `transform` 方法未正确处理占位符
-
-**解决**：
-1. 检查 Processor 的 `transform` 方法
-2. 确保使用 `replace` 方法替换占位符
-
-### 7.3 Frontmatter 未注入
-
-**问题**：生成的适配器文件缺少 frontmatter
-
-**原因**：
-- Processor 的 `injectFrontmatter` 方法未正确调用
-
-**解决**：
-1. 检查 Processor 的 `transform` 方法
-2. 确保在适当的时候调用 `injectFrontmatter`
-
----
-
-## 8. 相关文件
+## 4. 相关文件
 
-- **模板文件**：`.aodw/templates/aodw-kernel-loader-template.md`
-- **更新脚本**：`cli/bin/update-adapters-from-template.js`
+- **模板文件**：`.aodw-next/templates/aodw-kernel-loader-template.md`
 - **Processor 实现**：`cli/bin/processors/index.js`
 - **CLI 安装脚本**：`cli/bin/aodw.js`
 - **适配器文件**：`templates/AODW_Adapters/`
 
 ---
 
-## 9. 版本历史
+## 5. 版本历史
 
-- **v4.0.0**：引入统一模板机制
-- **v4.0.1**：添加审计官命令索引
-- **v4.0.2**：更新模板应用指南
+- **v4.0.0**：AODW Next，统一使用 `.aodw-next` 目录

package/.aodw-next/templates/ai-overview.template.md

@@ -0,0 +1,72 @@
+# AI System Overview
+（本文件列出 AI 理解本系统所需的全局信息）
+
+> ⚠️ **项目特化文件**：本文件描述当前项目的技术栈与架构，是 AODW skill 的项目层配置。
+> 在新项目中安装 AODW 时，必须完整重写本文件。
+>
+> 说明：本文件是骨架模板，AI 可以在后续 RT 中逐步补全。
+> 修改架构或模块职责时，AI 必须同步更新本文件。
+
+---
+
+## 1. 技术栈
+
+<!-- AUTO-DETECTED: 以下内容由 AI 自动检测 -->
+- **前端**：（待补充）
+- **后端**：（待补充）
+- **数据库**：（待补充）
+- **消息系统**：（待补充）
+- **缓存**：（待补充）
+- **运维 / 部署**：（待补充）
+- **其他**：（待补充）
+<!-- END AUTO-DETECTED -->
+
+---
+
+## 2. 整体架构概览
+
+<!-- AUTO-DETECTED: 以下内容由 AI 自动检测 -->
+（待补充 - 建议包含架构图或架构描述）
+<!-- END AUTO-DETECTED -->
+
+---
+
+## 3. 目录结构
+
+<!-- AUTO-DETECTED: 以下内容由 AI 自动检测 -->
+```
+（待补充 - 列出关键目录及其用途）
+```
+<!-- END AUTO-DETECTED -->
+
+---
+
+## 4. 核心业务模块职责
+
+<!-- AUTO-DETECTED: 以下内容由 AI 自动检测 -->
+（待补充 - 列出核心模块及其职责）
+<!-- END AUTO-DETECTED -->
+
+---
+
+## 5. 系统级 Invariants（不可破坏原则）
+
+<!-- USER-ADDED: 以下内容由用户或 AI 引导添加 -->
+（待补充 - 列出系统必须保持的不变条件）
+<!-- END USER-ADDED -->
+
+---
+
+## 6. 模块 README 映射表
+
+<!-- AUTO-DETECTED: 以下内容由 AI 自动生成 -->
+（待补充 - 映射模块路径到对应的 README 文件）
+<!-- END AUTO-DETECTED -->
+
+---
+
+## 7. 历史关键变更
+
+<!-- USER-ADDED: 以下内容由用户或 AI 引导添加 -->
+（待补充 - 记录架构或关键模块的历史变更）
+<!-- END USER-ADDED -->