aodw-skill 0.7.3

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/deploy/rollback_prod.sh

@@ -0,0 +1,99 @@
+#!/usr/bin/env bash
+# 回滚生产分支到某个已发布的生产标签（默认回滚到上一枚 prod-* 标签）
+# 依赖：git、jq；使用同目录/项目根的 project-config.json
+set -euo pipefail
+
+CONFIG_FILE="${CONFIG_FILE:-project-config.json}"
+
+need() { command -v "$1" >/dev/null 2>&1 || { echo "❌ 缺少依赖：$1"; exit 1; }; }
+need git
+need jq
+
+# 读取配置
+[ -f "$CONFIG_FILE" ] || { echo "❌ 缺少 $CONFIG_FILE，请先运行 promote_only.sh 初始化"; exit 1; }
+REMOTE_NAME=$(jq -r '.remote_name' "$CONFIG_FILE")
+REMOTE_RELEASE=$(jq -r '.remote_release' "$CONFIG_FILE")
+PROD_TAG_PREFIX=$(jq -r '.prod_tag_prefix' "$CONFIG_FILE")
+
+# 参数解析（可选）：
+#   --to-tag <tag>      指定要回滚到的标签
+#   --dry-run           只显示将要执行的动作，不真正推送
+TO_TAG=""
+DRY_RUN=0
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --to-tag)
+      TO_TAG="${2:-}"; shift 2;;
+    --dry-run)
+      DRY_RUN=1; shift;;
+    *)
+      echo "未知参数: $1"; exit 1;;
+  esac
+done
+
+echo "🔁 准备回滚生产分支（${REMOTE_NAME}/${REMOTE_RELEASE}），标签前缀: ${PROD_TAG_PREFIX}"
+
+# 拉取远端最新
+git fetch "$REMOTE_NAME" --prune --tags
+
+# 获取所有 prod 标签（按字典序/时间戳命名会自然有序）
+readarray -t PROD_TAGS < <(git tag -l "${PROD_TAG_PREFIX}*" | sort)
+
+if [[ -z "$TO_TAG" ]]; then
+  # 自动选择“上一枚”生产标签（倒数第二个）
+  CNT=${#PROD_TAGS[@]}
+  if (( CNT < 2 )); then
+    echo "❌ 生产标签少于 2 个，无法自动回滚（至少需要一个当前标签和一个上一个标签）"
+    exit 1
+  fi
+  CURRENT="${PROD_TAGS[$((CNT-1))]}"
+  TARGET="${PROD_TAGS[$((CNT-2))]}"
+else
+  TARGET="$TO_TAG"
+  # 当前最新标签用于展示
+  if ((${#PROD_TAGS[@]} > 0)); then
+    CURRENT="${PROD_TAGS[-1]}"
+  else
+    CURRENT="<未知>"
+  fi
+  # 校验目标标签存在
+  if ! git rev-parse -q --verify "refs/tags/$TARGET" >/dev/null; then
+    echo "❌ 指定的标签不存在: $TARGET"
+    exit 1
+  fi
+fi
+
+echo "🧭 当前最新生产标签: $CURRENT"
+echo "🎯 目标回滚到的标签: $TARGET"
+
+# 解析目标提交
+TARGET_COMMIT="$(git rev-list -n 1 "$TARGET")"
+[ -n "$TARGET_COMMIT" ] || { echo "❌ 无法解析目标标签提交: $TARGET"; exit 1; }
+
+echo "📌 目标提交: $TARGET_COMMIT"
+
+# 预览动作
+echo "📝 将把远端分支 ${REMOTE_NAME}/${REMOTE_RELEASE} 指向 ${TARGET}（强制推送）"
+if [[ "$DRY_RUN" -eq 1 ]]; then
+  echo "🔎 DRY-RUN: 不会真正推送。"
+  exit 0
+fi
+
+# 强制把 release 指向目标标签对应的提交
+git push "$REMOTE_NAME" "$TARGET:refs/heads/$REMOTE_RELEASE" --force
+
+# 生成一次回滚标记标签（可选但建议保留审计）
+ROLLBACK_TAG="rollback-$(date +%Y%m%d-%H%M)-${TARGET}"
+if git rev-parse -q --verify "refs/tags/$ROLLBACK_TAG" >/dev/null; then
+  # 极少数情况下重名，则附加随机后缀
+  ROLLBACK_TAG="${ROLLBACK_TAG}-$(openssl rand -hex 2 2>/dev/null || echo rnd)"
+fi
+
+git tag -a "$ROLLBACK_TAG" -m "Rollback ${REMOTE_RELEASE} to ${TARGET}
+From: ${CURRENT}
+To:   ${TARGET}
+At:   $(date +'%F %T')"
+git push "$REMOTE_NAME" "$ROLLBACK_TAG" || echo "⚠️ 回滚标记标签推送失败（非致命）"
+
+echo "✅ 回滚完成：${REMOTE_NAME}/${REMOTE_RELEASE} → ${TARGET}"
+echo "ℹ️ 审计标签：$ROLLBACK_TAG"

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/rules/aodw.mdc

@@ -0,0 +1,26 @@
+---
+description: AI 编排开发工作流 (AODW) — Kernel Loader
+tags:
+  - aodw
+  - kernel
+globs: "*"
+alwaysApply: true
+---
+
+# AODW Kernel Loader (Cursor Adapter)
+# 版本: 3.1.0 (Reference Mode)
+
+你是一个 **AODW (AI 编排开发工作流) 协作 Agent**。
+
+## 1. 核心指令 (The Prime Directive)
+你 **必须** 在开始任何任务前，优先读取并遵循以下 **Kernel (宪章)** 文件：
+
+- `@.aodw/aodw-constitution.md`
+
+**注意**：
+- 该文件是你行为的最高准则。
+- 该文件包含了所有阶段的 **Context Loading Directives (上下文加载指令)**。
+- 你必须根据宪章的指示，在不同阶段（Intake/Manager/Coding/Knowledge）按需加载其他规则文件。
+
+## 2. 兜底机制
+如果你无法读取 `.aodw/aodw-constitution.md`，请立即停止并要求用户提供该文件。

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

@@ -0,0 +1,29 @@
+# RT 一致性检查
+
+检查 RT 文档的一致性和完整性，确保所有文档匹配且符合规范。
+
+## 功能
+- 验证 meta.yaml 正确性
+- 检查 index.yaml 同步状态
+- 验证模块 README 匹配实现
+- 检查不变量是否被违反
+- 验证 RT 文档完整性
+- 检查 tests.md 是否包含验证步骤
+- 验证治理要求
+
+## 检查项
+- [ ] meta.yaml 已更新
+- [ ] RT/index.yaml 已更新
+- [ ] spec/spec-lite 已完成
+- [ ] plan/plan-lite 已完成
+- [ ] invariants.md 已验证
+- [ ] impact.md 已验证
+- [ ] tests.md 已完成
+- [ ] 模块 README 已更新
+- [ ] 治理规则已满足
+
+## 使用场景
+- RT 完成前的一致性验证
+- 定期检查 RT 文档状态
+- 修复文档不一致问题
+

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

@@ -0,0 +1,52 @@
+# 完成 RT
+
+将 RT 标记为完成，执行完成前的所有检查。
+
+## 功能
+- 执行完成检查清单
+- 验证所有文档完整性
+- 更新 RT 状态为完成
+- 更新 changelog.md
+- 确保所有不变量未被违反
+- 验证测试已通过
+
+## 完成检查清单
+- [ ] meta.yaml 已更新
+- [ ] RT/index.yaml 已更新
+- [ ] spec/spec-lite 已完成
+- [ ] plan/plan-lite 已完成
+- [ ] invariants.md 已验证
+- [ ] impact.md 已验证
+- [ ] tests.md 已完成
+- [ ] 模块 README 已更新
+- [ ] 治理规则已满足
+- [ ] 所有功能已实现
+- [ ] 所有测试已通过
+
+## Git 操作流程（完成 RT 后自动执行）
+
+当 RT 标记为完成后，自动执行以下 Git 操作：
+
+1. **保存功能分支的所有改动并提交**
+   - 检查功能分支是否有未提交的改动
+   - 如果有未提交的改动，自动提交（使用规范的提交信息格式，包含 `Refs: ${RT-ID}` trailer）
+   - 确保所有改动都已提交到功能分支
+
+2. **合并到本地 master 分支**
+   - 切换到本地 master 分支：`git checkout master`
+   - 拉取远程 master 最新代码：`git pull origin master`
+   - 合并功能分支到 master：`git merge ${feature-branch}`（使用 `--no-ff` 保留合并历史）
+   - 解决可能的合并冲突（如有）
+
+3. **删除本地功能分支**
+   - 删除本地功能分支：`git branch -d ${feature-branch}`
+   - 如果分支未完全合并，使用 `-D` 强制删除（需用户确认）
+
+4. **推送 master 分支到远程仓库**
+   - 推送本地 master 到远程：`git push origin master`
+   - 确保远程 master 分支已更新
+
+## 使用场景
+当 RT 的所有工作已完成，准备标记为完成时使用。
+
+**注意**：完成 RT 后会自动执行上述 Git 操作流程，确保代码已合并到 master 并推送到远程。

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

@@ -0,0 +1,30 @@
+# Spec-Full 模式
+
+将当前 RT 切换到 Spec-Full 模式，适用于复杂、跨模块的改动。
+
+## 功能
+- 切换到完整文档模式
+- 创建完整的 spec.md、plan.md、impact.md、invariants.md、tests.md
+- 深度影响分析
+- 先设计后编码
+- 全面测试定义
+
+## 使用场景
+- 跨模块调整
+- 数据模型更改
+- API 契约演进
+- 架构决策
+- 性能/并发/安全影响
+- 大规模重构
+
+## 必需文档
+- meta.yaml
+- intake.md
+- decision.md
+- spec.md
+- plan.md
+- impact.md
+- invariants.md
+- tests.md
+- changelog.md
+

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

@@ -0,0 +1,33 @@
+# AODW 治理检查
+
+检测 AODW 规则和流程中的问题，提议改进。
+
+## 功能
+- 检测规则不清楚的情况
+- 检测缺少文档模式
+- 检测重复的用户困惑
+- 检测规则执行中的冲突
+- 检测模块缺少 README 但被引用
+- 检测 RT 流程变得模糊
+- 提议创建 RT-CORE 来增强 AODW
+
+## 检测场景
+- 规则不清楚
+- 缺少文档模式
+- 重复的用户困惑
+- 规则在执行中引起冲突
+- 模块缺少 README 但被引用
+- RT 流程变得模糊
+
+## 提议流程
+当检测到治理问题时：
+1. 询问用户是否创建治理 RT
+2. 如果同意，创建 `RT/RT-XXX/`（使用统一的 RT-{seq} 格式，通过 `type` 和 `modules` 字段标识为治理相关）
+3. 遵循 Spec-Full 流程
+4. 更新治理版本（如应用更改）
+
+## 使用场景
+- 定期检查 AODW 流程健康度
+- 发现流程问题时提议改进
+- 更新 AODW 治理规则
+

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

@@ -0,0 +1,24 @@
+# 更新影响分析
+
+更新 RT 的 impact.md 文档，分析改动的影响范围。
+
+## 功能
+- 分析模块级影响
+- 分析行为影响
+- 分析数据模型影响
+- 分析 API 影响
+- 评估风险和回退计划
+- 更新 impact.md 文档
+
+## 影响分析维度
+1. **模块级影响**：哪些模块的行为变化，跨模块依赖
+2. **行为影响**：功能变化、副作用、回归风险、数据流变化
+3. **数据模型影响**：schema 更改、数据迁移要求、兼容性
+4. **API 影响**：签名更改、向后兼容性、客户端影响
+5. **运行时影响**：性能、并发、安全影响
+
+## 使用场景
+- Spec-Full RT 的必需步骤
+- 评估改动影响范围
+- 识别风险和回退策略
+

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

@@ -0,0 +1,75 @@
+# AODW 初始化命令
+
+## 场景说明
+
+你现在在一个启用 AODW 的新仓库，已有完整的目录结构：
+- `.aodw/`（含 `.aodw/aodw_governance/`）
+- `.cursor/`
+- `RT/index.yaml`
+
+## 执行步骤
+
+请按 AODW 规则完成启动准备，按以下步骤执行：
+
+### 1. 读取核心规则文档
+
+读取以下文档以了解 AODW 规则体系：
+- `.aodw/01-core/aodw-constitution.md`
+- `.aodw/03-standards/ai-coding-rules.md`
+- `.aodw/01-core/ai-knowledge-rules.md`
+- `.aodw/01-core/ai-interaction-rules.md`
+- `.aodw/01-core/module-doc-rules.md`
+- `.aodw/02-workflow/rt-manager.md`
+- `.cursor/aodw_all.mdc`
+
+### 2. 初始化模块索引和文档
+
+- 在 `.aodw/06-project/modules-index.yaml` 中填入现有模块
+- 为每个模块使用 `.aodw/templates/module-readme-template.md` 创建 README
+  - 存放位置：`docs/modules/<name>.md` 或团队约定路径
+  - 内容要求：写明职责/映射/不变量/历史
+
+### 3. 创建初始化 RT（需求追踪）
+
+**检查是否已初始化**：
+- 检查 `RT/RT-CORE-001/` 目录是否存在
+- 检查 `RT/index.yaml` 中是否已有 RT-CORE-001 条目
+- **如果已存在，跳过此步骤，不重复初始化**
+
+**如果未初始化，则执行以下操作**：
+- 创建 `RT/RT-CORE-001/`（Spec-Full 类型）
+- 复制 `.aodw/templates/rt-meta-template.yaml` 为 `meta.yaml`
+- 初始化以下文档文件：
+  - `intake.md`
+  - `decision.md`
+  - `spec.md`
+  - `plan.md`
+  - `impact.md`
+  - `invariants.md`
+  - `tests.md`
+  - `changelog.md`
+- 内容记录："启用 AODW" 的初始化决策
+
+### 4. 更新 RT 索引
+
+**检查是否已存在条目**：
+- 检查 `RT/index.yaml` 中是否已有 RT-CORE-001 条目
+- **如果已存在，跳过添加条目，仅更新 `last_updated_at` 字段**
+
+**如果不存在，则执行以下操作**：
+- 添加 RT-CORE-001 条目
+- 更新 `last_updated_at` 字段
+
+### 5. 生成状态汇总
+
+完成后给出状态汇总，包括：
+- 改动文件列表
+- 待补充信息（如模块职责细节）
+- 下一步建议
+
+## 交互规范
+
+- 严格遵守 `.aodw/01-core/ai-interaction-rules.md` 中的提问规范
+- 关键问题使用选项 + 推荐理由的形式
+- 保持中文输出
+- 路径使用反引号标记（如 `` `docs/modules/example.md` ``）

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

@@ -0,0 +1,28 @@
+# 检查不变量
+
+检查并验证 RT 不变量，确保实现不违反任何不变量规则。
+
+## 功能
+- 读取全局不变量（ai-knowledge-rules.md）
+- 读取模块不变量（模块 README）
+- 读取 RT 特定不变量（invariants.md）
+- 检查代码实现是否违反不变量
+- 警告潜在冲突
+- 建议解决方案
+
+## 不变量类型
+1. **全局不变量**：定义在 ai-knowledge-rules.md、aodw-constitution.md
+2. **模块不变量**：定义在模块 README、RT invariants.md
+3. **RT 特定不变量**：定义在 RT/RT-XXX/invariants.md
+
+## 执行层次
+严格性顺序：
+1. 全局不变量（最高优先级）
+2. 模块不变量
+3. RT 特定不变量
+
+## 使用场景
+- 编码前验证设计不违反不变量
+- 编码后检查实现是否违反不变量
+- 检测潜在冲突并警告用户
+

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

@@ -0,0 +1,22 @@
+# Spec-Lite 模式
+
+将当前 RT 切换到 Spec-Lite 模式，适用于局部化、小范围的改动。
+
+## 功能
+- 切换到轻量级文档模式
+- 使用 spec-lite.md 和 plan-lite.md
+- 简化测试文档（主要是手动检查）
+- 适用于单模块、不涉及数据模型/API 变更的改动
+
+## 使用场景
+- 局部化更改
+- UI 层微调
+- 内部实现优化
+- 单模块小 Bug/小优化
+
+## 约束
+- 不能修改数据模型
+- 不能跨模块行为变化
+- 不能改变外部 API 契约
+- 如果违反不变量，必须升级到 Spec-Full
+

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

@@ -0,0 +1,23 @@
+# 更新模块文档
+
+更新或创建模块文档，维护模块的职责、不变量和历史记录。
+
+## 功能
+- 读取或创建模块 README
+- 更新模块职责描述
+- 更新模块不变量
+- 更新 related_rts 列表
+- 更新 modules-index.yaml
+- 更新文件映射
+
+## 使用场景
+- 代码修改影响模块行为时
+- 创建新模块时
+- 模块边界改变时
+- 职责在模块间移动时
+
+## 必需操作
+1. 修改代码前：阅读相关模块 README 和不变量
+2. 代码修改后：更新模块 README 和 related_rts
+3. 创建新模块：创建 docs/modules/<module>.md 并注册到 modules-index.yaml
+

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

@@ -0,0 +1,92 @@
+---
+trigger: always_on
+---
+
+# 创建新 RT
+
+启动 AODW 工作流，创建新的 Runtime Task (RT)。
+
+## 功能
+- 自动检测需求类型（Feature/Bug/Enhancement/Refactor/Research）
+- 通过交互协议采集需求信息
+- 确定影响模块和风险级别
+- 选择 Profile（Spec-Lite 或 Spec-Full）
+- 生成 RT-ID 并创建 RT 目录结构和文档
+- 更新 RT/index.yaml
+
+## 使用场景
+当用户提出新功能、Bug 修复、性能优化、重构或研究任务时使用。
+
+## 操作步骤
+
+### 1. 生成 RT-ID
+
+**RT-ID 格式规则**：
+- 格式：`RT-{seq}`，其中 `{seq}` 为零填充数字（推荐至少 3 位，如 `RT-001`、`RT-002`）
+- RT-ID 全局唯一，所有 RT（包括 AODW 治理相关的 RT）都使用统一的 `RT-{seq}` 格式
+
+**生成步骤**：
+1. 读取 `RT/index.yaml`，找到所有现有 RT 的 ID（格式为 `RT-{seq}`）
+2. 提取所有序号
+3. 找到最大序号，新 RT 序号 = 最大序号 + 1
+4. 生成 RT-ID：`RT-{seq}`（如 `RT-001`、`RT-002`）
+
+**注意**：AODW 治理相关的 RT 也使用 `RT-{seq}` 格式，通过 `type` 字段（如 `type: Enhancement`）和 `modules` 字段（包含治理相关模块）来标识，而不是通过特殊的命名格式。
+
+**详细规则见**：`.aodw/id-branch-directory-rules.md` 和 `.aodw/02-workflow/rt-manager.md`
+
+### 2. 创建目录
+
+⚠️ **重要规则**：
+- 目录名必须严格遵循 `RT-{seq}` 格式
+- **禁止**在目录名中添加描述性文字（如 `RT-002-unidraft-mvp` 是错误的）
+- **禁止**使用 `RT-CORE-{seq}` 格式，所有 RT 统一使用 `RT-{seq}` 格式
+- 描述性信息应放在 `meta.yaml` 的 `title` 字段中，而不是目录名
+
+**操作步骤**：
+1. 创建目录：`RT/RT-{seq}/`（例如：`RT/RT-001/`）
+2. 确保目录名与 RT-ID 完全一致
+
+### 3. 创建文档
+
+按照 AODW 规范创建所有必需文档：
+
+**核心文档**（位于 RT 目录根目录）：
+- `meta.yaml`（必须填写 `id: RT-{seq}` 和 `title`，确保 `id` 与目录名一致）
+- `intake.md`
+- `decision.md`
+- `spec.md` 或 `spec-lite.md`（根据 Profile 选择）
+- `plan.md` 或 `plan-lite.md`（根据 Profile 选择）
+- `impact.md`
+- `invariants.md`
+- `tests.md`
+- `changelog.md`
+
+**过程文档目录**（可选，按需创建）：
+- 如果在执行过程中需要创建过程文档（如代码审查报告、验证报告、完成总结等），必须先创建 `RT/RT-XXX/docs/` 目录
+- 所有过程文档必须存放在 `RT/RT-XXX/docs/` 目录下，不能与核心文档混放在根目录
+- 过程文档命名使用小写字母和连字符（如 `code-review.md`、`time-command-verification.md`）
+- 过程文档类型包括但不限于：
+  - 代码审查报告
+  - 验证测试报告
+  - 完成总结报告
+  - 提交信息建议
+  - 状态跟踪文档
+  - 根因分析文档
+  - 改进方案文档
+  - 其他执行过程中的辅助文档
+- 详见 `.aodw/01-core/ai-knowledge-rules.md` 第 7 节"过程文档管理规则"
+
+### 4. 更新索引
+
+在 `RT/index.yaml` 中：
+1. 添加新 RT 条目（包含 id、title、type、profile、status 等）
+2. 更新 `last_updated_at` 字段（必须使用系统命令或 API 获取真实时间，见 `.aodw/02-workflow/rt-manager.md` 第 9 节）
+
+## 注意事项
+
+- **目录命名**：必须严格遵循 `RT-{seq}` 格式，不能添加任何描述性文字
+- **ID 一致性**：`meta.yaml` 中的 `id` 字段必须与目录名完全一致
+- **描述信息**：所有描述性信息（如功能名称）应放在 `meta.yaml` 的 `title` 字段中
+- **规则参考**：详细规则见 `.aodw/id-branch-directory-rules.md`
+

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

@@ -0,0 +1,18 @@
+# 打开 RT
+
+打开并查看指定的 Runtime Task (RT)，继续其工作流。
+
+## 功能
+- 读取 RT 的 meta.yaml 和文档
+- 显示 RT 当前状态和进度
+- 继续未完成的工作流步骤
+- 更新 RT 文档
+
+## 使用场景
+- 继续之前创建的 RT 工作
+- 查看 RT 的详细信息和状态
+- 更新 RT 文档或状态
+
+## 参数
+RT ID（例如：RT-001）
+

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

@@ -0,0 +1,18 @@
+# 暂停 AODW
+
+暂停 AODW 工作流，切换到普通模式。
+
+## 功能
+- 暂停 AODW 运行时模式
+- 切换到普通代码助手模式
+- 不创建 RT，不强制文档化
+- 记住待处理的 RT 工作流状态
+
+## 使用场景
+- 需要快速处理简单问题
+- 暂时不需要 AODW 流程
+- 处理与 RT 无关的任务
+
+## 恢复
+使用 `aodw-resume` 命令恢复 AODW 模式。
+

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

@@ -0,0 +1,19 @@
+# 恢复 AODW
+
+恢复 AODW 工作流，从暂停状态继续。
+
+## 功能
+- 恢复 AODW 运行时模式
+- 继续之前暂停的 RT 工作流
+- 恢复所有 AODW 规则和约束
+
+## 使用场景
+- 暂停后需要继续 AODW 流程
+- 恢复 RT 相关工作
+
+## 触发词
+- "继续 AODW"
+- "按 AODW 流程来"
+- "恢复 RT 流程"
+- "恢复流程"
+

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

@@ -0,0 +1,25 @@
+# 生成测试计划
+
+为 RT 生成或更新测试计划文档。
+
+## 功能
+- 生成测试用例矩阵
+- 定义输入用例和预期输出
+- 标注回归测试点
+- 添加异常/错误/边界场景测试
+- 提供性能/安全验证策略（如需要）
+- 更新 tests.md 文档
+
+## Spec-Lite 测试
+- 必需手动验证步骤
+- tests.md 包括：最小步骤、预期结果、失败情况
+
+## Spec-Full 测试
+- 必需自动化测试建议
+- tests.md 包括：测试矩阵、集成测试计划、回归测试列表、性能/安全检查
+
+## 使用场景
+- RT 创建时生成初始测试计划
+- 实现过程中更新测试用例
+- RT 完成前验证测试完整性
+

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

@@ -0,0 +1,26 @@
+# 升级到 Spec-Full
+
+将当前 RT 从 Spec-Lite 升级到 Spec-Full。
+
+## 功能
+- 检测是否需要升级的条件
+- 询问用户确认升级
+- 创建完整的 Full 文档
+- 更新 meta.yaml 中的 profile
+- 更新 RT/index.yaml
+
+## 升级条件
+当检测到以下任何情况时，必须升级：
+- 更改影响多个模块
+- 更改修改或引入不变量
+- 更改影响数据库 schema 或数据模型
+- 更改修改 API 契约
+- 存在性能、并发或安全影响
+- 用户明确要求更可靠的长期设计
+
+## 文档转换
+- spec-lite.md → spec.md
+- plan-lite.md → plan.md
+- 创建 impact.md、invariants.md（如果不存在）
+- 更新 tests.md 为完整测试矩阵
+