aodw-skill 0.7.3

package/.aodw/templates/rt-meta-template.yaml

@@ -0,0 +1,43 @@
+# RT 元数据模板（单个 RT 的权威信息）
+# 路径建议：.aodw/templates/rt-meta-template.yaml
+
+id: RT-XXX                     # 由 RT-Manager 生成，例如 RT-001
+title: <在此填写简短标题>        # 例如 "修复订单列表加载缓慢的问题"
+
+# RT 类型：用于分类与统计
+# 可选值：Feature | Bug | Enhancement | Refactor | Research | AODW
+type: Bug
+
+# 使用的 AODW Profile
+# 可选值：Spec-Full | Spec-Lite
+profile: Spec-Lite
+
+# 当前状态
+# 可选值：created | intakeing | decided | in-progress | reviewing | done
+status: created
+
+# 涉及的业务/技术模块标识，来自你的模块体系（例如 orders / users / auth 等）
+modules: []
+
+# 当前主要执行工具：cursor / claude / mixed / unknown
+tool: unknown
+
+# 负责人（可选，可以是人名、昵称或账号）
+owner: null
+
+# 时间字段（必须使用系统命令或 API 获取真实时间，禁止 AI 自行推断）
+# 获取方法：date -u +"%Y-%m-%dT%H:%M:%SZ" 或 new Date().toISOString()
+# 格式：ISO8601（如 2025-11-28T11:54:45Z 或 2025-11-28T19:54:45+08:00）
+created_at: <to-be-filled>
+updated_at: <to-be-filled>
+closed_at: null
+
+# 与外部系统（JIRA / GitHub Issues 等）的关联 ID
+external_ids:
+  jira: null
+  github: null
+  other: null
+
+# 额外说明（可选，供人和 AI 阅读）
+notes: >
+  在这里简要描述本 RT 的背景、限制或特殊说明。

package/.aodw/templates/spec-lite-template.md

@@ -0,0 +1,17 @@
+# Spec-Lite: RT-XXX - <short title>
+
+## 1. 背景（Context）
+- 当前存在的问题 / 需求：
+
+## 2. 目标（Goal）
+- 希望达到的业务 / 用户效果：
+
+## 3. 当前行为（Current Behavior）
+- 当前系统在相关场景下的行为：
+
+## 4. 期望行为（Desired Behavior）
+- 修改后的预期行为：
+
+## 5. 影响范围（Scope）
+- 涉及模块 / 文件：
+- 预期不应影响的功能：

package/.aodw/templates/tests-template.md

@@ -0,0 +1,13 @@
+# Tests: RT-XXX - <short title>
+
+## 1. 新增测试用例（New Tests）
+- [ ] 描述用例 1（对应测试文件路径）
+- [ ] 描述用例 2
+
+## 2. 回归测试（Regression）
+- [ ] 回归用例 1
+- [ ] 回归用例 2
+
+## 3. 手动验证建议（Manual Checks）
+- [ ] 手动步骤 1
+- [ ] 手动步骤 2

package/.aodw/templates/tools-config/README.md

