aodw-skill 0.7.13 → 0.7.17

package/.aodw-next/02-workflow/spec-full-profile-summary.md

@@ -1,13 +0,0 @@
-# Spec-Full Profile Summary
-
-## 适用场景
-- 跨模块、大改动、高风险、数据模型/合约变更
-
-## 必备文档
-- spec.md / plan.md / impact.md / invariants.md / tests.md / changelog.md
-- 需要时补充 research / data-model / contracts
-
-## 关键要求
-- spec 完成后必须执行需求审计
-- plan 完成后必须等待用户确认
-- UI 任务需走 UI 专用流程

package/.aodw-next/06-project/ai-overview.md

@@ -1,116 +0,0 @@
-# AI System Overview  
-（本文件列出 AI 理解本系统所需的全局信息）
-
-> 说明：本文件是骨架模板，AI 可以在后续 RT 中逐步补全。  
-> 修改架构或模块职责时，AI 必须同步更新本文件。
-
----
-
-## 1. 技术栈
-
-- 前端：
-- 后端：
-- 数据库：
-- 消息系统：
-- 缓存：
-- 运维 / 部署：
-- 其他：
-
-（由 AI 或人工在首次接入 AODW 时填写，后续在架构变动时更新）
-
----
-
-## 2. 整体架构概览
-
-可以使用文字或 ASCII 图描述系统架构，例如：
-
-```text
-[ Web / Mobile Client ]
-           |
-        [ API ]
-           |
-   [ Services / Domain ]
-           |
-        [ DB / MQ ]
-```
-
-AI 应在理解架构后，将关键组件简要记录在此处。
-
----
-
-## 3. 目录结构（只列关键部分）
-
-请根据实际项目补充，例如：
-
-- `/apps/web` - 前端应用
-- `/apps/api` - 后端 API
-- `/packages/shared` - 共享代码（类型、工具等）
-- `/infra` - 基础设施与部署脚本
-- `/RT` - 每个 Request Ticket 的本地知识库
-- `/aodw` - AODW 配置与规则文件（本目录）
-
-AI 在修改目录结构时，需要在此更新说明。
-
----
-
-## 4. 核心业务模块
-
-为每个重要业务模块列出简要说明（AI 可从模块 README 中提取信息汇总到这里）。
-
-示例模板：
-
-### 4.1 用户模块（User Module）
-
-- **职责**：认证、授权、用户资料管理等
-- **关键路径**：
-  - Web UI：`apps/web/src/features/user/...`
-  - API：`apps/api/src/users/...`
-- **依赖关系**：
-  - 调用：订单模块、通知模块等
-  - 被调用：认证中间件等
-- **关键约束**：
-  - 不得在 controller 中直接访问数据库，必须通过 service / repository 层；
-  - 密码与敏感字段必须加密或脱敏。
-
-### 4.2 订单模块（Order Module）
-
-（同样结构）
-
----
-
-## 5. 系统级 Invariants（不可破坏原则）
-
-AI 在修改任何代码前必须确认不会违反以下约束：
-
-- 不得绕过 service 层直接访问 DB；
-- 不得无故更改对外 API 返回格式（除非走 Spec-Full 流程）；
-- 不得在热路径引入明显的性能退化；
-- 不得引入明显的安全风险（如绕过认证、明文敏感信息）。
-
-根据系统演进，这些 Invariants 可以在 RT 中进行讨论与更新。
-
----
-
-## 6. 模块 README 映射表
-
-为 AI 提供“代码目录 → 模块文档”的索引示例：
-
-```text
-apps/api/src/users/**      → docs/modules/users.md
-apps/api/src/orders/**     → docs/modules/orders.md
-apps/web/src/features/**   → docs/modules/web-features.md
-```
-
-AI 在创建新模块或重构模块结构时，应同步维护此映射关系。
-
----
-
-## 7. 历史关键变更（可选）
-
-可记录一些对架构或业务影响较大的里程碑，例如：
-
-- 2025-01：引入新订单系统；
-- 2025-03：从单体拆分为微服务；
-- 2025-05：迁移认证机制到 OAuth2。
-
-这些信息便于 AI 理解系统随时间的演进。

package/.aodw-next/06-project/modules-index.yaml

