aodw-skill 0.7.3

package/docs/migration-guide-0.2.0.md

@@ -0,0 +1,250 @@
+# AODW 适配器重构 - 迁移指南
+
+**版本**: 0.1.x → 0.2.0  
+**发布日期**: 2025-12-06
+
+---
+
+## 概述
+
+AODW 0.2.0 版本对 Antigravity 平台的适配器规则进行了重构，简化了命令结构，提升了可用性。
+
+### 主要变更
+
+- ✅ 规则数量从 16 个精简为 11 个（用户可见 9 个）
+- ✅ 按 RT 生命周期阶段重新组织命令
+- ✅ 排除维护者专用命令（不会分发到用户项目）
+- ✅ 符合"薄适配器"设计原则
+
+---
+
+## 命令对照表
+
+### 旧版本 → 新版本 (v0.2.0)
+
+| 旧命令                                        | 新命令            | 变化说明                      |
+| --------------------------------------------- | ----------------- | ----------------------------- |
+| `/aodw-new`                                   | `/aodw-intake`    | 重命名，更符合立项流程语义    |
+| `/aodw-lite` + `/aodw-full` + `/aodw-upgrade` | `/aodw-decide`    | **合并**为一个决策命令        |
+| `/aodw-impact` + `/aodw-invariants`           | `/aodw-analyze`   | **合并**为分析阶段命令        |
+| `/aodw-tests` + `/aodw-module`                | `/aodw-implement` | **合并**为实现阶段命令        |
+| `/aodw-check`                                 | `/aodw-verify`    | 重命名，更清晰                |
+| `/aodw-done`                                  | `/aodw-complete`  | 重命名，更清晰                |
+| `/aodw-pause` + `/aodw-resume`                | `/aodw-control`   | **合并**为流程控制命令        |
+| `/aodw-open`                                  | `/aodw-open`      | **保持不变**                  |
+| `/aodw`                                       | `/aodw`           | **保持不变**（Kernel Loader） |
+
+### 移除的命令（仅维护者可见）
+
+| 命令               | 说明          | 影响                                          |
+| ------------------ | ------------- | --------------------------------------------- |
+| `/aodw-governance` | AODW 治理检查 | 不再分发给用户，仅在 AODW 仓库中使用          |
+| `/aodw-init`       | 初始化 AODW   | CLI (`npx create-aodw init`) 已处理，无需手动 |
+
+---
+
+## 迁移步骤
+
+### 对于新用户
+
+无需任何操作，直接使用新版本即可：
+
+```bash
+npx create-aodw init
+```
+
+### 对于现有用户
+
+#### 选项 1：更新到最新版本
+
+```bash
+# 更新 AODW（会覆盖现有 .agent/rules 和 .agent/workflows）
+npx create-aodw init
+```
+
+**注意**：如果你自定义了规则文件，请先备份。
+
+#### 选项 2：继续使用旧版本
+
+如果你已经习惯了旧命令，可以继续使用 v3.1.0：
+
+```bash
+# 不运行 init 命令，保持现有配置
+```
+
+但建议尽快迁移到新版本，以获得更好的体验。
+
+---
+
+## 新命令使用指南
+
+### 1. `/aodw-intake` - 创建新 RT
+
+**用途**: 替代原 `/aodw-new`
+
+**使用场景**:
+- 创建新功能
+- 修复 Bug
+- 性能优化
+- 代码重构
+
+**示例**:
+```
+你: "创建一个新RT，我想添加用户登录功能"
+AI: (自动运行 /aodw-intake)
+```
+
+### 2. `/aodw-decide` - 选择开发模式
+
+**用途**: 替代原 `/aodw-lite`, `/aodw-full`, `/aodw-upgrade`
+
+**使用场景**:
+- 选择 Spec-Full 或 Spec-Lite
+- 从 Spec-Lite 升级到 Spec-Full
+
+**示例**:
+```
+你: "这个改动比较复杂，用 Spec-Full"
+AI: (自动运行 /aodw-decide，选择 Spec-Full)
+```
+
+### 3. `/aodw-analyze` - 分析阶段
+
+**用途**: 替代原 `/aodw-impact`, `/aodw-invariants`
+
+**使用场景**:
+- 分析影响范围
+- 确定不变量
+
+**示例**:
+```
+你: "分析一下这个改动的影响"
+AI: (自动运行 /aodw-analyze，更新 impact.md 和 invariants.md)
+```
+
+### 4. `/aodw-implement` - 实现阶段
+
+**用途**: 替代原 `/aodw-tests`, `/aodw-module`
+
+**使用场景**:
+- 更新测试计划
+- 更新模块文档
+
+**示例**:
+```
+你: "代码写完了，更新一下测试和文档"
+AI: (自动运行 /aodw-implement)
+```
+
+### 5. `/aodw-verify` - 验证阶段
+
+**用途**: 替代原 `/aodw-check`
+
+**使用场景**:
+- 检查 RT 一致性
+- 验证文档与代码匹配
+
+**示例**:
+```
+你: "检查一下文档和代码是否一致"
+AI: (自动运行 /aodw-verify)
+```
+
+### 6. `/aodw-complete` - 完成 RT
+
+**用途**: 替代原 `/aodw-done`
+
+**使用场景**:
+- 合并代码
+- 完成 RT
+- 知识蒸馏
+
+**示例**:
+```
+你: "完成这个 RT"
+AI: (自动运行 /aodw-complete，合并分支)
+```
+
+### 7. `/aodw-control` - 流程控制
+
+**用途**: 替代原 `/aodw-pause`, `/aodw-resume`
+
+**使用场景**:
+- 暂停 AODW 流程
+- 恢复 AODW 流程
+
+**示例**:
+```
+你: "暂停一下 AODW"
+AI: (自动运行 /aodw-control，暂停流程)
+
+你: "继续 AODW"
+AI: (自动运行 /aodw-control，恢复流程)
+```
+
+---
+
+## 常见问题 (FAQ)
+
+### Q1: 为什么要合并命令？
+
+**A**: 为了减少认知负担。原有 16 个命令过多，新版按 RT 生命周期阶段组织为 9 个，更易理解和使用。
+
+### Q2: 旧命令还能用吗？
+
+**A**: 旧命令已被移除。但新命令功能完全覆盖旧命令，只是名称和组织方式变化。
+
+### Q3: 我自定义了规则，升级会覆盖吗？
+
+**A**: 是的。如果你自定义了 `.agent/rules/` 下的文件，升级前请备份。
+
+### Q4: 新版本有什么好处？
+
+**A**: 
+- ✅ 命令更少，更易记
+- ✅ 符合 RT 工作流，更直观
+- ✅ 遵循薄适配器原则，更简洁
+- ✅ 排除维护者命令，更专注
+
+### Q5: 如何回退到旧版本？
+
+**A**: 
+```bash
+# 删除当前配置
+rm -rf .agent
+
+# 从备份恢复（如果有）
+cp -r .agent.backup .agent
+```
+
+---
+
+## 技术细节
+
+### 薄适配器原则
+
+新版本严格遵循"薄适配器"设计原则：
+- 规则文件简洁（平均 367 字节）
+- 不重复核心规范内容
+- 通过引用指向详细文档
+
+### 三层架构
+
+```
+Layer 1 (.aodw/)          → 详细规则说明
+Layer 2 (.agent/rules/)   → 简洁触发器
+Layer 3 (global_workflows/) → 具体操作步骤
+```
+
+每层职责清晰，避免重复。
+
+---
+
+## 获取帮助
+
+如有问题，请查看：
+- AODW 文档: `.aodw/README.md`
+- 实施计划: `docs/aodw-adapter-refactoring-plan.md`
+- 架构分析: `docs/aodw-rules-structure-analysis.md`
+
+或联系 AODW 维护者。

