aodw-skill 0.7.13 → 0.7.17

package/.aodw-next/01-core/ai-interaction-rules-summary.md

@@ -0,0 +1,37 @@
+# AI 交互规则摘要
+
+## 0. UI 任务判断（前置）
+
+涉及页面/界面/布局/组件/表单/Dashboard/交互体验 → 视为 UI 任务，进入 UI 专用流程（详见 `.aodw-next/02-workflow/ui-workflow-rules.md`）。
+
+## 1. 提问类型
+
+- **决策型**：必须提供选项 + 推荐 + 理由，支持 custom 回答
+- **信息型**：必须提供示例答案，限制 ≤10 词
+
+## 2. 格式规范
+
+```
+Q1. <问题>
+A. <选项1>  B. <选项2>  C. <选项3>
+Recommended: B（理由：……）
+请回复：A/B/C 或 custom:<答案>
+```
+
+## 3. 每轮限制
+
+- 单轮最多 5 个问题，建议 ≤3 个
+- 必须 Ask → Wait → Respond → Continue，不得连续提问
+
+## 4. 中断与暂停
+
+- 用户说"暂停" → 立即停止，切换普通模式
+- 用户说"继续 AODW" → 恢复流程
+
+## 5. 实现前门槛（四要素）
+
+编码前必须满足：假设已声明 / 歧义已处理 / 成功标准已定义 / 最小方案已确认。缺一不可。
+
+## 6. 分支验证
+
+任何代码修改前必须 `git branch --show-current`，在 main/master 上**立即停止**。

package/.aodw-next/01-core/ai-interaction-rules.md

@@ -22,7 +22,7 @@
 - **非 UI 相关任务**：按正常 AODW 流程执行
 - **UI 相关任务**：**必须进入 UI 专用流程**
 
-> **详细规则**：请参考 `.aodw/02-workflow/ui-workflow-rules.md`
+> **详细规则**：请参考 `.aodw-next/02-workflow/ui-workflow-rules.md`
 
 ---
 
@@ -104,7 +104,7 @@ AI 必须识别以下用户指令（支持多种表达方式）：
 | 触发类型 | 触发词示例 | 执行动作 |
 |---------|-----------|---------|
 | **UI 设计** | "请 AODW 规范，帮我就当前这个 RT 任务的界面进行设计"<br>"按 AODW 规范设计界面"<br>"设计 UI"<br>"生成界面原型" | 执行 UI 设计流程（规则文件读取 → UI 结构与设计说明 → 静态 HTML 原型生成 → 用户确认） |
-| **UI 审计/审查** | "请 AODW 规范，帮我就当前这个 RT 任务的界面进行审计"<br>"审计界面"<br>"审查 UI"<br>"检查界面" | 执行 UI Critic 审查流程（切换到 UI Critic 角色，按 `.aodw/03-standards/ui-kit/ui-kit.md` 第 4 节标准审查） |
+| **UI 审计/审查** | "请 AODW 规范，帮我就当前这个 RT 任务的界面进行审计"<br>"审计界面"<br>"审查 UI"<br>"检查界面" | 执行 UI Critic 审查流程（切换到 UI Critic 角色，按 `.aodw-next/03-standards/ui-kit/ui-kit.md` 第 4 节标准审查） |
 | **UI 挑毛病** | "请 AODW 规范，帮我就当前这个 RT 任务的界面挑毛病"<br>"挑 UI 毛病"<br>"找界面问题"<br>"UI 有什么问题" | 执行 UI Critic 审查流程（严格审查，指出所有问题） |
 
 ### 5.5.2 触发条件检查
@@ -114,7 +114,7 @@ AI 必须识别以下用户指令（支持多种表达方式）：
 1. **检查当前 RT 上下文**
    - 确认是否存在当前 RT（检查 `RT/RT-XXX/` 目录）
    - 如果不存在，提示用户："未找到当前 RT，请先创建或打开一个 RT"
-   - 如果存在，读取 `intake.md` 或 `spec.md` / `spec-lite.md` 了解任务内容
+   - 如果存在，读取 `intake.md` 或 `spec.md` / `rt-lite.md` 了解任务内容
 
 2. **检查是否为 UI 相关任务**
    - 如果 `intake.md` 中标注了 `ui_related: true`，直接进入 UI 流程
