aodw-skill 0.7.13 → 0.7.17

package/.aodw-next/.aodw-next/templates/rt-meta-template.yaml

@@ -1,43 +0,0 @@
-# RT 元数据模板（单个 RT 的权威信息）
-# 路径建议：.aodw/templates/rt-meta-template.yaml
-
-id: RT-XXX                     # 由 RT-Manager 生成，例如 RT-001
-title: <在此填写简短标题>        # 例如 "修复订单列表加载缓慢的问题"
-
-# RT 类型：用于分类与统计
-# 可选值：Feature | Bug | Enhancement | Refactor | Research | AODW
-type: Bug
-
-# 使用的 AODW Profile
-# 可选值：Spec-Full | Spec-Lite
-profile: Spec-Lite
-
-# 当前状态
-# 可选值：created | intakeing | decided | in-progress | reviewing | done
-status: created
-
-# 涉及的业务/技术模块标识，来自你的模块体系（例如 orders / users / auth 等）
-modules: []
-
-# 当前主要执行工具：cursor / claude / mixed / unknown
-tool: unknown
-
-# 负责人（可选，可以是人名、昵称或账号）
-owner: null
-
-# 时间字段（必须使用系统命令或 API 获取真实时间，禁止 AI 自行推断）
-# 获取方法：date -u +"%Y-%m-%dT%H:%M:%SZ" 或 new Date().toISOString()
-# 格式：ISO8601（如 2025-11-28T11:54:45Z 或 2025-11-28T19:54:45+08:00）
-created_at: <to-be-filled>
-updated_at: <to-be-filled>
-closed_at: null
-
-# 与外部系统（JIRA / GitHub Issues 等）的关联 ID
-external_ids:
-  jira: null
-  github: null
-  other: null
-
-# 额外说明（可选，供人和 AI 阅读）
-notes: >
-  在这里简要描述本 RT 的背景、限制或特殊说明。

package/.aodw-next/.aodw-next/templates/spec-lite-template.md

@@ -1,17 +0,0 @@
-# Spec-Lite: RT-XXX - <short title>
-
-## 1. 背景（Context）
-- 当前存在的问题 / 需求：
-
-## 2. 目标（Goal）
-- 希望达到的业务 / 用户效果：
-
-## 3. 当前行为（Current Behavior）
-- 当前系统在相关场景下的行为：
-
-## 4. 期望行为（Desired Behavior）
-- 修改后的预期行为：
-
-## 5. 影响范围（Scope）
-- 涉及模块 / 文件：
-- 预期不应影响的功能：

package/.aodw-next/.aodw-next/templates/tests-template.md

@@ -1,13 +0,0 @@
-# Tests: RT-XXX - <short title>
-
-## 1. 新增测试用例（New Tests）
-- [ ] 描述用例 1（对应测试文件路径）
-- [ ] 描述用例 2
-
-## 2. 回归测试（Regression）
-- [ ] 回归用例 1
-- [ ] 回归用例 2
-
-## 3. 手动验证建议（Manual Checks）
-- [ ] 手动步骤 1
-- [ ] 手动步骤 2

package/.aodw-next/.aodw-next/templates/tools-config/README.md

