@chongyan/autospec 1.0.2 → 1.0.3

package/knowledge/03-guides/43-run-ai-sdlc.md

@@ -1,475 +0,0 @@
-# AI-Enhanced SDLC 规范
-
-> 本文档定义 AI Native 团队在软件开发生命周期（SDLC）中如何利用 AI 增强各阶段效率。
-> 与 `knowledge/02-process/00-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 产出质量
-- 迭代提示词
-- 优化工作流