aodw-skill 0.7.13 → 0.7.17

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

@@ -1,302 +0,0 @@
-# AI Knowledge Maintenance Rules  
-AI 必须确保文档始终与代码一致。
-
-本文件定义“何时更新哪些文档”，以及文档与代码之间的映射方式。
-
----
-
-## 1. 总原则
-
-1. 文档是系统的一等公民，必须与代码一起演化；
-2. 任何重要改动都必须在相关文档中有所体现；
-3. AI 在执行任何非琐碎修改后，应主动检查并更新相关文档；
-4. 如果文档与代码不一致，AI 应优先尝试修正不一致，而不是忽略。
-
----
-
-## 2. 文档类别
-
-### 2.1 全局文档（Global）
-
-位于 `.aodw/` 或 `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`  
-- 模块 README（如 `docs/modules/users.md`、`docs/modules/orders.md` 等）  
-- 数据与合约文档（如 `data-model.md`、`contracts/*.md` / `contracts/*.yaml`）
-
-**当发生以下情况时，AI 必须更新相关全局文档：**
-
-- 整体架构变化（例如引入新子系统、拆分服务、替换核心中间件）；
-- 模块职责变化（例如将一部分业务从 A 模块迁移到 B 模块）；
-- 数据模型变化（增加 / 删除 / 修改实体或字段含义）；
-- 对外接口或协议变化（API、消息格式等）；
-- AODW 流程规则本身发生修改。
-
----
-
-### 2.2 RT 专属文档（Local per RT）
-
-每个 RT 都有自己的知识库目录，包括核心文档和过程文档。
-
-**目录结构**：详见 `.aodw/02-workflow/rt-manager.md` 第 2 节"目录与分支创建"。
-
-**核心文档**：位于 RT 目录根目录，记录 RT 全生命周期信息（intake、decision、spec、plan、impact、invariants、tests、changelog 等）。
-
-**过程文档**：位于 `RT/RT-XXX/docs/` 目录，记录执行过程中的分析、调研、决策。详细规则见第 7 节。
-
----
-
-## 3. 何时更新哪些文档
-
-### 3.1 Intake 阶段后
-
-在 RT-Manager 完成本 RT 的 Intake（立项）后：
-
-- 必须创建 / 更新：
-  - `RT/RT-XXX/intake.md`
-  - `RT/RT-XXX/decision.md`
-
-`intake.md` 应包含：
-
-- 原始用户描述；
-- AI 提出的问题与用户回答的简要记录；
-- 对需求 / 问题的归类（Feature / Bug / Enhancement / Refactor / Research 等）；
-- 初步范围与风险评估。
-
-`decision.md` 应包含：
-
-- 为何选择 Spec-Full 或 Spec-Lite；
-- 若存在备选流程（如纯 Research），记录为何未采用；
-- 如用户强行指定流程，记录 AI 的原始建议与用户的选择。
-
----
-
-### 3.2 Spec 阶段后（Spec-Full / Spec-Lite）
-
-**Spec-Full：**
-
-- AI 必须创建 / 更新：
-  - `RT/RT-XXX/spec.md`
-  - `RT/RT-XXX/clarifications`（可在 spec 中以章节形式存在）
-
-Spec 内容应包括：
-
-- 背景与目标；
-- 用户故事 / 功能需求；
-- 非功能需求（性能、安全、可用性等）；
-- 成功标准；
-- 需要澄清的历史问题记录（Q&A）。
-
-**Spec-Lite：**
-
-- AI 必须创建 / 更新：
-  - `RT/RT-XXX/spec-lite.md`
-
-Spec-Lite 内容应精简，至少包含：
-
-- 当前问题描述；
-- 目标行为（修复后 / 改进后的预期效果）；
-- 影响范围的文字说明。
-
----
-
-### 3.3 Plan 阶段后
-
-**Spec-Full：**
-
-- AI 必须创建 / 更新：
-  - `RT/RT-XXX/plan.md`
-  - `RT/RT-XXX/data-model.md`（如涉及数据模型变更）
-  - `RT/RT-XXX/contracts/`（如涉及对外接口变更）
-  - `RT/RT-XXX/research.md`（如有前期调研与决策）
-
-**Spec-Lite：**
-
-- AI 必须创建 / 更新：
-  - `RT/RT-XXX/plan-lite.md`
-
-Plan-Lite 内容应包含：
-
-- 预期修改的代码位置（文件路径 / 模块）；
-- 简单的技术方案；
-- 潜在风险与注意事项。
-
----
-
-### 3.4 修改代码前
-
-在实现前，AI 必须创建 / 更新：
-
-- `RT/RT-XXX/impact.md`  
-  - 当前问题是如何触发的；
-  - 哪些模块 / 功能直接受到影响；
-  - 哪些模块可能被间接影响；
-- `RT/RT-XXX/invariants.md`  
-  - 在本次改动中必须保持不变的行为；
-  - 不允许被破坏的数据与接口约束。
-
-这些文档是 **变更的约束条件**。如之后发现方案与 invariants 冲突，AI 应向用户明确指出，并建议走 Spec-Full 或修订 invariants。
-
----
-
-### 3.5 修改代码后
-
-在实现完成后，AI 必须：
-
-1. **更新 tests.md**
-
-   - 列出新增的测试用例及其覆盖的场景；
-   - 列出建议回归的关键用例；
-   - 如存在未自动化但应进行手动验证的场景，也应列出。
-
-2. **更新 changelog.md**
-
-   - 以简洁的方式概述本次 RT 对系统行为的改动；
-   - 如有潜在影响范围（例如“可能对历史数据产生影响”），加以说明；
-   - 标注与其他 RT 或模块的依赖关系。
-
-3. 如涉及数据模型或对外接口更改，必须更新：
-
-   - `data-model.md`；
-   - `contracts/` 中的相关说明；
-   - 相关模块 README；
-   - 必要时更新 `ai-overview.md`（例如新增了新的核心模块）。
-
----
-
-## 4. 文档与代码的映射（Frontmatter Mapping）
-
-为了帮助 AI 找到与某段代码相关的文档，建议在文档顶部使用 Frontmatter：
-
-```yaml
----
-rt: RT-001
-related_files:
-  - apps/api/src/orders/**
-  - apps/api/src/orders/order_service.ts
-  - apps/web/src/features/orders/**
----
-```
-
-或在模块 README 中：
-
-```yaml
----
-module: orders
-files:
-  - apps/api/src/orders/**
-  - apps/web/src/features/orders/**
----
-```
-
-AI 在进行修改时，必须执行 **Mapping Check**：
-
-1.  **查索引**：读取 `.aodw/06-project/modules-index.yaml`，获取所有模块的 `root` 路径。
-2.  **匹配路径**：检查本次修改的文件路径是否落在某个模块的 `root` 下。
-3.  **定位文档**：如果匹配，读取对应的 `path`（即模块 README）。
-4.  **验证 Frontmatter**：进一步检查模块 README 中的 `files` 字段是否包含该文件。
-5.  **更新文档**：确认匹配后，必须审查该文档，并将本次 RT 的变更同步更新进去。
-
-**如果找不到匹配的模块**：
-- 考虑是否需要创建一个新模块？
-- 或者该文件属于公共基础设施（需更新全局文档）？
-
----
-
-## 5. 文档一致性检查
-
-在 RT 实现流程的最后（合并 / 完成之前），AI 应进行一次快速一致性检查：
-
-**核心文档检查**：
-- 当前改动是否改变了数据模型？如果是，`data-model.md` 是否反映了这一点？
-- 当前改动是否改变了对外接口？如果是，`contracts/` 是否已更新？
-- 当前改动是否改变了模块职责？如果是，相关 README 是否已更新？
-- 当前 RT 的：
-  - `spec` / `spec-lite`
-  - `plan` / `plan-lite`
-  - `impact`
-  - `invariants`
-  - `tests`
-  - `changelog`
-
-  是否完整地记录了从"问题 → 方案 → 实现 → 测试 → 结果"的过程？
-
-**目录结构检查**：
-- 检查过程文档是否在正确位置（应在 `RT/RT-XXX/docs/` 目录下，详见第 7 节）
-- 检查核心文档是否完整（meta.yaml、intake.md、decision.md、spec/plan、impact、invariants、tests、changelog）
-
-如发现明显不一致，AI 应主动修订文档或提示用户。
-
----
-
-## 6. 版本控制与标签
-
-所有文档都应纳入 Git 版本控制。
-
-当一个 RT 完成时，推荐在：
-
-- 代码分支合并后打上 tag（例如 `done-RT-XXX`）；
-- 在 RT 的 `changelog.md` 中记录最终状态；
-- 如果本次 RT 涉及 AODW 制度本身的更新（例如修改了 `aodw-constitution.md`），应特别标注。
-
----
-
-## 7. 过程文档管理规则
-
-过程文档是指在 RT 执行过程中产生的、用于记录分析、调研、决策等过程的文档。
-
-**存储位置**：必须存放在 `RT/RT-XXX/docs/` 目录下，禁止与核心文档混放在根目录。
-
-**命名规范**：使用小写字母和连字符（如 `dependency-installation-strategy.md`），避免使用序号前缀。
-
-**何时创建**：进行策略分析、技术调研、设计决策、问题诊断、修复总结时。
-
-**与核心文档的关系**：过程文档是对核心文档的补充和细化，不应替代核心文档。
-
----
-
-## 8. 当信息缺失或不确定时
-
-如果 AI 判断文档中存在以下情况：
-
-- 信息缺失；
-- 描述明显过时；
-- 与代码行为明显矛盾；
-
-则 AI 应：
-
-1. 在当前 RT 中开辟一小节（可放在 `changelog.md` 或 `docs/` 目录下的单独文档中）记录发现的问题；
-2. 尝试基于当前代码自动修正文档；
-3. 在不确定时向用户提出明确问题，获取确认后再更新文档。
-
-AI 不应在发现明显不一致时保持沉默。
-
----
----
-
-## 9. RT 元数据与索引维护规则
-
-**元数据优先级**：`RT/RT-XXX/meta.yaml` 是权威来源，`RT/index.yaml` 是全局汇总。如不一致，以 meta.yaml 为准。
-
-**何时更新 meta.yaml**：RT 创建、类型/Profile/状态/模块/工具/负责人变更、RT 结束时。
-
-**何时更新 index.yaml**：新建 RT、meta.yaml 发生变更时同步更新。详细操作规范见 `.aodw/02-workflow/rt-manager.md` 第 9 节。
-
-**一致性检查**：RT 进入 `done` 状态前，检查 meta.yaml 与 index.yaml 是否一致。
-
----
-
-## 9.5 时间字段获取规则
-
-⚠️ **重要**：所有时间字段必须使用系统真实时间，严禁 AI 自行推断或使用假时间。
-
-**详细规则**：请参考 `.aodw/02-workflow/rt-manager.md` 第 10 节"时间字段获取规则（强制要求）"。
-
-**关键要求**：
-- 必须通过系统命令或 API 获取真实时间
-- 禁止使用 AI 训练数据、对话上下文或自行推断的时间
-- 时间格式：ISO8601（如 `2025-11-28T11:54:45Z`）
-- 适用范围：`meta.yaml`、`RT/index.yaml`、`AODW_Governance/version.md` 等所有时间字段

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