@@ -1,112 +0,0 @@
-# 工具配置模板
-
-本目录包含 AODW 规范要求的开发工具配置模板。
-
-## 目录结构
-
-```
-tools-config/
-├── frontend/          # 前端工具配置模板
-│   ├── eslint.config.template.json
-│   ├── prettier.config.template.json
-│   └── tsconfig.paths.template.json
-├── backend/           # 后端工具配置模板
-│   ├── ruff.config.template.toml          # Python 代码质量检查
-│   ├── black.config.template.toml         # Python 代码格式化
-│   ├── rustfmt.config.template.toml       # Rust 代码格式化
-│   ├── clippy.config.template.toml        # Rust 代码质量检查
-│   └── pre-commit.config.template.yaml    # Git 提交前检查（通用）
-└── README.md
-```
-
-## 使用方式
-
-### 方式 1：通过 CLI 命令
-
-```bash
-aodw init-tools
-```
-
-CLI 会自动检测项目类型，并使用相应的模板生成配置文件。
-
-### 方式 2：通过 AI 命令
-
-在 AI 工具（Cursor/Claude 等）中说：
-- "初始化工具"
-- "设置开发工具"
-- "配置工具"
-
-AI 会引导您完成工具初始化和配置。
-
-## 配置说明
-
-### 前端配置
-
-#### ESLint 配置
-- 文件：`.eslintrc.json` 或 `eslint.config.js`
-- 模板：`frontend/eslint.config.template.json`
-- 包含：TypeScript、React、Hooks、Import、可访问性规则
-- 限制：文件大小、函数长度、复杂度
-
-#### Prettier 配置
-- 文件：`.prettierrc.json` 或 `prettier.config.js`
-- 模板：`frontend/prettier.config.template.json`
-- 包含：代码格式化规则
-
-#### TypeScript Path Alias
-- 文件：`tsconfig.json`
-- 模板：`frontend/tsconfig.paths.template.json`
-- 包含：路径别名配置（@app、@pages、@features、@shared）
-
-### 后端配置
-
-#### Python 项目工具
-
-**Ruff 配置**：
-- 文件：`pyproject.toml`（合并到 `[tool.ruff]` 部分）
-- 模板：`backend/ruff.config.template.toml`
-- 包含：代码质量检查、复杂度限制
-
-**Black 配置**：
-- 文件：`pyproject.toml`（合并到 `[tool.black]` 部分）
-- 模板：`backend/black.config.template.toml`
-- 包含：代码格式化规则
-
-#### Rust 项目工具
-
-**rustfmt 配置**：
-- 文件：`rustfmt.toml`（项目根目录）
-- 模板：`backend/rustfmt.config.template.toml`
-- 包含：代码格式化规则（edition、max_width、imports 等）
-
-**clippy 配置**：
-- 文件：`clippy.toml`（项目根目录）或 `Cargo.toml` 的 `[lints.clippy]` 部分
-- 模板：`backend/clippy.config.template.toml`
-- 包含：代码质量检查、复杂度限制、零警告策略
-
-#### Java 项目工具
-
-**Checkstyle 配置**（推荐）：
-- 文件：`checkstyle.xml`（项目根目录）
-- 模板：`backend/checkstyle.config.template.xml`（如果存在）
-- 包含：Java 代码风格检查规则
-- 配置方式：在 `pom.xml` 中添加 `maven-checkstyle-plugin`
-
-**Spotless 配置**（推荐）：
-- 文件：`pom.xml` 中的 `spotless-maven-plugin` 配置
-- 模板：`backend/spotless.config.template.xml`（如果存在）
-- 包含：Java 代码格式化规则（Google Java Format）
-- 配置方式：在 `pom.xml` 中添加 `spotless-maven-plugin`
-
-#### 通用工具配置
-
-**pre-commit 配置**：
-- 文件：`.pre-commit-config.yaml`
-- 模板：`backend/pre-commit.config.template.yaml`
-- 包含：Git 提交前检查钩子（支持 Python、Rust、Java 等）
-
-## 注意事项
-
-1. **配置文件合并**：如果配置文件已存在，工具初始化会询问您是否合并配置
-2. **模板更新**：模板更新不会自动应用到已有项目，需要重新运行工具初始化
-3. **自定义配置**：您可以在工具初始化后手动调整配置，但建议保持核心规范不变

package/.aodw-next/.aodw-next/templates/tools-config/backend/black.config.template.toml

@@ -1,6 +0,0 @@
-# Black 配置模板（TOML 片段）
-# 需要合并到 pyproject.toml 的 [tool.black] 部分
-
-[tool.black]
-line-length = 100
-target-version = ["py311"]