package/docs/platform-matrix.md

@@ -0,0 +1,83 @@
+# AODW 平台适配矩阵 (Platform Support Matrix)
+
+本文档详细定义了 AODW 在各个 AI 开发平台上的适配规范，是 CLI 实现的**唯一真理来源 (Single Source of Truth)**。
+重点明确了 **Frontmatter 配置**，以确保规则在各种环境下都能被稳定触发和执行。
+
+## 1. 核心概念
+
+*   **Scope (范围)**:
+    *   **Project**: 仅对当前项目生效。
+    *   **Global**: 对当前用户的所有项目生效。
+*   **Capability (能力)**:
+    *   **Rules**: 被动上下文规则 (System Prompt / Context)。
+    *   **Commands**: 主动触发的工作流 (Slash Commands)。
+
+---
+
+## 2. Antigravity (Google)
+
+Antigravity 依赖 **Intent Classification** (意图识别) 来动态加载规则。
+
+| Scope                | Capability   | Path                         | Frontmatter Specification (必须严格遵守)                                                                                           |
+| :------------------- | :----------- | :--------------------------- | :--------------------------------------------------------------------------------------------------------------------------------- |
+| **Project & Global** | **Rules**    | `.agent/rules/aodw-*.md`     | ```yaml<br>---<br>trigger: model_decision<br>---<br>```<br>**说明**: `model_decision` 允许模型根据用户输入自动判断是否加载此规则。 |
+| **Project & Global** | **Commands** | `.agent/workflows/aodw-*.md` | ```yaml<br>---<br>description: [简短描述]<br>---<br>```<br>**说明**: `description` 用于帮助用户和模型理解此工作流的功能。          |
+
+---
+
+## 3. Cursor (Anysphere)
+
+Cursor 依赖 `.mdc` 文件中的 `globs` 和 `alwaysApply` 字段来决定规则的生效范围。
+
+| Scope                | Capability   | Path                     | Frontmatter Specification (必须严格遵守)                                                                                                                                                                                                            |
+| :------------------- | :----------- | :----------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Project & Global** | **Rules**    | `.cursor/rules/aodw.mdc` | ```yaml<br>---<br>description: AODW Core Framework<br>globs: *<br>alwaysApply: true<br>---<br>```<br>**说明**: <br>1. `globs: *`: AODW 是底层框架，必须匹配所有文件。<br>2. `alwaysApply: true`: 必须始终激活，防止 AI 在未加载规则时生成违规代码。 |
+| **Project & Global** | **Commands** | `.cursor/commands/*.md`  | *Standard Markdown (No Frontmatter required)*<br>**说明**: Cursor 自动识别 `.cursor/commands/` 下的所有 `.md` 文件为 Slash Commands。                                                                                                               |
+
+---
+
+## 4. Claude (Anthropic)
+
+Claude Code 主要依赖文件路径和内容结构，对 Frontmatter 依赖较少。
+
+| Scope                | Capability   | Path                    | Frontmatter Specification                                                                           |
+| :------------------- | :----------- | :---------------------- | :-------------------------------------------------------------------------------------------------- |
+| **Project & Global** | **Rules**    | `CLAUDE.md`             | *Standard Markdown*<br>**说明**: 文件内容必须包含明确的章节结构 (如 `# AODW Rules`, `# Commands`)。 |
+| **Project & Global** | **Commands** | `.claude/commands/*.md` | *Standard Markdown*<br>**说明**: 文件名即命令名。支持 `$ARGUMENTS` 占位符。                         |
+
+---
+
+## 5. GitHub Copilot (Microsoft)
+
+Copilot 对 Prompt 文件有严格的元数据要求，否则可能无法正确执行或使用错误的模型。
+
+| Scope       | Capability         | Path                              | Frontmatter Specification (必须严格遵守)                                                                                                                                                                                   |
+| :---------- | :----------------- | :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Project** | **Rules**          | `.github/copilot-instructions.md` | *Standard Markdown*<br>**说明**: 作为 System Prompt 注入，无特殊 Frontmatter。                                                                                                                                             |
+| **Project** | **Commands**       | `.github/prompts/*.prompt.md`     | ```yaml<br>---<br>model: gpt-4o<br>mode: chat<br>description: [简短描述]<br>---<br>```<br>**说明**: <br>1. `model: gpt-4o`: 强制使用高智商模型，确保复杂工作流 (Spec/Plan) 的执行质量。<br>2. `mode: chat`: 指定交互模式。 |
+| **Global**  | **Rules/Commands** | *Manual Config*                   | *N/A (CLI 暂不自动处理)*                                                                                                                                                                                                   |
+
+---
+
+## 6. CLI 实现检查清单
+
+CLI 的 `FileProcessor` 必须在写入文件前执行以下 **Frontmatter 注入/校验逻辑**：
+
+1.  **Cursor Processor**:
+    *   目标文件: `*.mdc`
+    *   检查: 是否存在 `alwaysApply: true` 和 `globs: *`。
+    *   动作: 如果缺失或值为 `false`，强制覆盖为 `true` 和 `*`。
+
+2.  **Antigravity Processor**:
+    *   目标文件: `.agent/rules/*.md`
+    *   检查: 是否存在 `trigger: model_decision`。
+    *   动作: 如果缺失，强制注入。
+
+3.  **Copilot Processor**:
+    *   目标文件: `.github/prompts/*.prompt.md`
+    *   检查: 是否存在 `model` 和 `mode`。
+    *   动作: 强制注入 `model: gpt-4o` 和 `mode: chat`。
+
+4.  **Common**:
+    *   确保所有生成的 Markdown 文件都是 UTF-8 编码。
+    *   确保目录结构存在 (`mkdir -p`)。

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "aodw-skill",
+  "version": "0.7.3",
+  "description": "Next-channel CLI tool to scaffold AODW in your project",
+  "main": "bin/aodw.js",
+  "files": [
+    "bin/",
+    ".aodw/",
+    "AODW_Adapters/",
+    "docs/"
+  ],
+  "bin": {
+    "aodw-skill": "./bin/aodw.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "aodw",
+    "ai",
+    "workflow",
+    "scaffold",
+    "next"
+  ],
+  "author": "AODW Team",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^9.0.0",
+    "fs-extra": "^10.0.0",
+    "inquirer": "^8.2.0",
+    "js-yaml": "^4.1.1",
+    "latest-version": "^9.0.0",
+    "node-fetch": "^3.3.2"
+  }
+}