@@ -0,0 +1,80 @@
+# 工具配置模板
+
+本目录包含 AODW 规范要求的开发工具配置模板。
+
+## 目录结构
+
+```
+tools-config/
+├── frontend/          # 前端工具配置模板
+│   ├── eslint.config.template.json
+│   ├── prettier.config.template.json
+│   └── tsconfig.paths.template.json
+├── backend/           # 后端工具配置模板
+│   ├── ruff.config.template.toml
+│   ├── black.config.template.toml
+│   └── pre-commit.config.template.yaml
+└── README.md
+```
+
+## 使用方式
+
+### 方式 1：通过 CLI 命令
+
+```bash
+aodw init-tools
+```
+
+CLI 会自动检测项目类型，并使用相应的模板生成配置文件。
+
+### 方式 2：通过 AI 命令
+
+在 AI 工具（Cursor/Claude 等）中说：
+- "初始化工具"
+- "设置开发工具"
+- "配置工具"
+
+AI 会引导您完成工具初始化和配置。
+
+## 配置说明
+
+### 前端配置
+
+#### ESLint 配置
+- 文件：`.eslintrc.json` 或 `eslint.config.js`
+- 模板：`frontend/eslint.config.template.json`
+- 包含：TypeScript、React、Hooks、Import、可访问性规则
+- 限制：文件大小、函数长度、复杂度
+
+#### Prettier 配置
+- 文件：`.prettierrc.json` 或 `prettier.config.js`
+- 模板：`frontend/prettier.config.template.json`
+- 包含：代码格式化规则
+
+#### TypeScript Path Alias
+- 文件：`tsconfig.json`
+- 模板：`frontend/tsconfig.paths.template.json`
+- 包含：路径别名配置（@app、@pages、@features、@shared）
+
+### 后端配置
+
+#### Ruff 配置
+- 文件：`pyproject.toml`（合并到 `[tool.ruff]` 部分）
+- 模板：`backend/ruff.config.template.toml`
+- 包含：代码质量检查、复杂度限制
+
+#### Black 配置
+- 文件：`pyproject.toml`（合并到 `[tool.black]` 部分）
+- 模板：`backend/black.config.template.toml`
+- 包含：代码格式化规则
+
+#### pre-commit 配置
+- 文件：`.pre-commit-config.yaml`
+- 模板：`backend/pre-commit.config.template.yaml`
+- 包含：Git 提交前检查钩子
+
+## 注意事项
+
+1. **配置文件合并**：如果配置文件已存在，工具初始化会询问您是否合并配置
+2. **模板更新**：模板更新不会自动应用到已有项目，需要重新运行工具初始化
+3. **自定义配置**：您可以在工具初始化后手动调整配置，但建议保持核心规范不变

package/.aodw/templates/tools-config/backend/black.config.template.toml

@@ -0,0 +1,6 @@
+# Black 配置模板（TOML 片段）
+# 需要合并到 pyproject.toml 的 [tool.black] 部分
+
+[tool.black]
+line-length = 100
+target-version = ["py311"]

package/.aodw/templates/tools-config/backend/pre-commit.config.template.yaml

@@ -0,0 +1,16 @@
+repos:
+  - repo: local
+    hooks:
+      - id: backend-ruff
+        name: Backend Ruff Check
+        entry: ruff check .
+        language: system
+        pass_filenames: false
+        always_run: true
+
+      - id: backend-black
+        name: Backend Black Format
+        entry: black .
+        language: system
+        pass_filenames: false
+        always_run: true

package/.aodw/templates/tools-config/backend/ruff.config.template.toml

@@ -0,0 +1,23 @@
+# Ruff 配置模板（TOML 片段）
+# 需要合并到 pyproject.toml 的 [tool.ruff] 部分
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = [
+  "E",    # 基本语法错误
+  "F",    # 未使用变量、导入等
+  "I",    # import 排序
+  "PLR",  # 复杂度 & 过长函数（核心）
+]
+ignore = []
+
+# ✅ 重点拦截：
+# PLR0915 -> 函数语句过多（怪物函数）
+# PLR0912 -> 分支过多
+# PLR0911 -> return 过多
+
+[tool.ruff.lint.per-file-ignores]
+"__init__.py" = ["F401"]

package/.aodw/templates/tools-config/frontend/eslint.config.template.json