@@ -1,284 +0,0 @@
-# AI 项目概览初始化规则
-
-> **注意**：本文件定义 AI 如何引导用户完善项目概览信息。
-
-**适用场景**：
-- 用户说"初始化项目概览"、"完善项目信息"、"更新架构描述"等
-- 检测到 `ai-overview.md` 存在但内容不完整（标记为"需要完善"）
-- 用户要求 AI 帮助完善架构描述、模块职责等复杂信息
-
-**必须与以下规范配合使用**：
-- `.aodw/06-project/ai-overview.md`（项目概览文件）
-- `.aodw/06-project/modules-index.yaml`（模块索引）
-- `.aodw/01-core/ai-knowledge-rules.md`（知识维护规则）
-
----
-
-## 1. 触发条件
-
-当用户表达以下意图时，AI 必须执行项目概览完善流程：
-
-**明确命令**：
-- "初始化项目概览"
-- "完善项目信息"
-- "更新架构描述"
-- "完善模块职责"
-- "更新项目概览"
-
-**隐含意图**：
-- "AI 帮我完善一下项目信息"
-- "架构描述不完整，帮我补充"
-- "模块信息需要更新"
-
----
-
-## 2. 执行流程
-
-### Step 1: 读取现有信息
-
-AI 必须：
-1. 读取 `.aodw/06-project/ai-overview.md`
-2. 读取 `.aodw/06-project/modules-index.yaml`
-3. 识别哪些内容是自动检测的（标记为 `<!-- AUTO-DETECTED -->`）
-4. 识别哪些内容是用户手动添加的（标记为 `<!-- USER-ADDED -->`）
-5. 识别哪些内容需要完善（标记为"待补充"或缺失）
-
-### Step 2: 确定初始化模式
-
-AI 必须先判断当前项目状态：
-1. 检查根目录是否为空（排除 `.aodw` 和隐藏文件）
-2. 检查关键文件（`package.json`, `pom.xml`, `requirements.txt`, `src` 目录等）
-
-**分支 A：接手老项目（检测模式）**
-- **判定条件**：检测到现有代码或配置文件。
-- **AI 行为**：
-  1. 自动扫描代码结构。
-  2. 识别技术栈和依赖关系。
-  3. 填充 `ai-overview.md` 的草稿。
-  4. 引导用户确认检测结果。
-
-**分支 B：全新空项目（设计模式）**
-- **判定条件**：目录为空或仅包含 AODW 初始文件。
-- **AI 行为**：
-  1. 启动"架构师访谈模式"。
-  2. 询问用户意图："由于是新项目，请问您打算构建什么系统？采用什么技术栈？"
-  3. 根据用户回答，生成建议的 `ai-overview.md`（作为设计蓝图）。
-  4. 协助规划基础目录结构（Scaffolding）。
-
-### Step 3: 引导用户完善
-
-AI 必须按照以下顺序引导用户完善信息：
-
-#### 3.1 技术栈确认
-
-**如果技术栈部分不完整**：
-- AI 读取 CLI 检测到的技术栈
-- 询问用户确认或补充：
-  ```
-  检测到的技术栈：
-  - 前端：React 18.3.0、TypeScript 5.0.0
-  - 后端：FastAPI 0.104.0、Python 3.11
-  
-  请确认是否正确，或补充缺失的信息：
-  ```
-
-#### 3.2 架构概览
-
-**如果架构概览部分为空或标记为"待补充"**：
-- AI 基于技术栈和目录结构生成架构图建议
-- 引导用户确认或修改：
-  ```
-  基于项目结构，建议的架构概览：
-  
-  ```text
-  [ Web Client (React) ]
-           |
-        [ API Gateway (FastAPI) ]
-           |
-   [ Services / Domain ]
-           |
-        [ PostgreSQL / Redis ]
-  ```
-  
-  请确认是否符合您的架构，或提供修改建议。
-  ```
-
-#### 3.3 模块职责
-
-**如果模块职责部分不完整**：
-- AI 读取 `modules-index.yaml` 中的模块列表
-- 对于每个模块，AI 分析代码结构，生成职责建议
-- 引导用户确认或补充：
-  ```
-  检测到模块：user、order、payment
-  
-  基于代码分析，建议的模块职责：
-  
-  ### user 模块
-  - **职责**：用户认证、授权、用户资料管理
-  - **关键路径**：backend/app/users/**
-  - **依赖关系**：被 order、payment 模块调用
-  
-  请确认或补充每个模块的职责和约束。
-  ```
-
-#### 3.4 系统级 Invariants
-
-**如果 Invariants 部分为空或标记为"待补充"**：
-- AI 基于代码分析生成初始约束建议
-- 引导用户确认或添加：
-  ```
-  基于代码结构分析，建议的系统级约束：
-  
-  - 不得绕过 service 层直接访问 DB
-  - 不得无故更改对外 API 返回格式
-  - 不得在热路径引入明显的性能退化
-  
-  请确认或补充其他约束。
-  ```
-
-#### 3.5 历史关键变更
-
-**如果历史变更部分为空**：
-- AI 询问用户是否有重要的架构演进里程碑
-- 引导用户记录：
-  ```
-  是否有重要的架构演进里程碑需要记录？
-  例如：
-  - 2025-01：引入新订单系统
-  - 2025-03：从单体拆分为微服务
-  
-  如有，请提供时间和描述。
-  ```
-
-### Step 4: 更新文件
-
-AI 必须：
-1. 将用户确认的信息更新到 `ai-overview.md`
-2. 标记用户添加的内容为 `<!-- USER-ADDED -->`
-3. 更新 `modules-index.yaml`（如有模块信息变更）
-4. 确保格式符合模板要求
-
----
-
-## 3. 交互格式
-
-AI 必须遵循 `ai-interaction-rules.md` 中的交互规范：
-
-**问题格式**：
-```
-Q1. [问题描述]
-
-A. [选项1]（推荐）
-B. [选项2]
-C. [选项3]
-
-Recommended: A（理由：...）
-
-请回复：A/B/C
-```
-
-**确认格式**：
-```
-检测到以下信息：
-- [信息1]
-- [信息2]
-
-请确认是否正确，或提供修改建议。
-```
-
----
-
-## 4. 内容标记规范
-
-### 自动检测的内容
-```markdown
-<!-- AUTO-DETECTED: 以下内容由 aodw init-overview 自动检测 -->
-- 前端：React 18.3.0
-- 后端：FastAPI 0.104.0
-<!-- END AUTO-DETECTED -->
-```
-
-### 用户手动添加的内容
-```markdown
-<!-- USER-ADDED: 以下内容由用户手动添加 -->
-- 数据库：PostgreSQL 15（使用连接池，最大连接数 100）
-<!-- END USER-ADDED -->
-```
-
-### AI 引导完善的内容
-```markdown
-<!-- AI-ENHANCED: 以下内容由 AI 引导用户完善 -->
-- 架构概览：[架构图]
-<!-- END AI-ENHANCED -->
-```
-
----
-
-## 5. 更新策略
-
-### 保留原则
-1. **保留用户内容**：所有标记为 `<!-- USER-ADDED -->` 的内容必须保留
-2. **更新检测内容**：标记为 `<!-- AUTO-DETECTED -->` 的内容可以更新
-3. **完善待补充内容**：标记为"待补充"的内容由 AI 引导用户完善
-
-### 冲突处理
-当用户手动修改的内容与检测结果冲突时：
-1. AI 必须显示差异
-2. AI 必须询问用户如何处理
-3. AI 必须等待用户确认后再更新
-
----
-
-## 6. 完成标准
-
-项目概览完善完成的标准：
-- [ ] 技术栈信息完整且准确
-- [ ] 架构概览已描述或提供架构图
-- [ ] 目录结构已列出关键目录
-- [ ] 核心业务模块职责已描述
-- [ ] 系统级 Invariants 已列出
-- [ ] 模块 README 映射表已建立
-- [ ] 历史关键变更已记录（如有）
-
----
-
-## 7. 注意事项
-
-1. **不要覆盖用户内容**：所有用户手动添加的内容必须保留
-2. **逐步完善**：不要一次性要求用户完善所有信息，可以分步骤进行
-3. **提供建议**：AI 应该基于代码分析提供建议，而不是只询问用户
-4. **格式规范**：确保生成的内容符合 `ai-overview.md` 的模板格式
-5. **及时更新**：当项目结构发生变化时，提醒用户运行 `aodw init-overview` 更新
-
----
-
-## 8. 与 CLI 命令的关系
-
-- **CLI 命令**（`aodw init-overview`）：负责自动检测和生成基础信息
-- **AI 规则**（本文件）：负责引导用户完善复杂信息（架构描述、模块职责等）
-
-两者配合使用：
-1. 用户运行 `aodw init-overview` 生成基础信息
-2. 用户运行"初始化项目概览"命令，AI 引导完善详细信息
-
-
-
-
-
-### Step 5: 完成后的下一步
-
-完成项目概览后，AI 必须强烈建议用户进行工具初始化：
-
-```markdown
-✅ 项目概览初始化完成！
-
-⚠️ 下一步建议（重要）：
-**执行工具初始化**
-由于我们已经确定了项目技术栈，现在请运行：
-`aodw init-tools` 或告诉 AI "初始化工具"
-
-这将根据 ai-overview.md 中的技术栈，为您自动配置：
-- 前端：ESLint / Prettier (基于 React/Vue)
-- 后端：Ruff / Black / Maven (基于 Python/Java)
-```

package/.aodw-next/.aodw-next/01-core/aodw-constitution-summary.md

@@ -1,20 +0,0 @@
-# AODW Constitution Summary
-
-## 核心理念
-- KISS：保持简单，避免过度设计
-- 第一性原理分析
-- 事实为本，允许纠错
-- 渐进式开发：构思 → 审核 → 执行
-- 中文交流为默认标准
-
-## 关键规则
-- 输出与交互必须选项化并给出推荐理由
-- 文档与代码必须同步，不一致视为 Bug
-- 复杂任务必须维护 `task.md`（Spec-Full 必需）
-
-## 架构层级
-- 交互层 / 编排层 / 执行层 / 知识层
-
-## 统一要求
-- RT-ID、目录、分支命名必须规范
-- 关键文档需持续维护并保持一致