@chongyan/autospec 1.0.1

package/knowledge/process/ai-sdlc.md

@@ -0,0 +1,475 @@
+# AI-Enhanced SDLC 规范
+
+> 本文档定义 AI Native 团队在软件开发生命周期（SDLC）中如何利用 AI 增强各阶段效率。
+> 与 `knowledge/process/overview.md` 互补，基础流程规范在此同样生效。
+
+## 概述
+
+AI-Enhanced SDLC 是对传统 6 阶段流程的 AI 增强：
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                    AI-Enhanced SDLC                                     │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                         │
+│  Planning    Design    Coding    Review    Testing    Delivery         │
+│     │          │         │         │         │           │            │
+│     ▼          ▼         ▼         ▼         ▼           ▼            │
+│  ┌─────┐   ┌─────┐   ┌─────┐   ┌─────┐   ┌─────┐    ┌─────┐         │
+│  │AI   │   │AI   │   │AI   │   │AI   │   │AI   │    │AI   │         │
+│  │辅助 │   │辅助 │   │结对 │   │审查 │   │生成 │    │评估 │         │
+│  └─────┘   └─────┘   └─────┘   └─────┘   └─────┘    └─────┘         │
+│                                                                         │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+**核心转变**：
+- 从"人写代码，AI 辅助"到"人定需求，AI 实现"
+- 从"人审查代码"到"AI 预审 + 人最终确认"
+- 从"人写测试"到"AI 生成测试 + 人验收"
+
+---
+
+## 1. Planning 阶段 AI 增强
+
+### 1.1 AI 辅助需求澄清
+
+**输入**：原始需求描述
+**输出**：结构化需求文档
+
+**AI 增强点**：
+
+| 环节 | AI 能力 | 输出 |
+|------|---------|------|
+| 11维扫描 | 自动分析需求完整性 | 缺失维度列表 |
+| 歧义识别 | 检测表述模糊处 | 澄清问题列表 |
+| 竞品分析 | 搜索类似产品功能 | 竞品参考 |
+| 边界条件 | 推导边界和异常场景 | 边界条件清单 |
+
+**执行流程**：
+
+```
+原始需求
+    ↓
+AI 11维扫描 → 缺失维度
+    ↓
+AI 歧义识别 → 澄清问题
+    ↓
+人类澄清
+    ↓
+结构化需求文档
+```
+
+### 1.2 AI 辅助估算
+
+**AI 估算维度**：
+
+| 维度 | AI 能力 | 数据来源 |
+|------|--------|---------|
+| 工作量 | 基于历史项目估算 | 项目数据库 |
+| 复杂度 | 代码复杂度分析 | 需求文本 |
+| 风险 | 风险因素识别 | 需求 + 历史 |
+| 依赖 | 依赖分析 | 需求关系图 |
+
+**估算输出**：
+
+```markdown
+## 估算结果
+
+### 工作量
+- 乐观：3 人日
+- 基准：5 人日
+- 悲观：8 人日
+
+### 复杂度
+- 功能复杂度：中
+- 技术复杂度：中
+- AI 依赖度：高
+
+### 风险点
+- [ ] 第三方 API 不稳定
+- [ ] 性能要求可能需要优化
+```
+
+### 1.3 AI 辅助优先级排序
+
+**排序维度**：
+
+| 维度 | 权重 | AI 分析 |
+|------|------|---------|
+| 商业价值 | 30% | 需求价值评估 |
+| 实现成本 | 25% | 估算结果 |
+| 依赖关系 | 20% | 依赖图分析 |
+| 风险 | 15% | 风险评估 |
+| 用户需求 | 10% | 用户反馈 |
+
+---
+
+## 2. Design 阶段 AI 增强
+
+### 2.1 AI 辅助架构设计
+
+**AI 架构助手能力**：
+
+| 能力 | 描述 | 输出 |
+|------|------|------|
+| 架构草图 | 根据需求生成架构草案 | 架构图 + 说明 |
+| 方案对比 | 生成多方案供选择 | 方案对比表 |
+| 技术选型 | 推荐技术栈 | 选型建议 + 理由 |
+| 风险识别 | 识别架构风险 | 风险清单 |
+
+**执行流程**：
+
+```
+需求文档
+    ↓
+AI 架构草图生成（3个方案）
+    ↓
+人类选择/调整
+    ↓
+AI 详细设计
+    ↓
+架构评审
+```
+
+### 2.2 AI 辅助 API 设计
+
+**AI API 设计能力**：
+
+| 能力 | 描述 |
+|------|------|
+| RESTful 推导 | 从业务需求推导 API 端点 |
+| 参数建议 | 自动建议请求/响应参数 |
+| 错误码设计 | 生成错误码规范 |
+| 文档生成 | 自动生成 API 文档 |
+
+**示例**：
+
+```
+输入：订单管理需求
+输出：
+- GET /api/orders - 订单列表
+- GET /api/orders/:id - 订单详情
+- POST /api/orders - 创建订单
+- PUT /api/orders/:id - 更新订单
+- DELETE /api/orders/:id - 删除订单
+```
+
+### 2.3 AI 辅助数据库设计
+
+**AI 数据库设计能力**：
+
+| 能力 | 描述 |
+|------|------|
+| ER 图推导 | 从需求推导实体关系 |
+| 表结构建议 | 生成表结构设计 |
+| 索引建议 | 推荐索引策略 |
+| 迁移脚本 | 生成 DDL 脚本 |
+
+---
+
+## 3. Coding 阶段 AI 增强
+
+### 3.1 Vibe Coding 模式
+
+**适用场景**：
+
+| 场景 | 适用度 |
+|------|--------|
+| CRUD 页面 | ★★★★★ |
+| API 实现 | ★★★★★ |
+| 测试用例 | ★★★★★ |
+| 文档生成 | ★★★★★ |
+| 复杂业务逻辑 | ★★☆☆☆ |
+| 全新架构 | ★☆☆☆☆ |
+
+**Vibe Coding 流程**：
+
+```
+1. 需求描述（自然语言）
+       ↓
+2. AI 代码生成
+       ↓
+3. 人类验收
+       ↓
+     ├── 通过 → 提交
+     └── 不通过 → 反馈修正 → 2
+```
+
+**提示词技巧**：
+
+```markdown
+# 好的提示词示例
+
+"实现用户登录功能：
+- 用户名/邮箱 + 密码登录
+- 记住我选项（7天有效）
+- 登录失败5次锁定15分钟
+- 返回 JWT token
+
+参考现有代码风格：src/auth/*.ts"
+```
+
+### 3.2 AI 结对编程
+
+**协作模式**：
+
+| 模式 | 人类职责 | AI 职责 |
+|------|---------|---------|
+| 人类设计 + AI 实现 | 架构、核心逻辑 | 填充实现 |
+| 人类 + AI 并行 | 主流程实现 | 边界处理、测试 |
+| AI 实现 + 人类审查 | 验收、决策 | 代码生成 |
+
+**执行流程**：
+
+```
+人类工程师
+    │
+    ├──→ 任务描述（包含上下文）
+    │         ↓
+    ←── 代码实现 ←── AI Developer Agent
+    │
+    ├──→ 审查反馈（可选多轮）
+    │         ↓
+    ←── 修订版 ←── AI Developer Agent
+    │
+    └──→ 最终验收 → 提交
+```
+
+### 3.3 AI 文档生成
+
+**AI 可生成的文档**：
+
+| 文档类型 | AI 能力 | 质量评估 |
+|---------|--------|---------|
+| README | 基于代码生成 | 高 |
+| API 文档 | 基于代码/注释 | 高 |
+| 变更日志 | 基于 git diff | 中 |
+| 内联注释 | 基于代码逻辑 | 中 |
+
+---
+
+## 4. Review 阶段 AI 增强
+
+### 4.1 多代理并行审查
+
+**审查 Agent 架构**：
+
+```
+┌─────────────────────────────────────────┐
+│         Code Review Pipeline            │
+├─────────────────────────────────────────┤
+│                                         │
+│  并行启动：                              │
+│  ┌─────────┐ ┌─────────┐ ┌─────────┐  │
+│  │架构审查  │ │安全审查  │ │性能审查  │  │
+│  │  Agent  │ │  Agent  │ │  Agent  │  │
+│  └────┬────┘ └────┬────┘ └────┬────┘  │
+│       │           │           │        │
+│       └───────────┼───────────┘        │
+│                   ▼                     │
+│            ┌────────────┐               │
+│            │ 结果汇总  │               │
+│            └─────┬──────┘               │
+│                  ▼                      │
+│            ┌────────────┐               │
+│            │ 人类确认   │               │
+│            └────────────┘               │
+│                                         │
+└─────────────────────────────────────────┘
+```
+
+### 4.2 AI 审查清单
+
+| 维度 | 检查项 | AI 能力 |
+|------|--------|---------|
+| 逻辑 | 业务逻辑正确性 | ★★★★☆ |
+| 安全 | 注入、越权、敏感数据 | ★★★★★ |
+| 性能 | 复杂度、N+1、缓存 | ★★★☆☆ |
+| 可维护性 | 代码重复、命名、注释 | ★★★★☆ |
+| 规范 | 编码规范、风格 | ★★★★★ |
+
+### 4.3 审查结果处理
+
+| 结果类型 | 处理方式 |
+|---------|---------|
+| 致命问题 | 阻止提交，必须修复 |
+| 建议问题 | 记录，提交时可选修复 |
+| 风格问题 | 自动修复（lint） |
+
+---
+
+## 5. Testing 阶段 AI 增强
+
+### 5.1 AI 测试生成
+
+**AI 测试生成能力**：
+
+| 测试类型 | AI 能力 | 示例 |
+|---------|--------|------|
+| 单元测试 | 基于代码生成 | 函数级测试 |
+| 集成测试 | 基于 API 设计 | 端到端测试 |
+| 边界测试 | 边界条件推导 | 异常场景 |
+| 回归测试 | 变更分析 | 影响范围 |
+
+**执行流程**：
+
+```
+代码实现
+    ↓
+AI 测试生成（覆盖度目标：80%）
+    ↓
+人类审查测试质量
+    ↓
+     ├── 通过 → 执行测试
+     └── 不通过 → 补充/修正 → AI 重新生成
+```
+
+### 5.2 AI 测试覆盖分析
+
+**覆盖度指标**：
+
+| 指标 | 目标 | AI 分析 |
+|------|------|---------|
+| 行覆盖 | > 80% | 缺失行定位 |
+| 分支覆盖 | > 70% | 缺失分支定位 |
+| 函数覆盖 | > 90% | 未测函数定位 |
+
+### 5.3 AI 异常检测
+
+**AI 异常检测能力**：
+
+| 能力 | 描述 |
+|------|------|
+| 日志分析 | 异常模式识别 |
+| 根因分析 | 异常原因推导 |
+| 修复建议 | 自动生成修复方案 |
+
+---
+
+## 6. Deployment 阶段 AI 增强
+
+### 6.1 AI 部署风险评估
+
+**风险评估维度**：
+
+| 维度 | AI 分析 | 输出 |
+|------|--------|------|
+| 变更风险 | 代码变更分析 | 风险等级 |
+| 依赖风险 | 依赖变更检测 | 冲突预警 |
+| 配置风险 | 配置变更检查 | 配置问题 |
+| 回滚方案 | 自动生成回滚脚本 | 回滚方案 |
+
+### 6.2 AI 监控配置
+
+**AI 监控建议**：
+
+| 监控项 | AI 建议 |
+|--------|---------|
+| 关键指标 | 基于业务推荐 |
+| 告警阈值 | 基于历史数据 |
+| 日志级别 | 基于代码分析 |
+
+### 6.3 AI 异常检测
+
+**运行时 AI 监控**：
+
+| 能力 | 描述 |
+|------|------|
+| 异常预测 | 基于历史模式预测 |
+| 根因定位 | 异常根因分析 |
+| 修复建议 | 自动生成修复建议 |
+
+---
+
+## 与现有流程集成
+
+### 与双层验证的集成
+
+| 验证层 | AI 增强 |
+|--------|---------|
+| Layer 1 | AI 辅助的自动化测试 + lint |
+| Layer 2 | 多代理 AI 审查 |
+
+### 与做审分离的集成
+
+- AI 审查 Agent 独立执行（通过 Agent 工具）
+- 人类最终确认
+- 审查结果记录可追溯
+
+### 与宪法红线的集成
+
+- AI 产出同样受宪法约束
+- 安全相关决策人类主导
+- 不可逆动作仍需人工确认
+
+---
+
+## 配置开关
+
+### 启用/禁用 AI 增强
+
+```yaml
+# config.yaml
+ai_enhanced:
+  enabled: true
+
+  planning:
+    enabled: true
+    estimation: true
+    prioritization: true
+
+  design:
+    enabled: true
+    architecture: true
+    api: true
+    database: true
+
+  coding:
+    enabled: true
+    vibe_coding: false    # 可选模式
+    pair_programming: true
+    doc_generation: true
+
+  review:
+    enabled: true
+    multi_agent: true
+    auto_fix: true
+
+  testing:
+    enabled: true
+    test_generation: true
+    coverage_analysis: true
+
+  deployment:
+    enabled: true
+    risk_assessment: true
+    monitoring: true
+```
+
+---
+
+## 最佳实践
+
+### 1. 选择合适的 AI 增强模式
+
+| 场景 | 推荐模式 |
+|------|---------|
+| 快速 MVP | Vibe Coding |
+| 复杂系统 | AI 结对编程 |
+| 高安全要求 | 多代理审查 |
+| 遗留代码 | AI 测试生成 |
+
+### 2. AI 产出验收
+
+- [ ] 功能完整
+- [ ] 边界条件处理
+- [ ] 性能合理
+- [ ] 安全合规
+- [ ] 代码风格一致
+
+### 3. 持续优化
+
+- 记录 AI 产出质量
+- 迭代提示词
+- 优化工作流