@@ -0,0 +1,113 @@
+{
+  "root": true,
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": 2022,
+    "sourceType": "module",
+    "ecmaFeatures": {
+      "jsx": true
+    },
+    "project": "./tsconfig.json"
+  },
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "plugin:react/recommended",
+    "plugin:react-hooks/recommended",
+    "plugin:import/recommended",
+    "plugin:import/typescript",
+    "plugin:jsx-a11y/recommended",
+    "prettier"
+  ],
+  "plugins": [
+    "@typescript-eslint",
+    "react",
+    "react-hooks",
+    "import",
+    "jsx-a11y"
+  ],
+  "settings": {
+    "react": {
+      "version": "detect"
+    },
+    "import/resolver": {
+      "typescript": {
+        "alwaysTryTypes": true,
+        "project": "./tsconfig.json"
+      },
+      "node": {
+        "extensions": [".js", ".jsx", ".ts", ".tsx"]
+      }
+    }
+  },
+  "rules": {
+    "max-lines": ["error", { "max": 300, "skipBlankLines": true, "skipComments": true }],
+    "max-lines-per-function": ["error", { "max": 60, "skipBlankLines": true, "skipComments": true }],
+    "complexity": ["error", 10],
+    "import/order": [
+      "error",
+      {
+        "groups": ["builtin", "external", "internal", "parent", "sibling", "index"],
+        "pathGroups": [
+          {
+            "pattern": "@app/**",
+            "group": "internal",
+            "position": "before"
+          },
+          {
+            "pattern": "@pages/**",
+            "group": "internal",
+            "position": "before"
+          },
+          {
+            "pattern": "@features/**",
+            "group": "internal",
+            "position": "before"
+          },
+          {
+            "pattern": "@shared/**",
+            "group": "internal",
+            "position": "before"
+          }
+        ],
+        "pathGroupsExcludedImportTypes": ["builtin"],
+        "newlines-between": "always",
+        "alphabetize": {
+          "order": "asc",
+          "caseInsensitive": true
+        }
+      }
+    ],
+    "no-restricted-imports": [
+      "error",
+      {
+        "paths": [
+          {
+            "name": "@pages",
+            "message": "pages 只能从 features / shared 引用，不能直接引用其他 pages"
+          }
+        ],
+        "patterns": [
+          {
+            "group": ["@features/*/components", "@features/*/hooks", "@features/*/store"],
+            "message": "features 不能直接引用其他 features 的内部实现，只能走公共入口"
+          }
+        ]
+      }
+    ]
+  },
+  "overrides": [
+    {
+      "files": ["src/pages/**/*.tsx", "src/pages/**/*.ts"],
+      "rules": {
+        "max-lines": ["error", { "max": 300, "skipBlankLines": true, "skipComments": true }]
+      }
+    },
+    {
+      "files": ["src/features/**/*.tsx", "src/features/**/*.ts", "src/shared/**/*.tsx", "src/shared/**/*.ts"],
+      "rules": {
+        "max-lines": ["error", { "max": 200, "skipBlankLines": true, "skipComments": true }]
+      }
+    }
+  ]
+}

package/.aodw/templates/tools-config/frontend/prettier.config.template.json

@@ -0,0 +1,10 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "arrowParens": "avoid",
+  "endOfLine": "lf"
+}