@@ -1,11 +0,0 @@
-version: 1
-
-# 模块索引 - 由 AI 在知识蒸馏时自动维护
-# 每当新增模块或修改模块结构时，AI 必须更新此文件
-
-modules:
-  # 示例格式：
-  # - name: module-name
-  #   path: docs/modules/module-name.md
-  #   root: path/to/module/code
-  #   description: 模块描述

package/.aodw-next/RELEASE-CHECKLIST.md

@@ -1,144 +0,0 @@
-# 编码规范融入 AODW - 发布前检查清单
-
-## ✅ 最终检查结果
-
-### 1. 核心流程文档修改 ✅
-
-- [x] **spec-full-profile.md**
-  - [x] Plan 模板添加"代码结构与分层设计"章节（第 4 节）
-  - [x] 添加"开发阶段要求"章节（第 6 节）
-  - [x] checklists 部分添加编码规范验收项
-  - [x] 已同步到 `templates/.aodw/02-workflow/spec-full-profile.md`
-
-- [x] **spec-lite-profile.md**
-  - [x] Plan-Lite 模板添加"代码结构与分层设计"章节（第 3 节）
-  - [x] 流程中添加开发准备、开发过程中、开发结束前自检要求
-  - [x] 已同步到 `templates/.aodw/02-workflow/spec-lite-profile.md`
-
-- [x] **git-discipline.md**
-  - [x] 添加"合并前检查清单"章节（第 5 节）
-  - [x] 编码规范检查作为合并的硬性要求
-  - [x] 自动化检查中添加编码规范检查（Step 2）
-  - [x] 已同步到 `templates/.aodw/01-core/git-discipline.md`
-
-- [x] **rt-manager.md**
-  - [x] Intake 流程中添加技术约束要求（第 180 行）
-  - [x] 已同步到 `templates/.aodw/02-workflow/rt-manager.md`
-
-### 2. 模板文件修改 ✅
-
-- [x] **rt-intake-template.md**
-  - [x] 添加"相关技术约束/规范"字段（第 6 节，可选）
-  - [x] 已同步到 `templates/.aodw/templates/rt-intake-template.md`
-
-- [x] **coding-standards-template.md**（新建）
-  - [x] 创建编码规范验收清单模板（103 行）
-  - [x] 包含前端、后端、通用编码规范验收项
-  - [x] 已同步到 `templates/.aodw/templates/checklists/coding-standards-template.md`
-
-### 3. 文件同步验证 ✅
-
-- [x] 所有核心流程文档已同步到模板目录
-- [x] 所有模板文件已同步到模板目录
-- [x] 新建的 checklists 目录已创建并同步
-
-### 4. 内容完整性验证 ✅
-
-- [x] Plan 模板包含完整的代码结构与分层设计内容
-- [x] 开发阶段要求包含完整的检查清单
-- [x] 合并前检查清单包含完整的编码规范检查项
-- [x] Intake 模板包含技术约束字段
-
-### 5. 引用路径验证 ✅
-
-- [x] 所有编码规范文件引用路径正确（`.aodw/ai-coding-rules-*.md`）
-- [x] 模板文件引用路径正确（`.aodw/templates/checklists/coding-standards-template.md`）
-
-### 6. 格式和语法验证 ✅
-
-- [x] Markdown 格式正确
-- [x] 标题层级正确
-- [x] 列表格式正确
-- [x] 代码块格式正确
-- [x] 无 Linter 错误
-
----
-
-## 📋 修改文件清单
-
-### 核心流程文档（4 个文件）
-1. ✅ `.aodw/02-workflow/spec-full-profile.md` → `templates/.aodw/02-workflow/spec-full-profile.md`
-2. ✅ `.aodw/02-workflow/spec-lite-profile.md` → `templates/.aodw/02-workflow/spec-lite-profile.md`
-3. ✅ `.aodw/01-core/git-discipline.md` → `templates/.aodw/01-core/git-discipline.md`
-4. ✅ `.aodw/02-workflow/rt-manager.md` → `templates/.aodw/02-workflow/rt-manager.md`
-
-### 模板文件（2 个文件）
-5. ✅ `.aodw/templates/rt-intake-template.md` → `templates/.aodw/templates/rt-intake-template.md`
-6. ✅ `.aodw/templates/checklists/coding-standards-template.md`（新建）→ `templates/.aodw/templates/checklists/coding-standards-template.md`
-
-### 其他相关文件（已存在，本次未修改）
-- `.aodw/03-standards/ai-coding-rules.md`（已包含按需加载机制）
-- `.aodw/03-standards/stacks/react-typescript/ai-coding-rules-frontend.md`（已存在）
-- `.aodw/03-standards/stacks/python-fastapi/ai-coding-rules-backend.md`（已存在）
-- `.aodw/03-standards/ai-coding-rules-common.md`（已存在）
-
----
-
-## 🎯 融入效果确认
-
-### ✅ 方案设计阶段
-- Plan 模板强制要求代码结构与分层设计
-- 编码规范符合性说明作为必填项
-- 防止"想到哪里写到哪里"
-
-### ✅ 开发阶段
-- 开发准备要求工具初始化和编码规范加载
-- 开发过程中要求遵守编码规范
-- 开发结束前要求自检
-
-### ✅ 提交/合并阶段
-- 编码规范检查作为合并的硬性要求
-- 未通过编码规范检查的代码不能合并
-- 确保代码质量
-
-### ✅ 测试/验收阶段
-- 编码规范验收清单模板已创建
-- 可作为补充验收项使用
-
-### ✅ 需求分析阶段
-- 技术约束字段已添加（可选）
-- AI 根据情况填写
-
----
-
-## ✅ 最终结论
-
-**所有检查通过，可以提交新版本**
-
-编码规范已成功融入 AODW 的各个关键节点：
-- ✅ 不再是"挂一个子流程"，而是"嵌入到主流程的每个节点"
-- ✅ 编码规范成为流程的必经步骤
-- ✅ 编码规范成为质量门槛
-- ✅ 编码规范从设计阶段就开始参与
-
-所有文件已正确修改并同步到模板目录，可以提交新版本。
-
----
-
-## 📝 提交建议
-
-建议提交信息：
-```
-feat(aodw): 将编码规范融入 AODW 各阶段流程
-
-- 在 Plan 模板中添加代码结构与分层设计章节（必须）
-- 在开发阶段添加编码规范要求（必须）
-- 在合并前检查清单中添加编码规范检查（必须）
-- 创建编码规范验收清单模板（可选）
-- 在 Intake 模板中添加技术约束字段（可选）
-
-编码规范已从"子流程"转变为"主流程的必经步骤"，
-确保代码质量从设计阶段就开始参与。
-
-Refs: [RT-ID]
-```

