# ai_demo

**Repository Path**: Lc0928/ai_demo

## Basic Information

- **Project Name**: ai_demo
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-14
- **Last Updated**: 2026-05-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🚀 研发范式演进：基于特征域解耦的 AI 自动化自进化研发生态 (SDD)

---

## 🛑 一、 什么是 SDD？它与传统模式及我们之前的现状有什么区别？

**SDD（Spec-Driven Development，规格说明驱动开发）** 是一种将**“技术规格（Specification）”**作为唯一信任源（Single Source of Truth）的开发模式。在 AI 时代，它是人机协同的最高工业标准。

为了让大家看清代差，我们将**正统 SDD**、**我们团队之前的痛点现状**，以及**我们通过这套架构优化后的终极形态**进行三维对比：


| 维度 | ❌ 我们之前的现状（痛点） | 🎯 正统 SDD 核心理念 | 💎 我们优化后的自进化形态（亮点） |
| :--- | :--- | :--- | :--- |
| **沟通流转** | 依赖产品口头通知、飞书文档、Figma 截图分散在各处。AI 盲人摸象，甚至**拍脑袋瞎编错包名（如 com.lean）**。 | 需求必须先变成严谨的技术规格书（`spec.md`），明确定义 Record、DDL、包路径，锁死契约再编码。 | **网关自动无监督转译**。输入大白话或云效单，AI 自动结合历史漏洞全自动生成图纸，研发零打扰。 |
| **任务拆解** | 需求颗粒度过大。多人同时让 AI 改同一个文件，合并主干（master）时发生严重的 **Git 代码冲突**。 | 将锁定的规格书拆解为时间跨度在 1 小时以内的**原子任务（Task）**，物理限制改动文件不超 3 个。 | **一键领单分支联动**（`make start-task`）。看板自动勾选状态，本地自动切安全隔离特性分支，防抢单。 |
| **质量验收** | 本地 Commit 仅靠手工测试或只跑单元测试（`mvn test`）。**单测可以通过，但前后端字段命名经常对不上**。 | CI/CD 引入黑盒集成测试。测试 AI 只读规格书，对真实 HTTP 接口发起并发压力测试与断言审查。 | **双层自愈合卡口**。提交前自动静态扫描 `System.out` 等高并发禁忌；验收失败触发 AI 自动修包，3次自熔断。 |
| **知识进化** | 生产环境发生 Bug 或线上事故，复盘完写进 Wiki 变成无人问津的死文档，下次换个开发继续踩雷。 | 规约是静态的。团队技术宪法（`.ai_rules`）会随着架构调整由架构师手动去更新、增减。 | **三维立体知识库自增殖**。Bug 修复成功后，流水线逆向提炼技术禁忌，**自动追加进 .ai_rules 底部，AI 越用越聪明**。 |

---

## 🏗️ 二、 核心解耦架构：三维立体知识库

为了防止知识库随着项目演进迅速膨胀，导致 AI 产生“长文本注意力稀释”与幻觉，我们对知识库进行了**动静分离、按需挂载**的重构：

*   **纵向：局部短期内存（`docs/domains/`）**：按业务模块隔离（如广告过滤、流式计费）。一个文件夹就是一个完整的特性战场。AI 研发时眼睛里看不见任何其他模块的干扰噪音，Token 消耗降低 80%。
*   **横向：组件规约库（`docs/components/`）**：沉淀跨模块的通用高并发铁律（如：Redis 分布式锁规范、虚拟线程隔离规约）。
*   **时间线：线上事故警示录（`docs/accidents/`）**：将历史惨痛教训结构化文件化。AI 每次生成新图纸，都会自动在脑子里把事故过一遍，**天然具备免疫力，从物理上杜绝“在同一个坑里摔倒两次”**。

---

## 🏃 三、 研发场景分流“方向盘选择”的物理卡口优化

为了防止开发人员手抖、或者 AI 产生“讨好人类的本能”直接去盲改系统骨骼，我们在 `.ai_rules` 最顶层用 **英文 imperative 语法和强约束 XML 标签** 焊死了物理卡口。同时在 `Makefile` 层面配置了防绕过拦截器：

*   **如果有人（或 AI）在大功能下尝试通过口白直接去写源码**：IDE 底层的系统级拦截会瞬间红牌封杀，强行弹出：`🚨 [Red Card] Violation of Spec-Driven pipeline. Please run 'make init-feature ad_filter' first.` 终止任务。
*   **如果是表皮文字微调**：允许走免检通道，运行 `make quick-fix`，AI 拿着大白话 10 秒钟内自主执行源码抠字替换，自动走完单测由 Git Hook 智能生成规范日志完成提交。

---

## ⚖️ 五、 优缺点客观分析与大厂级预案

### 💎 我们这套优化形态的顶级优点
1.  **效能降维打击**：全员脱离了“查文件路径、手写格式化 Commit、查低级 NPE、手写重复单测”等初级苦力。开发周期缩短至小时级，一人可轻松指挥 3 个模块并行。
2.  **新人磨合期归零**：新员工入职，无论用免费的 Trae 还是付费的 Cursor，拉取代码的瞬间，本地 AI 就会被我们这套事故库锤炼出来的规约完全约束，团队再无烂代码坏味道。
3.  **零无谓文档垃圾**：不搞教条主义。变更与 Bug 被拆写为了轻量级的“补丁包文件（Patch Files）”，人类只需往对应文件夹丢几行白话，AI 负责用强悍的算力在后台融合成最新的技术图纸与自检项。

### ⚠️ 潜在缺点与攻坚预案
*   **缺点 1：小模型算力下存在断言解析格式错误**
    *   *💡 预案*：**大脑动静隔离**。日常补全（`exec-task`）调用内网低参数大模型提高响应；而关键性的卡口（`validate-spec` 图纸审计、`router_agent.py` 网关分流）**强行指定路由调用海外最高级别的 Claude 3.5 或是国内顶级的 DeepSeek-R1 接口**，用高价值算力为架构把关。
*   **缺点 2：高频并发合并导致局部代码行冲突**
    *   *💡 预案*：**原子化任务短平快**。团队推行任务颗粒度卡口，一个分支的开发耗时严格控制在 2 小时以内。在代码合并主干（Post-Merge）之后，**流水线自动触发运行 `make sync-arch` 技能**。AI 会自动扫描代码 Diff，逆向同步升级 `docs/ARCHITECTURE.md`，让下一位领单的同学拉到的永远是热乎的、最新的全局应用拓扑，从根源规避架构冲突。

---

## 🚀 六、 现场演示 Demo 脚本（2分钟惊艳全场）

“各位同学，今天我想跟大家分享的不是如何用 AI 帮我们写个快排。今天我想展示的是，**我们如何通过一套模块化特性域文件和 14 个本地物理技能脚本，把公司过去积攒的线上故障变成 AI 助理的硬免疫，打造一个完全‘无人驾驶、契约锁死、自动诊断修复、知识库自我增殖演进’的代码智能工厂**。下面我将用 2 分钟在本地现场演示，从零产品大白话、到一行代码不写安全上线并物理销毁特性分支的全过程……”