package/.aodw/templates/tools-config/frontend/tsconfig.paths.template.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@app/*": ["src/app/*"],
+      "@pages/*": ["src/pages/*"],
+      "@features/*": ["src/features/*"],
+      "@shared/*": ["src/shared/*"]
+    }
+  }
+}

package/.aodw/workflow-guide.md

@@ -0,0 +1,51 @@
+# AODW Workflow Guide (Level 2)
+
+本文件为 AODW 的核心流程指令层，用于在触发任务时快速加载。
+
+## 1. 核心流程（RT 生命周期）
+
+created → intakeing → decided → in-progress → reviewing → done
+
+关键动作：
+- **Intake**：澄清范围、风险、模块影响，记录到 `intake.md`
+- **Decision**：选择 Spec-Full / Spec-Lite，并记录到 `decision.md`
+- **Plan**：先写 plan，获批后进入实现
+
+## 2. Spec-Full vs Spec-Lite 决策
+
+使用 Spec-Full：
+- 跨模块影响
+- 数据模型 / schema 变更
+- 外部 API 合约变更
+- 高风险或高复杂度变更
+
+使用 Spec-Lite：
+- 局部改动
+- 单模块小修复
+- 无外部 API 合约变化
+
+## 3. Gate 检查点
+
+- Gate 1：Intake 澄清完成
+- Gate 2：分支确认（必须在 feature 分支）
+- Gate 3：Plan 确认（未批准不得实现）
+- Gate 4：提交前确认（展示 diff 与 status）
+- Gate 5：完成确认（文档与测试齐备）
+
+## 4. 加载策略（渐进式披露）
+
+优先读取：
+1. `.aodw/manifest.yaml`（规则索引）
+2. 本文件（流程指令）
+3. 必要规则文件（优先摘要 `*-summary.md`）
+
+摘要策略：
+- 先读 `*-summary.md`
+- 需要细节再读完整文件
+
+## 5. 关键文件入口
+
+- 规则索引：`.aodw/manifest.yaml`
+- RT 流程：`.aodw/02-workflow/rt-manager.md`
+- Spec-Full：`.aodw/02-workflow/spec-full-profile.md`
+- Spec-Lite：`.aodw/02-workflow/spec-lite-profile.md`

package/AODW_Adapters/README.md

@@ -0,0 +1,143 @@
+# AODW Tool Adapters
+
+此目录包含不同 AI 工具的配置模板，用于将 AODW 规范桥接到具体的开发工具。
+
+## 📦 支持的工具
+
+### `cursor/`
+**Cursor IDE 适配器**
+- `.cursor/` - Cursor 配置目录
+- 包含规则文件、命令定义等
+
+### `gemini/`
+**Google Gemini 适配器**
+- `.agent/` - Gemini Agent 配置
+- `GEMINI.md` - Gemini 专用提示词
+
+### `claude/`
+**Anthropic Claude 适配器**
+- `CLAUDE.md` - Claude 专用提示词
+
+### `general/`
+**通用适配器**
+- `AGENTS.md` - 所有工具通用的说明文档
+- 不依赖特定工具的配置
+
+## 🚀 使用方法
+
+### 作为用户
+
+用户**不应该**直接使用此目录，而是通过 CLI 工具自动安装：
+
+```bash
+npx create-aodw init
+```
+
+CLI 会根据选择自动将对应的适配器文件复制到项目根目录。
+
+### 作为开发者
+
+#### 添加新工具适配器
+
+1. **创建新目录**：
+   ```bash
+   mkdir AODW_Adapters/vscode
+   ```
+
+2. **添加配置文件**：
+   - 工具特定的配置
+   - 提示词文件
+   - 规则定义
+
+3. **更新 CLI**：
+   编辑 `cli/bin/aodw.js`，在选项列表中添加新工具：
+   ```javascript
+   choices: [
+     { name: 'All (Install all adapters)', value: 'all' },
+     { name: 'Cursor', value: 'cursor', checked: true },
+     { name: 'Google Gemini', value: 'gemini' },
+     { name: 'Anthropic Claude', value: 'claude' },
+     { name: 'VS Code', value: 'vscode' }  // 新增
+   ]
+   ```
+
+4. **更新逻辑**：
+   确保 `toolsToInstall` 逻辑包含新工具：
+   ```javascript
+   const toolsToInstall = tools.includes('all') 
+     ? ['cursor', 'gemini', 'claude', 'vscode']  // 新增
+     : tools;
+   ```
+
+5. **发布新版本**：
+   ```bash
+   cd cli
+   ./publish.sh minor  # 新功能使用 minor
+   ```
+
+#### 更新现有适配器
+
+1. 修改对应目录下的文件
+2. 运行 `cli/publish.sh patch` 发布补丁版本
+3. 用户运行 `npx create-aodw update` 即可获得更新
+
+## 🏗️ 设计原则
+
+### "薄适配器"原则
+
+适配器应该**尽量轻量**：
+
+❌ **错误做法** - 在适配器中重复规范内容：
+```markdown
+<!-- GEMINI.md -->
+# AODW 规范
+## RT 管理
+RT-ID 格式为 RT-XXX...（大量重复 .aodw 中的内容）
+```
+
+✅ **正确做法** - 引导 AI 阅读核心规范：
+```markdown
+<!-- GEMINI.md -->
+你正在一个 AODW 项目中工作。
+请优先阅读 `.aodw/01-core/aodw-constitution.md` 了解核心规范。
+当处理 RT 时，参考 `.aodw/02-workflow/rt-manager.md`。
+```
+
+### 职责边界
+
+- **适配器的职责**：将工具特定的接口映射到 AODW 规范
+- **核心规范的职责**：定义"什么是 AODW"
+
+## 📝 目录结构
+
+```
+AODW_Adapters/
+├── README.md           # 本文件
+├── cursor/
+│   ├── .cursor/
+│   │   ├── aodw_all.mdc
+│   │   ├── rules/
+│   │   └── commands/
+│   └── CLAUDE_lite.md
+├── gemini/
+│   ├── .agent/
+│   │   └── rules/
+│   └── GEMINI.md
+├── claude/
+│   └── CLAUDE.md
+└── general/
+    └── AGENTS.md
+```
+
+## 🔄 版本同步
+
+适配器版本与 AODW 核心规范保持同步：
+- 当 `.aodw` 更新时，适配器也应相应调整
+- CLI 的 `update` 命令会同时更新核心和适配器
+
+## 🤝 贡献
+
+欢迎为新工具贡献适配器！请确保：
+1. 遵循"薄适配器"原则
+2. 测试适配器在目标工具中的效果
+3. 提供清晰的使用说明

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-check.md

@@ -0,0 +1,7 @@
+---
+trigger: model_decision
+---
+# RT 一致性检查
+
+当用户想要 **检查 RT 状态**、**验证一致性** 或 **运行检查** 时，请**不要**直接尝试操作。
+你**必须**运行工作流 `/aodw-check`。

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-done.md

@@ -0,0 +1,7 @@
+---
+trigger: model_decision
+---
+# 完成 RT
+
+当用户想要 **完成 RT**、**关闭任务** 或 **标记为 Done** 时，请**不要**直接尝试操作。
+你**必须**运行工作流 `/aodw-done`。

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-full.md

@@ -0,0 +1,7 @@
+---
+trigger: model_decision
+---
+# 切换到 Spec-Full
+
+当用户想要 **切换到 Spec-Full 模式** 或 **启用完整规范** 时，请**不要**直接尝试操作。
+你**必须**运行工作流 `/aodw-full`。

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-governance.md

@@ -0,0 +1,7 @@
+---
+trigger: model_decision
+---
+# AODW 治理检查
+
+当用户想要 **检查治理状态** 或 **运行治理流程** 时，请**不要**直接尝试操作。
+你**必须**运行工作流 `/aodw-governance`。

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-impact.md

@@ -0,0 +1,7 @@
+---
+trigger: model_decision
+---
+# 更新影响分析
+
+当用户想要 **更新影响分析** 或 **分析改动影响** 时，请**不要**直接尝试操作。
+你**必须**运行工作流 `/aodw-impact`。

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-init.md

@@ -0,0 +1,7 @@
+---
+trigger: model_decision
+---
+# 初始化 AODW
+
+当用户想要 **初始化 AODW** 或 **设置新项目** 时，请**不要**直接尝试操作。
+你**必须**运行工作流 `/aodw-init`。

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-invariants.md

@@ -0,0 +1,7 @@
+---
+trigger: model_decision
+---
+# 检查不变量
+
+当用户想要 **检查不变量** 或 **验证系统约束** 时，请**不要**直接尝试操作。
+你**必须**运行工作流 `/aodw-invariants`。

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-lite.md

@@ -0,0 +1,7 @@
+---
+trigger: model_decision
+---
+# 切换到 Spec-Lite
+
+当用户想要 **切换到 Spec-Lite 模式** 或 **启用轻量规范** 时，请**不要**直接尝试操作。
+你**必须**运行工作流 `/aodw-lite`。

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-module.md

@@ -0,0 +1,7 @@
+---
+trigger: model_decision
+---
+# 更新模块文档
+
+当用户想要 **更新模块文档** 或 **创建新模块** 时，请**不要**直接尝试操作。
+你**必须**运行工作流 `/aodw-module`。

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-new.md

@@ -0,0 +1,7 @@
+---
+trigger: model_decision
+---
+# 创建新 RT
+
+当用户想要 **创建新 RT**、**开始新任务** 或 **启动 AODW 流程** 时，请**不要**直接尝试操作。
+你**必须**运行工作流 `/aodw-new`。

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-open.md

@@ -0,0 +1,7 @@
+---
+trigger: model_decision
+---
+# 打开 RT
+
+当用户想要 **打开某个 RT** 或 **查看任务详情** 时，请**不要**直接尝试操作。
+你**必须**运行工作流 `/aodw-open`。

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-pause.md

@@ -0,0 +1,7 @@
+---
+trigger: model_decision
+---
+# 暂停 AODW
+
+当用户想要 **暂停 AODW** 或 **进入普通模式** 时，请**不要**直接尝试操作。
+你**必须**运行工作流 `/aodw-pause`。

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-resume.md

@@ -0,0 +1,7 @@
+---
+trigger: model_decision
+---
+# 恢复 AODW
+
+当用户想要 **恢复 AODW** 或 **重新进入工作流** 时，请**不要**直接尝试操作。
+你**必须**运行工作流 `/aodw-resume`。

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-tests.md

@@ -0,0 +1,7 @@
+---
+trigger: model_decision
+---
+# 生成测试计划
+
+当用户想要 **生成测试计划** 或 **更新测试文档** 时，请**不要**直接尝试操作。
+你**必须**运行工作流 `/aodw-tests`。

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/antigravity/.agent/rules/aodw-upgrade.md

@@ -0,0 +1,7 @@
+---
+trigger: model_decision
+---
+# 升级到 Spec-Full
+
+当用户想要 **升级当前 RT** 或 **从 Lite 转为 Full** 时，请**不要**直接尝试操作。
+你**必须**运行工作流 `/aodw-upgrade`。