aodw-skill 0.7.3

package/.aodw/07-optimization/token-usage-analysis.md

@@ -0,0 +1,253 @@
+# AODW Token 消耗分析与优化建议
+
+## 1. 问题确认
+
+用户反馈使用 AODW 过程中非常消耗 AI 的 token。经过分析，确实存在这个问题。
+
+### 1.1 Token 消耗统计
+
+**总体情况**：
+- 规则文件总数：46 个
+- 总文件大小：283.3 KB
+- 估算总 token：~72,504 tokens
+
+**典型工作流消耗**：
+- **创建新 RT (Spec-Lite)**：~16,338 tokens（6 个文件，63.8 KB）
+- **创建新 RT (Spec-Full)**：~24,275 tokens（8 个文件，94.8 KB）
+- **UI 相关任务**：~9,055 tokens（7 个文件，35.4 KB）
+- **代码实现阶段**：~10,971 tokens（5 个文件，42.9 KB）
+
+### 1.2 主要问题
+
+1. **强制文件加载过多**
+   - 每次创建 RT 都需要读取多个大文件（3-8 个）
+   - UI 任务需要额外读取 4 个 ui-kit 文件
+   - 审计阶段需要读取大型审计规则文件（17KB+）
+
+2. **文件大小问题**
+   - 最大的文件：18KB+（python-fastapi 编码规范）
+   - 多个文件超过 10KB
+   - 审计规则文件特别大（17KB+）
+
+3. **重复加载可能性**
+   - 某些文件被多次引用（如 `ai-coding-rules-common.md` 被引用 15 次）
+   - 不同阶段可能重复加载相同文件
+
+4. **缺乏按需加载机制**
+   - 规则要求"必须读取"，但没有明确"何时读取"
+   - 没有区分"必须立即读取"和"按需读取"
+
+---
+
+## 2. 优化建议
+
+### 2.1 按需加载策略（推荐）
+
+**核心原则**：只在需要时读取相关文件，而不是一次性加载所有文件。
+
+#### 优化方案 A：阶段化加载
+
+**当前问题**：
+- 创建 RT 时一次性加载 6-8 个文件
+- 所有文件都在上下文中，即使当前阶段不需要
+
+**优化方案**：
+- **阶段 1（创建 RT）**：只加载 `rt-manager.md`、`ai-interaction-rules.md`、`rt-id-generation-rules.md`
+- **阶段 2（Intake）**：按需加载 `ai-interaction-rules.md`（如果未加载）
+- **阶段 3（决策）**：按需加载 `spec-full-profile.md` 或 `spec-lite-profile.md`
+- **阶段 4（Spec/Plan）**：按需加载相关规范文件
+- **阶段 5（实现）**：按需加载编码规范文件
+- **阶段 6（审计）**：按需加载审计规则文件
+
+#### 优化方案 B：摘要索引模式
+
+**核心思路**：为大型文件创建摘要版本，AI 先读取摘要，需要详细信息时再读取完整文件。
+
+**实施方式**：
+1. 为每个大型规则文件创建 `xxx-summary.md`（1-2KB）
+2. 摘要包含：核心规则、关键检查点、详细规则位置
+3. AI 先读取摘要，根据摘要决定是否需要读取完整文件
+
+**示例**：
+```
+.aodw/03-standards/ai-coding-rules-summary.md  (摘要，~1KB)
+.aodw/03-standards/ai-coding-rules.md         (完整版，~11KB)
+```
+
+### 2.2 UI-Kit 优化
+
+**当前问题**：
+- UI 任务需要读取 4 个 ui-kit 文件（~670 tokens）
+- 这些文件内容相对简单，可以合并或精简
+
+**优化方案**：
+1. **合并文件**：将 4 个文件合并为 1 个 `ui-kit.md`（~2KB）
+2. **精简内容**：移除冗余说明，保留核心规则
+3. **按需加载**：只在 UI 任务时加载，非 UI 任务不加载
+
+### 2.3 审计规则优化
+
+**当前问题**：
+- 审计规则文件特别大（17KB+，~4,350 tokens）
+- 每次审计都需要加载完整文件
+
+**优化方案**：
+1. **拆分文件**：按审计类型拆分（需求审计、开发审计、综合审计）
+2. **摘要模式**：创建摘要版本，只包含核心检查点
+3. **按需加载**：只在执行审计时加载，不提前加载
+
+### 2.4 编码规范优化
+
+**当前问题**：
+- 编码规范文件被频繁引用（15+ 次）
+- 文件较大（11KB+）
+- 可能在不同阶段重复加载
+
+**优化方案**：
+1. **缓存机制**：如果已加载过，不再重复加载
+2. **摘要版本**：创建摘要，只包含关键规则
+3. **按技术栈分离**：前端/后端规范分开，只加载相关的
+
+### 2.5 规则文件精简
+
+**当前问题**：
+- 某些文件包含大量示例代码和说明
+- 可以精简为核心规则
+
+**优化方案**：
+1. **移除冗余示例**：保留 1-2 个关键示例即可
+2. **精简说明**：移除重复说明，保留核心规则
+3. **外部化示例**：将详细示例移到单独文件
+
+---
+
+## 3. 实施优先级
+
+### 高优先级（立即实施）
+
+1. **明确按需加载规则**
+   - 更新规则文件，明确"何时读取"而不是"必须读取"
+   - 区分"必须立即读取"和"按需读取"
+
+2. **UI-Kit 文件合并**
+   - 将 4 个文件合并为 1 个
+   - 精简内容，保留核心规则
+
+3. **创建文件加载指南**
+   - 明确每个阶段需要加载哪些文件
+   - 避免重复加载
+
+### 中优先级（后续优化）
+
+4. **创建摘要版本**
+   - 为大型文件创建摘要版本
+   - AI 先读取摘要，需要时再读取完整版
+
+5. **审计规则拆分**
+   - 按审计类型拆分文件
+   - 减少单次加载的文件大小
+
+6. **编码规范优化**
+   - 创建摘要版本
+   - 实施缓存机制
+
+### 低优先级（长期优化）
+
+7. **规则文件精简**
+   - 移除冗余内容
+   - 外部化详细示例
+
+8. **智能加载系统**
+   - 根据任务类型自动选择需要加载的文件
+   - 实施文件依赖关系管理
+
+---
+
+## 4. 具体优化措施
+
+### 4.1 更新规则文件，明确加载时机
+
+**当前表述**：
+> AI **必须**先读取并理解以下文件
+
+**优化后**：
+> AI **必须**在 [具体阶段/条件] 时读取并理解以下文件：
+> - 如果 [条件 A]：读取文件 X
+> - 如果 [条件 B]：读取文件 Y
+> - 否则：跳过
+
+### 4.2 创建文件加载指南
+
+在 `aodw-constitution.md` 中添加"文件加载策略"章节，明确：
+- 每个阶段需要加载哪些文件
+- 哪些文件可以按需加载
+- 哪些文件可以缓存
+
+### 4.3 优化 UI-Kit 文件
+
+- 合并 4 个文件为 1 个 `ui-kit.md`
+- 精简内容，保留核心规则
+- 总大小控制在 2KB 以内
+
+---
+
+## 5. 预期效果
+
+实施优化后，预期可以：
+
+1. **减少 50-70% 的 token 消耗**
+   - Spec-Lite RT 创建：从 ~16K tokens 降至 ~5-8K tokens
+   - Spec-Full RT 创建：从 ~24K tokens 降至 ~8-12K tokens
+   - UI 任务：从 ~9K tokens 降至 ~2-3K tokens
+
+2. **提升响应速度**
+   - 减少文件加载时间
+   - 减少上下文处理时间
+
+3. **保持功能完整性**
+   - 所有核心功能保持不变
+   - 只是优化了加载策略
+
+---
+
+## 6. 风险评估
+
+### 6.1 潜在风险
+
+1. **按需加载可能导致遗漏**
+   - 风险：AI 可能忘记在需要时加载文件
+   - 缓解：明确的加载指南和检查清单
+
+2. **摘要版本可能信息不足**
+   - 风险：摘要可能遗漏关键信息
+   - 缓解：摘要包含完整文件的引用，需要时可读取
+
+3. **用户学习成本**
+   - 风险：新的加载策略需要用户理解
+   - 缓解：提供清晰的文档和示例
+
+### 6.2 兼容性
+
+- 优化后的规则应该向后兼容
+- 支持"完整加载"和"按需加载"两种模式
+- 用户可以选择使用哪种模式
+
+---
+
+## 7. 下一步行动
+
+1. **立即行动**：
+   - 更新规则文件，明确加载时机
+   - 合并 UI-Kit 文件
+   - 创建文件加载指南
+
+2. **短期行动**（1-2 周）：
+   - 创建摘要版本
+   - 优化审计规则
+   - 实施缓存机制
+
+3. **长期行动**（1 个月+）：
+   - 规则文件精简
+   - 智能加载系统
+   - 性能监控和优化
+