package/.aodw-next/templates/SOURCE-TO-DISTRIBUTION-GUIDE.md

@@ -1,276 +0,0 @@
-# 源文件到分发版本同步指南
-
-## 1. 目录关系说明
-
-AODW 项目中有三个 `.aodw` 目录，它们的关系如下：
-
-```
-项目根目录/
-├── .aodw/                    ← 【源文件】Source of Truth（开发者在这里修改）
-│   ├── aodw-constitution.md
-│   ├── rt-manager.md
-│   └── ...
-│
-├── templates/
-│   └── .aodw/                ← 【分发版本】Distribution Version（打包到 CLI 安装包）
-│       ├── aodw-constitution.md
-│       ├── rt-manager.md
-│       └── ...
-│
-└── cli/
-    └── .aodw/                ← 【本地构建版本】Local Build（用于本地测试）
-        ├── aodw-constitution.md
-        ├── rt-manager.md
-        └── ...
-```
-
-### 1.1 根目录 `.aodw`（源文件）
-
-**位置**：项目根目录的 `.aodw/`
-
-**作用**：
-- **源文件（Source of Truth）**
-- 开发者在这里修改和开发
-- 这是唯一应该手动编辑的目录
-
-**包含内容**：
-- 所有 AODW 核心规则文件
-- 模板文件
-- 开发文档
-
-### 1.2 `templates/.aodw`（分发版本）
-
-**位置**：`templates/.aodw/`
-
-**作用**：
-- **分发版本（Distribution Version）**
-- 用于打包到 CLI 安装包（npm 包）
-- 用户安装时，CLI 会从这个目录复制文件到用户项目
-
-**来源**：
-- 从根目录 `.aodw` 同步而来
-- **不应该**直接在这个目录修改
-
-### 1.3 `cli/.aodw`（本地构建版本）
-
-**位置**：`cli/.aodw/`
-
-**作用**：
-- **本地构建版本（Local Build）**
-- 用于本地测试 CLI
-- 运行 `cli/build-local.sh` 时会从 `templates/.aodw` 复制到这里
-
-**来源**：
-- 从 `templates/.aodw` 复制而来
-- **不应该**直接在这个目录修改
-
----
-
-## 2. 文件同步流程
-
-### 2.1 开发流程
-
-```
-开发者修改
-    ↓
-根目录 .aodw/          ← 【源文件】Source of Truth
-    ↓
-运行同步脚本
-    ↓
-templates/.aodw/        ← 【分发版本】Distribution Version
-    ↓
-运行构建脚本（可选）
-    ↓
-cli/.aodw/             ← 【本地构建版本】Local Build（用于测试）
-```
-
-### 2.2 发布流程
-
-```
-根目录 .aodw/          ← 【源文件】
-    ↓
-publish.sh 自动同步
-    ↓
-templates/.aodw/        ← 【分发版本】
-    ↓
-publish.sh 复制到 CLI
-    ↓
-cli/.aodw/             ← 【打包到 npm】
-    ↓
-npm publish
-    ↓
-用户安装
-    ↓
-用户项目的 .aodw/      ← 【用户项目】
-```
-
-> **双版本发布**：`publish.sh` 会根据当前分支自动选择发布渠道  
-> - `release/next` 或包含 `-next` 的分支 → 发布 `aodw-skill`  
-> - 其他分支 → 发布 `aodw`
-> - next 渠道使用独立模板目录：`templates/.aodw-next`、`templates/AODW_Adapters_next`、`templates/docs-next`
-
----
-
-## 3. 如何同步文件
-
-### 3.1 手动同步（推荐）
-
-运行同步脚本：
-
-```bash
-# 在项目根目录运行
-./sync-templates.sh
-```
-
-这个脚本会：
-1. 将根目录 `.aodw` 复制到 `templates/.aodw`
-2. 将根目录 `docs` 复制到 `templates/docs`
-3. 更新适配器文件（从模板生成）
-
-### 3.2 自动同步（发布时）
-
-`publish.sh` 脚本会自动同步：
-
-```bash
-# 在 cli 目录运行
-cd cli
-./publish.sh patch  # 或 minor, major
-```
-
-发布脚本会：
-1. 自动从根目录 `.aodw` 同步到 `templates/.aodw`
-2. 从 `templates/.aodw` 复制到 `cli/.aodw`
-3. 打包并发布到 npm
-
----
-
-## 4. 最佳实践
-
-### 4.1 开发时
-
-1. ✅ **只在根目录 `.aodw` 修改文件**
-2. ✅ **修改后运行同步脚本**：`./sync-templates.sh`
-3. ✅ **提交更改**：包括根目录 `.aodw` 和 `templates/.aodw`
-
-### 4.2 发布前
-
-1. ✅ **确保已同步**：运行 `./sync-templates.sh`
-2. ✅ **检查 templates/.aodw**：确保包含最新更改
-3. ✅ **运行发布脚本**：`cd cli && ./publish.sh [patch|minor|major]`
-
-### 4.3 本地测试
-
-1. ✅ **运行构建脚本**：`cd cli && ./build-local.sh`
-2. ✅ **测试 CLI**：`cd cli && node bin/aodw.js init`
-3. ✅ **验证文件**：检查生成的文件是否正确
-
----
-
-## 5. 常见问题
-
-### 5.1 为什么有两个 .aodw 目录？
-
-**原因**：
-- **根目录 `.aodw`**：源文件，开发者在这里修改
-- **`templates/.aodw`**：分发版本，用于打包
-
-**好处**：
-- 清晰的职责分离
-- 源文件和分发版本分离
-- 便于版本控制和发布管理
-
-### 5.2 我修改了根目录的 .aodw，但用户安装的还是旧版本
-
-**原因**：
-- 没有同步到 `templates/.aodw`
-- 发布时使用的是旧的 `templates/.aodw`
-
-**解决**：
-1. 运行 `./sync-templates.sh` 同步文件
-2. 提交更改
-3. 重新发布
-
-### 5.3 可以直接修改 templates/.aodw 吗？
-
-**不推荐**：
-- `templates/.aodw` 应该从根目录 `.aodw` 同步而来
-- 直接修改会导致源文件和分发版本不一致
-- 下次同步时会覆盖你的修改
-
-**正确做法**：
-- 在根目录 `.aodw` 修改
-- 运行同步脚本
-- 提交更改
-
-### 5.4 如何确保打包的是最新版本？
-
-**检查清单**：
-1. ✅ 根目录 `.aodw` 包含最新更改
-2. ✅ 运行了 `./sync-templates.sh`
-3. ✅ `templates/.aodw` 包含最新更改
-4. ✅ 提交了所有更改
-5. ✅ 运行了 `cd cli && ./publish.sh`
-
----
-
-## 6. 同步脚本说明
-
-### 6.1 sync-templates.sh
-
-**位置**：项目根目录的 `sync-templates.sh`
-
-**功能**：
-1. 同步 `.aodw` 目录：根目录 → `templates/.aodw`
-2. 同步 `docs` 目录：根目录 → `templates/docs`
-3. 更新适配器文件：从模板生成适配器文件
-
-**使用方法**：
-```bash
-# 在项目根目录运行
-./sync-templates.sh
-```
-
-### 6.2 publish.sh
-
-**位置**：`cli/publish.sh`
-
-**功能**：
-1. 自动同步根目录 `.aodw` → `templates/.aodw`
-2. 自动同步根目录 `docs` → `templates/docs`
-3. 复制 `templates/.aodw` → `cli/.aodw`
-4. 打包并发布到 npm
-
-**使用方法**：
-```bash
-cd cli
-./publish.sh patch  # 或 minor, major
-```
-
----
-
-## 7. 文件同步检查清单
-
-在发布前，确保：
-
-- [ ] 根目录 `.aodw` 包含所有最新更改
-- [ ] 运行了 `./sync-templates.sh`
-- [ ] `templates/.aodw` 与根目录 `.aodw` 一致
-- [ ] 适配器文件已更新（从模板生成）
-- [ ] 所有更改已提交到 Git
-- [ ] 运行了 `cd cli && ./publish.sh`
-
----
-
-## 8. 相关文件
-
-- **同步脚本**：`sync-templates.sh`（项目根目录）
-- **发布脚本**：`cli/publish.sh`
-- **构建脚本**：`cli/build-local.sh`
-- **更新适配器脚本**：`cli/bin/update-adapters-from-template.js`
-
----
-
-## 9. 版本历史
-
-- **v4.0.0**：引入源文件到分发版本的同步机制
-- **v4.0.1**：添加同步脚本和文档

