aodw-skill 0.7.3

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-new.md

@@ -0,0 +1,70 @@
+# 创建新 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：`RT-{seq}`，其中 `{seq}` 为零填充数字（推荐至少 3 位，如 `RT-001`、`RT-002`）
+- 特殊 RT（AODW 治理相关）：`RT-CORE-{seq}`（如 `RT-CORE-001`）
+
+**生成步骤**：
+1. 读取 `RT/index.yaml`，找到所有现有 RT 的 ID
+2. 提取所有序号（支持 `RT-001` 和 `RT-CORE-001` 格式）
+3. 找到最大序号，新 RT 序号 = 最大序号 + 1
+4. 生成 RT-ID：`RT-{seq}`（如 `RT-001`、`RT-002`）
+5. 如果是 AODW 治理相关，使用 `RT-CORE-{seq}` 格式
+
+**详细规则见**：`.aodw/id-branch-directory-rules.md` 和 `.aodw/rt-manager.md`
+
+### 2. 创建目录
+
+⚠️ **重要规则**：
+- 目录名必须严格遵循 `RT-{seq}` 或 `RT-CORE-{seq}` 格式
+- **禁止**在目录名中添加描述性文字（如 `RT-002-unidraft-mvp` 是错误的）
+- 描述性信息应放在 `meta.yaml` 的 `title` 字段中，而不是目录名
+
+**操作步骤**：
+1. 创建目录：`RT/RT-{seq}/`（例如：`RT/RT-001/`）
+2. 确保目录名与 RT-ID 完全一致
+
+### 3. 创建文档
+
+按照 AODW 规范创建所有必需文档：
+- `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`
+
+### 4. 更新索引
+
+在 `RT/index.yaml` 中：
+1. 添加新 RT 条目（包含 id、title、type、profile、status 等）
+2. 更新 `last_updated_at` 字段
+
+## 注意事项
+
+- **目录命名**：必须严格遵循 `RT-{seq}` 格式，不能添加任何描述性文字
+- **ID 一致性**：`meta.yaml` 中的 `id` 字段必须与目录名完全一致
+- **描述信息**：所有描述性信息（如功能名称）应放在 `meta.yaml` 的 `title` 字段中
+- **规则参考**：详细规则见 `.aodw/id-branch-directory-rules.md`
+
+

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-open.md

@@ -0,0 +1,19 @@
+# 打开 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/cursor/.cursor/commands/aodw-pause.md

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

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-resume.md

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

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-tests.md

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

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw-upgrade.md

@@ -0,0 +1,27 @@
+# 升级到 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 为完整测试矩阵
+
+

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/aodw.md

@@ -0,0 +1,69 @@
+# AODW 主命令
+
+AODW (AI-Orchestrated Development Workflow) 主入口，显示可用命令和快速帮助。
+
+## 可用命令
+
+### RT 管理
+- `aodw-new` - 创建新 RT
+- `aodw-open` - 打开 RT
+- `aodw-done` - 完成 RT
+- `aodw-check` - RT 一致性检查
+
+### Profile 管理
+- `aodw-lite` - 切换到 Spec-Lite 模式
+- `aodw-full` - 切换到 Spec-Full 模式
+- `aodw-upgrade` - 升级到 Spec-Full
+
+### 文档管理
+- `aodw-module` - 更新模块文档
+- `aodw-impact` - 更新影响分析
+- `aodw-invariants` - 检查不变量
+- `aodw-tests` - 生成测试计划
+
+### 流程控制
+- `aodw-pause` - 暂停 AODW
+- `aodw-resume` - 恢复 AODW
+
+### 治理
+- `aodw-governance` - AODW 治理检查
+
+## 快速开始
+
+1. **创建新 RT**：使用 `aodw-new` 创建新的 Runtime Task
+2. **选择 Profile**：根据改动范围选择 Spec-Lite 或 Spec-Full
+3. **完成工作**：实现功能并更新文档
+4. **检查一致性**：使用 `aodw-check` 验证完整性
+5. **标记完成**：使用 `aodw-done` 完成 RT
+
+## 模式说明
+
+### Spec-Lite
+适用于局部化、小范围的改动：
+- 单模块更改
+- 不涉及数据模型/API 变更
+- UI 层微调
+- 内部实现优化
+
+### Spec-Full
+适用于复杂、跨模块的改动：
+- 跨模块调整
+- 数据模型更改
+- API 契约演进
+- 架构决策
+- 性能/并发/安全影响
+
+## 文档结构
+
+每个 RT 包含：
+- `meta.yaml` - RT 元数据（权威来源）
+- `intake.md` - 需求采集
+- `decision.md` - 核心决策
+- `spec.md` / `spec-lite.md` - 行为规格
+- `plan.md` / `plan-lite.md` - 实施计划
+- `impact.md` - 影响分析
+- `invariants.md` - 不变量
+- `tests.md` - 测试计划
+- `changelog.md` - 变更记录
+
+

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/deploypromote.md

@@ -0,0 +1,20 @@
+# deploy/promote
+
+执行以下操作：
+
+1. 在项目根目录下运行自动发布脚本 `.cursor/deploy/promote_only.sh`；
+2. 该脚本会：
+   - 检查依赖（git/jq）；
+   - 若首次运行则引导生成 `project-config.json`；
+   - 自动获取测试分支最新通过版本；
+   - 将其合并到生产分支；
+   - 自动生成生产标签（prod-YYYYMMDD-HHMM-SHA）；
+   - 生成变更日志与可回滚标记；
+   - 发布完成后恢复到原开发分支。
+3. 不会推送本地新提交到测试环境，不影响正在开发的功能。
+
+请直接执行以下命令（无需再确认）：
+
+```bash
+bash .cursor/deploy/promote_only.sh
+```

package/AODW_Adapters/_backup/v3.1.0-pre-refactor/cursor/.cursor/commands/featuretotester.md

@@ -0,0 +1,32 @@
+# feature/to-tester
+
+执行以下操作：
+
+1. 在项目根目录下运行功能分支合并脚本 `.cursor/deploy/feature_to_master_push_test_local.sh`；
+2. 该脚本会：
+   - 检查依赖（git/jq）；
+   - 若首次运行则引导生成 `project-config.json`；
+   - 自动识别当前功能分支；
+   - 暂存当前未提交的修改（如有）；
+   - 更新本地主干分支（master/main）；
+   - 将当前功能分支合并到本地主干；
+   - 推送主干到测试环境（server/master）；
+   - 删除本地功能分支（可选，默认删除）；
+   - 恢复暂存的修改（如有）；
+3. 只处理当前所在的功能分支，不影响其他本地功能分支；
+4. **不会操作任何远端功能分支**。
+
+## ⚠️ 重要规则
+
+**功能分支管理原则**：
+- **功能分支只在本地存在，禁止推送到远程**
+- **禁止执行**：`git push origin feature/*` 或类似的推送操作
+- **功能分支的代码通过合并到测试分支（mac-version）后推送到远程**
+- **如果远程存在功能分支，应该删除它**（因为这是错误的操作导致的）
+
+请直接执行以下命令（无需再确认）：
+
+```bash
+bash .cursor/deploy/feature_to_master_push_test_local.sh
+```
+