package/.aodw/README.md

@@ -0,0 +1,26 @@
+# AODW 快速指南
+
+面向从零启动的新项目，说明这套 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/`。
+
+## 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`。
+
+> 可选：`.aodw/init.md` 中有面向 AI 工具的一键指令提示词，可直接粘贴给 Cursor/Claude/Codex 执行初始化。
+
+## 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 状态。  
+
+## 4. 给 AI 工具的加载方式
+- Cursor/Claude/Codex：确保可读取 `.cursor/aodw_all.mdc` 和 `.aodw/`（含 `.aodw/aodw_governance/`）、`RT/`。  
+- 如需显式提示，参考 `.aodw/init.md` 的指令，让 AI 自动完成初始化和首个 RT-CORE 创建。

package/.aodw/RELEASE-CHECKLIST.md

@@ -0,0 +1,144 @@
+# 编码规范融入 AODW - 发布前检查清单
+
+## ✅ 最终检查结果
+
+### 1. 核心流程文档修改 ✅
+
+- [x] **spec-full-profile.md**
+  - [x] Plan 模板添加"代码结构与分层设计"章节（第 4 节）
+  - [x] 添加"开发阶段要求"章节（第 6 节）
+  - [x] checklists 部分添加编码规范验收项
+  - [x] 已同步到 `templates/.aodw/02-workflow/spec-full-profile.md`
+
+- [x] **spec-lite-profile.md**
+  - [x] Plan-Lite 模板添加"代码结构与分层设计"章节（第 3 节）
+  - [x] 流程中添加开发准备、开发过程中、开发结束前自检要求
+  - [x] 已同步到 `templates/.aodw/02-workflow/spec-lite-profile.md`
+
+- [x] **git-discipline.md**
+  - [x] 添加"合并前检查清单"章节（第 5 节）
+  - [x] 编码规范检查作为合并的硬性要求
+  - [x] 自动化检查中添加编码规范检查（Step 2）
+  - [x] 已同步到 `templates/.aodw/01-core/git-discipline.md`
+
+- [x] **rt-manager.md**
+  - [x] Intake 流程中添加技术约束要求（第 180 行）
+  - [x] 已同步到 `templates/.aodw/02-workflow/rt-manager.md`
+
+### 2. 模板文件修改 ✅
+
+- [x] **rt-intake-template.md**
+  - [x] 添加"相关技术约束/规范"字段（第 6 节，可选）
+  - [x] 已同步到 `templates/.aodw/templates/rt-intake-template.md`
+
+- [x] **coding-standards-template.md**（新建）
+  - [x] 创建编码规范验收清单模板（103 行）
+  - [x] 包含前端、后端、通用编码规范验收项
+  - [x] 已同步到 `templates/.aodw/templates/checklists/coding-standards-template.md`
+
+### 3. 文件同步验证 ✅
+
+- [x] 所有核心流程文档已同步到模板目录
+- [x] 所有模板文件已同步到模板目录
+- [x] 新建的 checklists 目录已创建并同步
+
+### 4. 内容完整性验证 ✅
+
+- [x] Plan 模板包含完整的代码结构与分层设计内容
+- [x] 开发阶段要求包含完整的检查清单
+- [x] 合并前检查清单包含完整的编码规范检查项
+- [x] Intake 模板包含技术约束字段
+
+### 5. 引用路径验证 ✅
+
+- [x] 所有编码规范文件引用路径正确（`.aodw/ai-coding-rules-*.md`）
+- [x] 模板文件引用路径正确（`.aodw/templates/checklists/coding-standards-template.md`）
+
+### 6. 格式和语法验证 ✅
+
+- [x] Markdown 格式正确
+- [x] 标题层级正确
+- [x] 列表格式正确
+- [x] 代码块格式正确
+- [x] 无 Linter 错误
+
+---
+
+## 📋 修改文件清单
+
+### 核心流程文档（4 个文件）
+1. ✅ `.aodw/02-workflow/spec-full-profile.md` → `templates/.aodw/02-workflow/spec-full-profile.md`
+2. ✅ `.aodw/02-workflow/spec-lite-profile.md` → `templates/.aodw/02-workflow/spec-lite-profile.md`
+3. ✅ `.aodw/01-core/git-discipline.md` → `templates/.aodw/01-core/git-discipline.md`
+4. ✅ `.aodw/02-workflow/rt-manager.md` → `templates/.aodw/02-workflow/rt-manager.md`
+
+### 模板文件（2 个文件）
+5. ✅ `.aodw/templates/rt-intake-template.md` → `templates/.aodw/templates/rt-intake-template.md`
+6. ✅ `.aodw/templates/checklists/coding-standards-template.md`（新建）→ `templates/.aodw/templates/checklists/coding-standards-template.md`
+
+### 其他相关文件（已存在，本次未修改）
+- `.aodw/03-standards/ai-coding-rules.md`（已包含按需加载机制）
+- `.aodw/03-standards/stacks/react-typescript/ai-coding-rules-frontend.md`（已存在）
+- `.aodw/03-standards/stacks/python-fastapi/ai-coding-rules-backend.md`（已存在）
+- `.aodw/03-standards/ai-coding-rules-common.md`（已存在）
+
+---
+
+## 🎯 融入效果确认
+
+### ✅ 方案设计阶段
+- Plan 模板强制要求代码结构与分层设计
+- 编码规范符合性说明作为必填项
+- 防止"想到哪里写到哪里"
+
+### ✅ 开发阶段
+- 开发准备要求工具初始化和编码规范加载
+- 开发过程中要求遵守编码规范
+- 开发结束前要求自检
+
+### ✅ 提交/合并阶段
+- 编码规范检查作为合并的硬性要求
+- 未通过编码规范检查的代码不能合并
+- 确保代码质量
+
+### ✅ 测试/验收阶段
+- 编码规范验收清单模板已创建
+- 可作为补充验收项使用
+
+### ✅ 需求分析阶段
+- 技术约束字段已添加（可选）
+- AI 根据情况填写
+
+---
+
+## ✅ 最终结论
+
+**所有检查通过，可以提交新版本**
+
+编码规范已成功融入 AODW 的各个关键节点：
+- ✅ 不再是"挂一个子流程"，而是"嵌入到主流程的每个节点"
+- ✅ 编码规范成为流程的必经步骤
+- ✅ 编码规范成为质量门槛
+- ✅ 编码规范从设计阶段就开始参与
+
+所有文件已正确修改并同步到模板目录，可以提交新版本。
+
+---
+
+## 📝 提交建议
+
+建议提交信息：
+```
+feat(aodw): 将编码规范融入 AODW 各阶段流程
+
+- 在 Plan 模板中添加代码结构与分层设计章节（必须）
+- 在开发阶段添加编码规范要求（必须）
+- 在合并前检查清单中添加编码规范检查（必须）
+- 创建编码规范验收清单模板（可选）
+- 在 Intake 模板中添加技术约束字段（可选）
+
+编码规范已从"子流程"转变为"主流程的必经步骤"，
+确保代码质量从设计阶段就开始参与。
+
+Refs: [RT-ID]
+```

package/.aodw/config.yaml

@@ -0,0 +1,2 @@
+mode: collaborative
+server_url: http://114.67.218.31:2005

package/.aodw/manifest.yaml

@@ -0,0 +1,98 @@
+# AODW Manifest (Level 1 metadata)
+version: 0.4.6
+last_updated_at: 2026-01-01T22:11:47+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]
+
+  - 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]
+
+  - 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]
+
+  - 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]
+
+  - 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]
+
+  - 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]
+
+  - 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]
+
+  - 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]
+
+  - 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]
+
+  - id: 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]