package/.aodw-next/workflow-guide.md

@@ -1,51 +0,0 @@
-# AODW Workflow Guide (Level 2)
-
-本文件为 AODW 的核心流程指令层，用于在触发任务时快速加载。
-
-## 1. 核心流程（RT 生命周期）
-
-created → intakeing → decided → in-progress → reviewing → done
-
-关键动作：
-- **Intake**：澄清范围、风险、模块影响，记录到 `intake.md`
-- **Decision**：选择 Spec-Full / Spec-Lite，并记录到 `decision.md`
-- **Plan**：先写 plan，获批后进入实现
-
-## 2. Spec-Full vs Spec-Lite 决策
-
-使用 Spec-Full：
-- 跨模块影响
-- 数据模型 / schema 变更
-- 外部 API 合约变更
-- 高风险或高复杂度变更
-
-使用 Spec-Lite：
-- 局部改动
-- 单模块小修复
-- 无外部 API 合约变化
-
-## 3. Gate 检查点
-
-- Gate 1：Intake 澄清完成
-- Gate 2：分支确认（必须在 feature 分支）
-- Gate 3：Plan 确认（未批准不得实现）
-- Gate 4：提交前确认（展示 diff 与 status）
-- Gate 5：完成确认（文档与测试齐备）
-
-## 4. 加载策略（渐进式披露）
-
-优先读取：
-1. `.aodw/manifest.yaml`（规则索引）
-2. 本文件（流程指令）
-3. 必要规则文件（优先摘要 `*-summary.md`）
-
-摘要策略：
-- 先读 `*-summary.md`
-- 需要细节再读完整文件
-
-## 5. 关键文件入口
-
-- 规则索引：`.aodw/manifest.yaml`
-- RT 流程：`.aodw/02-workflow/rt-manager.md`
-- Spec-Full：`.aodw/02-workflow/spec-full-profile.md`
-- Spec-Lite：`.aodw/02-workflow/spec-lite-profile.md`