package/.aodw-next/.aodw-next/templates/tools-config/backend/pre-commit.config.template.yaml

@@ -1,16 +0,0 @@
-repos:
-  - repo: local
-    hooks:
-      - id: backend-ruff
-        name: Backend Ruff Check
-        entry: ruff check .
-        language: system
-        pass_filenames: false
-        always_run: true
-
-      - id: backend-black
-        name: Backend Black Format
-        entry: black .
-        language: system
-        pass_filenames: false
-        always_run: true

package/.aodw-next/.aodw-next/templates/tools-config/backend/ruff.config.template.toml

@@ -1,23 +0,0 @@
-# Ruff 配置模板（TOML 片段）
-# 需要合并到 pyproject.toml 的 [tool.ruff] 部分
-
-[tool.ruff]
-line-length = 100
-target-version = "py311"
-
-[tool.ruff.lint]
-select = [
-  "E",    # 基本语法错误
-  "F",    # 未使用变量、导入等
-  "I",    # import 排序
-  "PLR",  # 复杂度 & 过长函数（核心）
-]
-ignore = []
-
-# ✅ 重点拦截：
-# PLR0915 -> 函数语句过多（怪物函数）
-# PLR0912 -> 分支过多
-# PLR0911 -> return 过多
-
-[tool.ruff.lint.per-file-ignores]
-"__init__.py" = ["F401"]

package/.aodw-next/.aodw-next/templates/tools-config/frontend/eslint.config.template.json

@@ -1,113 +0,0 @@
-{
-  "root": true,
-  "parser": "@typescript-eslint/parser",
-  "parserOptions": {
-    "ecmaVersion": 2022,
-    "sourceType": "module",
-    "ecmaFeatures": {
-      "jsx": true
-    },
-    "project": "./tsconfig.json"
-  },
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/recommended",
-    "plugin:react/recommended",
-    "plugin:react-hooks/recommended",
-    "plugin:import/recommended",
-    "plugin:import/typescript",
-    "plugin:jsx-a11y/recommended",
-    "prettier"
-  ],
-  "plugins": [
-    "@typescript-eslint",
-    "react",
-    "react-hooks",
-    "import",
-    "jsx-a11y"
-  ],
-  "settings": {
-    "react": {
-      "version": "detect"
-    },
-    "import/resolver": {
-      "typescript": {
-        "alwaysTryTypes": true,
-        "project": "./tsconfig.json"
-      },
-      "node": {
-        "extensions": [".js", ".jsx", ".ts", ".tsx"]
-      }
-    }
-  },
-  "rules": {
-    "max-lines": ["error", { "max": 300, "skipBlankLines": true, "skipComments": true }],
-    "max-lines-per-function": ["error", { "max": 60, "skipBlankLines": true, "skipComments": true }],
-    "complexity": ["error", 10],
-    "import/order": [
-      "error",
-      {
-        "groups": ["builtin", "external", "internal", "parent", "sibling", "index"],
-        "pathGroups": [
-          {
-            "pattern": "@app/**",
-            "group": "internal",
-            "position": "before"
-          },
-          {
-            "pattern": "@pages/**",
-            "group": "internal",
-            "position": "before"
-          },
-          {
-            "pattern": "@features/**",
-            "group": "internal",
-            "position": "before"
-          },
-          {
-            "pattern": "@shared/**",
-            "group": "internal",
-            "position": "before"
-          }
-        ],
-        "pathGroupsExcludedImportTypes": ["builtin"],
-        "newlines-between": "always",
-        "alphabetize": {
-          "order": "asc",
-          "caseInsensitive": true
-        }
-      }
-    ],
-    "no-restricted-imports": [
-      "error",
-      {
-        "paths": [
-          {
-            "name": "@pages",
-            "message": "pages 只能从 features / shared 引用，不能直接引用其他 pages"
-          }
-        ],
-        "patterns": [
-          {
-            "group": ["@features/*/components", "@features/*/hooks", "@features/*/store"],
-            "message": "features 不能直接引用其他 features 的内部实现，只能走公共入口"
-          }
-        ]
-      }
-    ]
-  },
-  "overrides": [
-    {
-      "files": ["src/pages/**/*.tsx", "src/pages/**/*.ts"],
-      "rules": {
-        "max-lines": ["error", { "max": 300, "skipBlankLines": true, "skipComments": true }]
-      }
-    },
-    {
-      "files": ["src/features/**/*.tsx", "src/features/**/*.ts", "src/shared/**/*.tsx", "src/shared/**/*.ts"],
-      "rules": {
-        "max-lines": ["error", { "max": 200, "skipBlankLines": true, "skipComments": true }]
-      }
-    }
-  ]
-}