@@ -122,8 +122,8 @@ AI 必须识别以下用户指令（支持多种表达方式）：
    - 如果完全不涉及 UI，提示用户："当前 RT 不涉及 UI，是否仍要执行 UI 审查？"
 
 3. **执行对应的 UI 流程**
-   - **UI 设计**：按照 `.aodw/02-workflow/ui-workflow-rules.md` 第 2 节执行
-   - **UI 审计/审查/挑毛病**：按照 `.aodw/02-workflow/ui-workflow-rules.md` 第 3 节执行
+   - **UI 设计**：按照 `.aodw-next/02-workflow/ui-workflow-rules.md` 第 2 节执行
+   - **UI 审计/审查/挑毛病**：按照 `.aodw-next/02-workflow/ui-workflow-rules.md` 第 3 节执行
 
 ### 5.5.3 执行响应模板
 
@@ -134,7 +134,7 @@ AI 必须识别以下用户指令（支持多种表达方式）：
 - 当前 RT：[RT-XXX]
 - 触发类型：[设计 / 审计 / 挑毛病]
 - 执行动作：[具体要执行的内容]
-- 参考规范：[.aodw/03-standards/ui-kit/ui-kit.md]
+- 参考规范：[.aodw-next/03-standards/ui-kit/ui-kit.md]
 ```
 
 ### 5.5.4 执行优先级
@@ -164,6 +164,20 @@ AI 必须主动维护流程的透明度：
   - Plan 完成后，必须暂停并请求批准。
   - 代码提交前，必须暂停并请求确认。
 
+### 7.5 实现前澄清门槛（Clarification Gate）
+
+在进入代码实现前，AI 必须完成以下最小澄清，不满足则禁止开始编码：
+
+1. **假设已声明**：明确列出关键假设（输入/边界/依赖）。
+2. **歧义已处理**：若存在多种解释，必须列出选项与推荐理由。
+3. **成功标准已定义**：将任务转为可验证目标（测试、验收条件或回归路径）。
+4. **最小方案已确认**：说明为何当前改动是最小必要实现。
+
+**阻断规则**：
+- 缺少上述任一项，AI 必须先提问澄清，再推进实现；
+- 禁止“先实现再补问”；
+- 对琐碎任务可简化表达，但四类信息仍需覆盖。
+
 ⸻
 
 8. 门禁检查点与用户确认

package/.aodw-next/01-core/ai-knowledge-rules-summary.md

@@ -0,0 +1,25 @@
+# AI 知识规则摘要
+
+## 1. 文档分类
+
+- **Spec 文档**：spec.md / rt-lite.md（需求定义）
+- **Plan 文档**：plan.md / rt-lite.md §2（实现方案）
+- **过程文档**：impact.md / invariants.md / tests.md / changelog.md
+- **知识文档**：模块 README / modules-index.yaml
+
+## 2. Spec-Lite 的 rt-lite.md
+
+不再创建独立的 spec-lite.md 和 plan-lite.md，全部整合在 rt-lite.md 中。
+
+## 3. 文档同步原则
+
+- 代码改动后必须同步更新相关文档
+- 文档与代码不一致视为 Bug
+- RT 完成前必须执行知识蒸馏（更新模块文档和 modules-index.yaml）
+
+## 4. 知识蒸馏（RT 完成前提）
+
+合并前必须：
+1. 读取 modules-index.yaml 找到受影响模块
+2. 更新对应模块 README
+3. 确认文档反映最新代码状态

package/.aodw-next/01-core/ai-knowledge-rules.md

@@ -3,6 +3,8 @@ AI 必须确保文档始终与代码一致。
 
 本文件定义“何时更新哪些文档”，以及文档与代码之间的映射方式。
 
+> **Spec-Lite 单文件模式适配 (v1.1)**：本规则同时支持 Spec-Lite 的单文件 `rt-lite.md` 模式和 Spec-Full 的多文件模式。处理 Spec-Lite RT 时，请将 `rt-lite.md §N` 视为对应章节的文档来源。
+
 ---
 
 ## 1. 总原则
@@ -18,12 +20,12 @@ AI 必须确保文档始终与代码一致。
 
 ### 2.1 全局文档（Global）
 
-位于 `.aodw/` 或 `docs/` 下，用于整个系统：
+位于 `.aodw-next/` 或 `docs/` 下，用于整个系统：
 
-- `.aodw/01-core/aodw-constitution.md`  
-- `.aodw/06-project/ai-overview.md`  
-- `.aodw/03-standards/ai-coding-rules.md`  
-- `.aodw/01-core/ai-knowledge-rules.md`  
+- `.aodw-next/01-core/aodw-constitution.md`  
+- `.aodw-next/06-project/ai-overview.md`  
+- `.aodw-next/03-standards/ai-coding-rules.md`  
+- `.aodw-next/01-core/ai-knowledge-rules.md`  
 - 模块 README（如 `docs/modules/users.md`、`docs/modules/orders.md` 等）  
 - 数据与合约文档（如 `data-model.md`、`contracts/*.md` / `contracts/*.yaml`）
 
@@ -41,7 +43,7 @@ AI 必须确保文档始终与代码一致。
 
 每个 RT 都有自己的知识库目录，包括核心文档和过程文档。
 
-**目录结构**：详见 `.aodw/02-workflow/rt-manager.md` 第 2 节"目录与分支创建"。
+**目录结构**：详见 `.aodw-next/02-workflow/rt-manager.md` 第 2 节"目录与分支创建"。
 
 **核心文档**：位于 RT 目录根目录，记录 RT 全生命周期信息（intake、decision、spec、plan、impact、invariants、tests、changelog 等）。
 
@@ -93,13 +95,15 @@ Spec 内容应包括：
 **Spec-Lite：**
 
 - AI 必须创建 / 更新：
-  - `RT/RT-XXX/spec-lite.md`
-
-Spec-Lite 内容应精简，至少包含：
+  - `RT/RT-XXX/rt-lite.md`（**单文件模式**，包含所有过程文档内容）
 
+`rt-lite.md §1 背景与目标` 至少需要填写：
 - 当前问题描述；
 - 目标行为（修复后 / 改进后的预期效果）；
-- 影响范围的文字说明。
+- 影响范围的文字说明；
+- 可验证的成功标准。
+
+> ⚠️ Spec-Lite 不再创建独立的 `spec-lite.md` 文件，全部内容整合在 `rt-lite.md` 中。
 
 ---
 
@@ -115,14 +119,8 @@ Spec-Lite 内容应精简，至少包含：
 
 **Spec-Lite：**
 
-- AI 必须创建 / 更新：
-  - `RT/RT-XXX/plan-lite.md`
-
-Plan-Lite 内容应包含：
-
-- 预期修改的代码位置（文件路径 / 模块）；
-- 简单的技术方案；
-- 潜在风险与注意事项。
+- `rt-lite.md §2 方案设计` 已包含 Plan 内容（修改点、方案描述、最小必要改动）。
+- 不再创建独立的 `plan-lite.md`。
 
 ---
 
@@ -194,7 +192,7 @@ files:
 
 AI 在进行修改时，必须执行 **Mapping Check**：
 
-1.  **查索引**：读取 `.aodw/06-project/modules-index.yaml`，获取所有模块的 `root` 路径。
+1.  **查索引**：读取 `.aodw-next/06-project/modules-index.yaml`，获取所有模块的 `root` 路径。
 2.  **匹配路径**：检查本次修改的文件路径是否落在某个模块的 `root` 下。
 3.  **定位文档**：如果匹配，读取对应的 `path`（即模块 README）。
 4.  **验证 Frontmatter**：进一步检查模块 README 中的 `files` 字段是否包含该文件。
@@ -283,7 +281,7 @@ AI 不应在发现明显不一致时保持沉默。
 
 **何时更新 meta.yaml**：RT 创建、类型/Profile/状态/模块/工具/负责人变更、RT 结束时。
 
-**何时更新 index.yaml**：新建 RT、meta.yaml 发生变更时同步更新。详细操作规范见 `.aodw/02-workflow/rt-manager.md` 第 9 节。
+**何时更新 index.yaml**：新建 RT、meta.yaml 发生变更时同步更新。详细操作规范见 `.aodw-next/02-workflow/rt-manager.md` 第 9 节。
 
 **一致性检查**：RT 进入 `done` 状态前，检查 meta.yaml 与 index.yaml 是否一致。
 
@@ -293,7 +291,7 @@ AI 不应在发现明显不一致时保持沉默。
 
 ⚠️ **重要**：所有时间字段必须使用系统真实时间，严禁 AI 自行推断或使用假时间。
 
-**详细规则**：请参考 `.aodw/02-workflow/rt-manager.md` 第 10 节"时间字段获取规则（强制要求）"。
+**详细规则**：请参考 `.aodw-next/02-workflow/rt-manager.md` 第 10 节"时间字段获取规则（强制要求）"。
 
 **关键要求**：
 - 必须通过系统命令或 API 获取真实时间

package/.aodw-next/01-core/ai-project-overview-rules.md

@@ -8,9 +8,9 @@
 - 用户要求 AI 帮助完善架构描述、模块职责等复杂信息
 
 **必须与以下规范配合使用**：
-- `.aodw/06-project/ai-overview.md`（项目概览文件）
-- `.aodw/06-project/modules-index.yaml`（模块索引）
-- `.aodw/01-core/ai-knowledge-rules.md`（知识维护规则）
+- `.aodw-next/06-project/ai-overview.md`（项目概览文件）
+- `.aodw-next/06-project/modules-index.yaml`（模块索引）
+- `.aodw-next/01-core/ai-knowledge-rules.md`（知识维护规则）
 
 ---
 
@@ -37,8 +37,8 @@
 ### Step 1: 读取现有信息
 
 AI 必须：
-1. 读取 `.aodw/06-project/ai-overview.md`
-2. 读取 `.aodw/06-project/modules-index.yaml`
+1. 读取 `.aodw-next/06-project/ai-overview.md`
+2. 读取 `.aodw-next/06-project/modules-index.yaml`
 3. 识别哪些内容是自动检测的（标记为 `<!-- AUTO-DETECTED -->`）
 4. 识别哪些内容是用户手动添加的（标记为 `<!-- USER-ADDED -->`）
 5. 识别哪些内容需要完善（标记为"待补充"或缺失）
@@ -46,7 +46,7 @@ AI 必须：
 ### Step 2: 确定初始化模式
 
 AI 必须先判断当前项目状态：
-1. 检查根目录是否为空（排除 `.aodw` 和隐藏文件）
+1. 检查根目录是否为空（排除 `.aodw-next` 和隐藏文件）
 2. 检查关键文件（`package.json`, `pom.xml`, `requirements.txt`, `src` 目录等）
 
 **分支 A：接手老项目（检测模式）**
@@ -193,7 +193,7 @@ Recommended: A（理由：...）
 
 ### 自动检测的内容
 ```markdown
-<!-- AUTO-DETECTED: 以下内容由 aodw init-overview 自动检测 -->
+<!-- AUTO-DETECTED: 以下内容由 aodw-skill init-overview 自动检测 -->
 - 前端：React 18.3.0
 - 后端：FastAPI 0.104.0
 <!-- END AUTO-DETECTED -->
@@ -249,17 +249,17 @@ Recommended: A（理由：...）
 2. **逐步完善**：不要一次性要求用户完善所有信息，可以分步骤进行
 3. **提供建议**：AI 应该基于代码分析提供建议，而不是只询问用户
 4. **格式规范**：确保生成的内容符合 `ai-overview.md` 的模板格式
-5. **及时更新**：当项目结构发生变化时，提醒用户运行 `aodw init-overview` 更新
+5. **及时更新**：当项目结构发生变化时，提醒用户运行 `aodw-skill init-overview` 更新
 
 ---
 
 ## 8. 与 CLI 命令的关系
 
-- **CLI 命令**（`aodw init-overview`）：负责自动检测和生成基础信息
+- **CLI 命令**（`aodw-skill init-overview`）：负责自动检测和生成基础信息
 - **AI 规则**（本文件）：负责引导用户完善复杂信息（架构描述、模块职责等）
 
 两者配合使用：
-1. 用户运行 `aodw init-overview` 生成基础信息
+1. 用户运行 `aodw-skill init-overview` 生成基础信息
 2. 用户运行"初始化项目概览"命令，AI 引导完善详细信息
 
 
@@ -276,7 +276,7 @@ Recommended: A（理由：...）
 ⚠️ 下一步建议（重要）：
 **执行工具初始化**
 由于我们已经确定了项目技术栈，现在请运行：
-`aodw init-tools` 或告诉 AI "初始化工具"
+`aodw-skill init-tools` 或告诉 AI "初始化工具"
 
 这将根据 ai-overview.md 中的技术栈，为您自动配置：
 - 前端：ESLint / Prettier (基于 React/Vue)