package/.aodw-next/.aodw-next/templates/tools-config/frontend/prettier.config.template.json

@@ -1,10 +0,0 @@
-{
-  "semi": true,
-  "trailingComma": "es5",
-  "singleQuote": true,
-  "printWidth": 100,
-  "tabWidth": 2,
-  "useTabs": false,
-  "arrowParens": "avoid",
-  "endOfLine": "lf"
-}

package/.aodw-next/.aodw-next/templates/tools-config/frontend/tsconfig.paths.template.json

@@ -1,11 +0,0 @@
-{
-  "compilerOptions": {
-    "baseUrl": ".",
-    "paths": {
-      "@app/*": ["src/app/*"],
-      "@pages/*": ["src/pages/*"],
-      "@features/*": ["src/features/*"],
-      "@shared/*": ["src/shared/*"]
-    }
-  }
-}

package/.aodw-next/.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`

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

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

package/.aodw-next/02-workflow/aodw-development-stages.md

@@ -1,235 +0,0 @@
-# AODW 开发阶段分析
-
-## 阶段总览
-
-AODW 将开发过程分为 7 个主要阶段，对应 RT 状态机：created → intaking → decided → in-progress → reviewing → done
-
----
-
-## 阶段 1: Intake（立项）
-
-**状态转换**: created → intaking → decided
-
-**主要任务**:
-- 生成 RT-ID（RT-{seq}）
-- 创建 RT 目录结构（RT/RT-XXX/）
-- 通过交互式提问收集需求信息
-- 记录原始描述、问题与答案
-- 初步判断需求类型（Feature/Bug/Enhancement/Refactor/Research）
-
-**阶段目标**: 明确需求范围、风险等级、影响模块估计，为 Profile 决策做准备
-
-**输出物**:
-- `RT/RT-XXX/meta.yaml`（RT 元数据）
-- `RT/RT-XXX/intake.md`（立项记录）
-- `RT/index.yaml`（全局索引更新）
-
-**协作方式**:
-- AI: 主动提出澄清问题，每个问题提供 2-5 个选项，给出推荐选项和理由
-- 用户: 选择推荐项或提供简短自定义答案（≤5 词），回答业务相关问题
-
----
-
-## 阶段 2: Decision（决策）
-
-**状态转换**: intaking → decided
-
-**主要任务**:
-- 根据 Intake 信息判断复杂度
-- 选择 Spec-Full 或 Spec-Lite profile
-- 创建 feature 分支（feature/RT-XXX-{short-name}）
-- 切换到 feature 分支并验证
-
-**阶段目标**: 确定开发模式，创建并切换到正确的 feature 分支
-
-**输出物**:
-- `RT/RT-XXX/decision.md`（决策记录，包含选择理由）
-- feature 分支（已创建并切换）
-
-**协作方式**:
-- AI: 分析复杂度，推荐 Profile（Full/Lite），解释推荐理由，创建分支
-- 用户: 确认推荐方案或显式切换 Profile，确认分支名
-
-**关键检查点**: 必须验证当前在 feature 分支上，严禁在 main/master 分支修改代码
-
-**CSF 审查（推荐）**: Decision 阶段完成后，建议执行 CSF 审查，验证 Profile 选择是否合理，目标与复杂度是否匹配。详见 `.aodw/01-core/csf-thinking-framework.md`
-
----
-
-## 阶段 3: Analysis（分析）
-
-**状态转换**: decided → in-progress
-
-**主要任务**:
-- 影响分析：识别直接/间接影响的模块、文件、功能
-- 不变量检查：列出必须保持不变的行为、接口、约束
-- 风险评估：数据损坏、安全、性能、用户体验风险
-
-**阶段目标**: 明确变更边界和约束条件，避免破坏现有功能
-
-**输出物**:
-- `RT/RT-XXX/impact.md`（影响分析）
-- `RT/RT-XXX/invariants.md`（不变量清单）
-
-**协作方式**:
-- AI: 主导分析，自动识别影响范围，列出不变量
-- 用户: 确认关键约束，补充业务层面的不变量
-
-**触发条件**: 在修改代码前必须完成此阶段
-
----
-
-## 阶段 4: Spec/Plan（规格/计划）
-
-**状态**: in-progress
-
-**主要任务**:
-
-**Spec-Full**:
-- 编写完整需求说明（spec.md）：背景、目标、用户故事、功能/非功能需求、成功标准
-- 编写技术实现方案（plan.md）：技术背景、方案概览、组件变更、代码结构与分层设计、数据流、风险缓解、分阶段计划
-- 编写数据模型文档（data-model.md，如涉及）
-- 编写契约文档（contracts/，如涉及）
-- 编写任务清单（tasks.md，按 User Story 和 Phase 拆分）
-- 编写质量检查清单（checklists/）
-
-**Spec-Lite**:
-- 编写精简需求说明（spec-lite.md）：背景、目标、当前/期望行为、影响范围
-- 编写精简技术方案（plan-lite.md）：修改点、方案描述、代码结构与分层设计、风险注意事项
-
-**阶段目标**: 明确"做什么"和"怎么做"，确保方案符合编码规范
-
-**输出物**:
-- Spec-Full: `spec.md`, `plan.md`, `data-model.md`, `contracts/`, `tasks.md`, `checklists/`
-- Spec-Lite: `spec-lite.md`, `plan-lite.md`
-
-**协作方式**:
-- AI: 基于 Intake 信息自动生成文档，确保符合编码规范（前端/后端）
-- 用户: 审阅 spec/plan，从业务视角确认方案合理性，批准执行计划
-
-**关键检查点**: Plan 完成后必须暂停，展示摘要，询问"计划已就绪，是否批准执行？"，严禁未获批准前开始修改代码
-
-**CSF 审查（必须）**: Plan 完成后，在进入"计划批准"节点前，**必须**执行 CSF 审查。审查重点：验证方案是否直接贡献于目标、分解是否 MECE、识别 CSF、检查端到端关键路径、评估技术方案合理性。详见 `.aodw/01-core/csf-thinking-framework.md`
-
----
-
-## 阶段 5: Implementation（实现）
-
-**状态**: in-progress
-
-**主要任务**:
-- 开发准备（Dev Ready）：
-  - 检查工具已初始化（.aodw/tools-status.yaml）
-  - 加载编码规范（前端/后端/通用）
-- 在 feature 分支上实现代码修改：
-  - 遵守项目编码规范
-  - 通过工具自动检查（ESLint/Ruff/Black）
-  - 符合 plan.md 中设计的代码结构与分层
-- 开发结束前自检：
-  - 运行 Lint 检查
-  - 运行格式化检查
-  - 验证文件大小和复杂度符合规范
-- 编写/更新测试文档（tests.md）
-- 更新变更日志（changelog.md）
-- 更新模块文档（如涉及）
-
-**阶段目标**: 实现功能，确保代码质量和规范符合性
-
-**输出物**:
-- 代码修改（在 feature 分支上）
-- `RT/RT-XXX/tests.md`（测试用例列表）
-- `RT/RT-XXX/changelog.md`（变更总结）
-- 模块 README 更新（如涉及）
-
-**协作方式**:
-- AI: 主导代码实现，自动运行检查工具，更新文档，维护 task.md（如需要）
-- 用户: 确认关键实现决策，验证功能是否符合预期
-
-**关键检查点**: 
-- 每次写代码前必须验证当前在 feature 分支
-- 提交代码前必须展示 git status 和关键 diff，询问"修改已完成，是否提交？"
-
----
-
-## 阶段 6: Verification（验证）
-
-**状态转换**: in-progress → reviewing
-
-**主要任务**:
-- 文档一致性检查：
-  - spec/plan 是否完整记录了问题→方案→实现过程
-  - impact/invariants/tests/changelog 是否完整
-  - 数据模型/接口变更是否已更新相关文档
-  - 模块文档是否已更新
-- RT 完整性检查：
-  - 核心文档是否齐全
-  - 过程文档是否在正确位置（RT/RT-XXX/docs/）
-  - meta.yaml 与 index.yaml 是否一致
-
-**阶段目标**: 确保 RT 文档完整、一致，符合 AODW 规范
-
-**输出物**:
-- 验证结果报告
-- 修正后的文档（如发现不一致）
-
-**协作方式**:
-- AI: 自动执行一致性检查，发现不一致时主动修正或提示
-- 用户: 确认验证结果，必要时补充信息
-
-**CSF 审查（推荐）**: Verification 阶段应执行 CSF 审查，不仅检查文档一致性，还要检查目标达成度、验证端到端关键路径、评估多维决策合理性。详见 `.aodw/01-core/csf-thinking-framework.md`
-
----
-
-## 阶段 7: Completion（完成）
-
-**状态转换**: reviewing → done
-
-**主要任务**:
-- 知识蒸馏（Knowledge Distillation）：
-  - 读取 modules-index.yaml，找到受影响的模块
-  - 更新对应的模块文档（docs/modules/*.md）
-  - 确认文档与代码一致
-- 提供完成脚本（AI 不得自动执行）：
-  - 确认在 feature 分支
-  - 确认所有改动已提交
-  - 切换到主分支并拉取最新代码
-  - 合并 feature 分支（--no-ff）
-  - 打标签（done-RT-XXX）
-  - 推送代码和标签
-  - 删除本地 feature 分支
-  - 更新 RT 状态为 done
-
-**阶段目标**: 完成代码合并，更新全局状态，确保知识库同步
-
-**输出物**:
-- 合并后的代码（在主分支）
-- `done-RT-XXX` 标签
-- 更新的模块文档
-- `RT/RT-XXX/meta.yaml`（status: done, closed_at）
-- `RT/index.yaml`（状态更新）
-
-**协作方式**:
-- AI: 执行知识蒸馏，提供完整的手动命令脚本，更新 RT 状态
-- 用户: 验证代码质量，验证文档更新，手动执行合并和推送脚本，验证推送结果
-
-**关键规则**: AI 禁止自动执行合并、推送、删除分支操作，必须提供脚本由用户手动执行
-
----
-
-## 状态机总览
-
-```
-created → intaking → decided → in-progress → reviewing → done
-  ↓         ↓          ↓           ↓            ↓         ↓
-Intake   Intake    Decision   Analysis/    Verification Completion
-                        Spec/Plan/
-                    Implementation
-```
-
-## 关键原则
-
-1. **分支管理**: 所有代码修改必须在 feature 分支上进行，严禁在 main/master 分支直接修改
-2. **文档同步**: 文档必须与代码保持同步，文档与代码不一致视为 Bug
-3. **选项化提问**: AI 所有关键问题应提供选项和推荐，用户只需选择
-4. **主动推进**: AI 应主动推进流程，不等待具体命令
-5. **工具无关**: 行为通过仓库文档约束，不依赖特定工具配置