From 6c6929615a6304b6bc4e938228877a0af05ef80e Mon Sep 17 00:00:00 2001 From: Zane <1638944816@qq.com> Date: Mon, 1 Jun 2026 20:58:30 +0800 Subject: [PATCH] =?UTF-8?q?=E5=90=8C=E6=AD=A5=E6=9C=80=E6=96=B0=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...›¢é˜Ÿçº§ AI 编程驾驭工程_BV1SZoXBkErT_笔记.md | 352 ++++++++++++++++++ ... ¼é©±åЍè½åœ°_文档管ç†ç­–ç•¥_BV1mZV76eEPC_笔记.md | 177 +++++++++ ...ï¼šä¸šåŠ¡éœ€æ±‚å‡ºç æœ€ä½³å®žè·µã€å¤©çŒ«AI Coding实践系列】.md | 0 ...ï¼šä¸šåŠ¡éœ€æ±‚å‡ºç æœ€ä½³å®žè·µã€å¤©çŒ«AI Coding实践系列】.md | 0 InBox/v2ex_1196441_大模型å˜ç¬¨è®¨è®º.md | 36 -- InBox/zhihu_article_2028819446546932894.md | 17 - 6 files changed, 529 insertions(+), 53 deletions(-) create mode 100644 3Resources/AI/2026-04-25 Harness for AI coding 团队级 AI 编程驾驭工程_BV1SZoXBkErT_笔记.md create mode 100644 3Resources/AI/2026-05-30 SDD 规格驱动è½åœ°_文档管ç†ç­–ç•¥_BV1mZV76eEPC_笔记.md rename InBox/glue-coding-tmall-ai-practice-2026-03-27.md => 3Resources/AI/97.9%é‡‡çº³çŽ‡ï¼Œèƒ¶æ°´ç¼–ç¨‹ï¼šä¸šåŠ¡éœ€æ±‚å‡ºç æœ€ä½³å®žè·µã€å¤©çŒ«AI Coding实践系列】.md (100%) delete mode 100644 97.9%é‡‡çº³çŽ‡ï¼Œèƒ¶æ°´ç¼–ç¨‹ï¼šä¸šåŠ¡éœ€æ±‚å‡ºç æœ€ä½³å®žè·µã€å¤©çŒ«AI Coding实践系列】.md delete mode 100644 InBox/v2ex_1196441_大模型å˜ç¬¨è®¨è®º.md delete mode 100644 InBox/zhihu_article_2028819446546932894.md diff --git a/3Resources/AI/2026-04-25 Harness for AI coding 团队级 AI 编程驾驭工程_BV1SZoXBkErT_笔记.md b/3Resources/AI/2026-04-25 Harness for AI coding 团队级 AI 编程驾驭工程_BV1SZoXBkErT_笔记.md new file mode 100644 index 0000000..cb0b694 --- /dev/null +++ b/3Resources/AI/2026-04-25 Harness for AI coding 团队级 AI 编程驾驭工程_BV1SZoXBkErT_笔记.md @@ -0,0 +1,352 @@ +# æ•æ·å›¢é˜Ÿ AI 编程驾驭工程体系 + +## 一ã€èƒŒæ™¯ä¸Žæ ¸å¿ƒé—®é¢˜ + +### 1.1 为什么需è¦å›¢é˜Ÿçº§ AI 编程体系 + +å½“å‰ AI 编程工具(如 SuperPoweã€Claude Codeã€Cursor 等)已ç»éžå¸¸å¼ºå¤§ï¼Œä½†**在团队级ã€é¡¹ç›®çº§åœºæ™¯ä¸‹è½åœ°å›°éš¾**。核心原因是: + +- **需求衔接问题**:产å“ç»ç†/BA 给的需求格å¼ä¸ç»Ÿä¸€ï¼Œé¢—粒度ä¸ä¸€è‡´ï¼Œå¯¼è‡´ AI 无法有效ç†è§£ +- **å¼€å‘实践问题**:多人å作时,AI 生æˆçš„代ç é£Žæ ¼ä¸ç»Ÿä¸€ã€éš¾ä»¥å½¢æˆä¸€è‡´çš„æ•´ä½“ +- **å·¥å…·ç”Ÿæ€æ··ä¹±**:Claude Codeã€Cursorã€windsurfã€SuperPower 等工具差异大,没有统一标准 +- **æµç¨‹ä¸Žåˆ¶åº¦é—®é¢˜**:团队工作习惯难以改å˜ï¼Œè¿™æ˜¯æœ€å¤§çš„é˜»åŠ›æ¥æº + +### 1.2 当å‰å›¢é˜Ÿä½¿ç”¨ AI 编程的认知分级 + +æ ¹æ®å¼€å‘者能力分层: + +| 级别 | æè¿° | 典型行为 | +|------|------|----------| +| åˆçº§å¼€å‘者 | 照猫画虎,ä¸çŸ¥é“系统如何工作 | 抄代ç ã€å†™ä¸šåŠ¡é€»è¾‘ï¼Œè¢« AI 替代 | +| 专家型开å‘者 | åšæŠ€æœ¯å…¬å…³ï¼Œå¤æ‚ç»„ä»¶å¼€å‘ | ä»éœ€è¦ï¼Œä½† AI å¯è¾…助 | +| 架构型开å‘者 | 设计æœåŠ¡ã€åšæƒè¡¡å†³ç­– | AI 辅助设计,但è¦äººå·¥æŠŠå…³ | +| 技术ç»ç†/CTO | 处ç†å¤æ‚混乱的问题 | 构建团队 AI 工作体系 | + +> **关键洞察**:"è¿™ä¸ªçŽ©å…·ä¸æ˜¯çŽ© AI,是玩人"——真正的挑战ä¸åœ¨äºŽ AI 能力,而在于如何让团队按照统一的方å¼å·¥ä½œã€‚ + +### 1.3 AI 辅助软件工程全æµç¨‹å›¾ + +``` +éœ€æ±‚åˆ†æž â†’ 技术方案设计 → 代ç ç¼–写 → Code Review → 测试 → 部署 → 生产 Bug ä¿®å¤ + ↓ ↓ ↓ ↓ ↓ ↓ ↓ + 录音转文档 打样工程 API/å•元测试 äº¤å‰æ¨¡åž‹ E2E测试 K8S部署 MCP自动 + è®¿è°ˆçºªè¦ ä»£ç æ¨¡æ¿ TDD 循环 Review Playwright 触å‘åˆå¹¶ å‘通知 + 需求文档 技术规范 + 原型链接 +``` + +## 二ã€éœ€æ±‚阶段:如何让需求 AI å‹å¥½ + +### 2.1 需求规格模æ¿å¿…须包å«çš„内容 + +BA 或产å“ç»ç†ç»™çš„需求文档必须包å«ä»¥ä¸‹ 4 个关键部分: + +1. **业务背景**:为什么åšè¿™ä¸ªéœ€æ±‚ +2. **字段清å•**:所有业务字段的类型ã€é»˜è®¤å€¼ã€ä¸šåŠ¡è§„åˆ™ï¼ˆé¿å…åªç»™åŽŸåž‹å›¾è®© AI 去猜) +3. **原型链接**:Figma 图等设计稿的链接(AI å¯é€šè¿‡ MCP è¯»å– Figma) +4. **业务规则**ï¼šæŒ‰æ¡æ‹†åˆ†ï¼Œä¾‹å¦‚: + - 订å•å·ç”Ÿæˆè§„则 + - å‘货规则 + - 状æ€è½¬æ¢è§„则 + +### 2.2 需求颗粒度的判断标准 + +**ä¸è¦ç”¨ Story 拆分需求**ï¼ˆä¸€ä¸ªäººå¢žäº§æ”¹æŸ¥æ‹†æˆ 4 个 story 对 AI æ¥è¯´ä¿¡æ¯é‡ä¸å¤Ÿï¼‰ã€‚ + +æ­£ç¡®åšæ³•:**一个模å—一个文档**,判断颗粒度的标准是: +- æ˜¯å¦æœ‰ç‹¬ç«‹çš„表结构 +- 是å¦å¯ä»¥å•独上线 + +### 2.3 新建需求 vs å˜æ›´éœ€æ±‚ + +**新建需求**:告诉 AI 有多少表ã€å¤šå°‘页é¢ã€å¤šå°‘功能æ“作 → AI 生æˆå®Œæ•´æ¨¡å— + +**å˜æ›´éœ€æ±‚**(é‡è¦ï¼‰ï¼š +- å¿…é¡»ç”¨æ ‡ç­¾æ ‡æ³¨å˜æ›´ç±»åž‹ï¼š`[+字段]` `[-字段]` `[修改字段]` +- ä¸è¦æŠŠæœ€ç»ˆå®Œæ•´çжæ€ç»™ AI,因为 AI 需è¦å¯¹æ¯”çŽ°æœ‰ä»£ç  â†’ æµªè´¹å¤§é‡ Token 且效果差 +- 示例: + +```markdown +# è®¢å•æ¨¡å—å˜æ›´éœ€æ±‚ + +## 新增内容 [+] +- 新增字段:order_type(订å•类型,枚举值:NORMAL, VIP, B2B) + +## 修改内容 [~] +- 修改字段:shipping_address 最大长度从 200 改为 500 + +## 删除内容 [-] +- 删除字段:legacy_flag(已废弃) +``` + +### 2.4 用 Obsidian æ­å»ºçŸ¥è¯†åº“ç»™ AI åšä¸Šä¸‹æ–‡ + +å°†æ‰€æœ‰éœ€æ±‚è§„æ ¼ã€æŠ€æœ¯è§„æ ¼éƒ½æ”¾åˆ°çŸ¥è¯†åº“ä¸­ï¼Œç”¨ Obsidian + Markdown 管ç†ï¼š + +- 用æµè§ˆå™¨æ’ä»¶ä¸€é”®å°†ç½‘é¡µè½¬æˆ Markdown å¹¶ä¿å­˜å›¾ç‰‡æœ¬åœ° +- 用 backlink 功能åšä¸Šä¸‹æ–‡å…³è” +- AI 通过读å–这个知识库获得长期记忆 → "Single source of truth" + +## ä¸‰ã€æŠ€æœ¯è§„æ ¼é˜¶æ®µï¼šæŠ€æœ¯æ–¹æ¡ˆè®¾è®¡ + +### 3.1 技术规格必须包å«çš„内容 + +技术规格是开å‘的核心输入,必须包å«ä»¥ä¸‹ 5 个部分: + +| 内容 | 工具/æ ¼å¼ | 说明 | +|------|----------|------| +| 领域模型 | PlantUML / Mermaid | 代ç åŒ–表达,便于 AI ç†è§£ | +| æ•°æ®åº“设计 | DBML / Flyway 脚本 | ä¸è¦è®© AI 直接æ“作数æ®åº“,用版本化的 Flyway 脚本 | +| API 定义 | OpenAPI / Markdown | åŽç«¯å†™å®Œ API åŽè¾“出 API 文档给å‰ç«¯ | +| æ—¶åºå›¾ | Mermaid | 夿‚æµç¨‹éœ€è¦æ—¶åºå›¾ | +| 专项设计 | Markdown | æƒé™ã€äº‹åŠ¡ã€ç¼“存等专项内容 | + +> **é‡è¦æ•™è®­**:ä¸è¦ç»™ AI 写数æ®åº“的写æƒé™ï¼Œæ›¾ç»å› ä¸º AI 动ä¸åŠ¨ä¿®æ”¹æ•°æ®åº“导致多人æ“作冲çªã€‚把写æƒé™å…³æŽ‰ï¼Œè®© AI ç”Ÿæˆ Flyway 脚本,本地测试时让 Flyway 跑。 + +### 3.2 DSL 驱动的技术规格 + +用领域特定语言(DSL)æ¥é©±åŠ¨æŠ€æœ¯è§„æ ¼ï¼š +- 领域模型用 PlantUML +- æ•°æ®åº“用 DBML +- API 用 OpenAPI +- 这些 DSL 都å¯ä»¥é€šè¿‡ä»£ç ç”Ÿæˆ → ä¿è¯å‰åŽç«¯ä¸€è‡´æ€§ + +> 这实际上就是模型驱动架构(Model-Driven Architecture),当团队从零开始全新的 AI 项目时,这ç§ä¸¥æ ¼çš„æ£€æŸ¥å’Œçº¦æŸæ›´å®¹æ˜“建立。 + +## å››ã€æ‰“样工程:AI å‹å¥½çš„ä»£ç æ¡†æž¶ + +### 4.1 什么是打样工程 + +打样工程(Seed Projectï¼‰æ˜¯ä¸€ä¸ªé¢„å…ˆå®šä¹‰å¥½çš„ä»£ç æ¡†æž¶æ¨¡æ¿ï¼ŒåŒ…å«ï¼š +- æ¯å±‚的类åå’ŒèŒè´£å®šä¹‰ +- 代ç è§„范和最佳实践 +- ä¾èµ–é…置和目录结构 + +### 4.2 打样工程的作用 + +1. **AI 生æˆä»£ç é£Žæ ¼ä¸€è‡´**:所有 AI 都基于åŒä¸€ä¸ªæ¡†æž¶ç”Ÿæˆä»£ç  +2. **å‡å°‘é‡å¤ä»£ç **:AI 会å¤ç”¨æ¡†æž¶ä¸­çš„ç»„ä»¶è€Œä¸æ˜¯é‡å¤å†™ +3. **é™ä½Žè®¤çŸ¥è´Ÿæ‹…**:AI ä¸éœ€è¦æ¯æ¬¡ç†è§£é¡¹ç›®ç»“æž„ + +### 4.3 如何创建打样工程 + +1. 从旧项目中蒸é¦å‡ºä¸€ä¸ªå¹²å‡€çš„æ–°é¡¹ç›®éª¨æž¶ +2. 定义æ¯å±‚èŒè´£ï¼š`Controller → Service → Repository → Entity` +3. 定义类命å规范和包结构 +4. 放入 Git 仓库供团队共享 + +## 五ã€å¼€å‘阶段:让 AI å¬è¯å†™å‡ºç»Ÿä¸€é£Žæ ¼çš„ä»£ç  + +### 5.1 用 RAG(检索增强生æˆï¼‰æä¾›ä¸Šä¸‹æ–‡ + +将技术规格ã€ä»£ç è§„范ã€åކå²å†³ç­–ç­‰ä¿¡æ¯æ”¾åˆ°ä»£ç ä»“库的 `/docs` 或 `/book` 目录下,AI 通过检索这些文档获得上下文: + +```markdown +/my-project + /book + /requirements # 需求规格 + /specifications # 技术规格 + /api-docs # API 文档 + /src + /skills + /mcp +``` + +### 5.2 å¤šä»»åŠ¡åŒæ­¥å¼€å‘:Worktree 的使用 + +Git Worktree å¯ä»¥æŠŠåˆ†æ”¯æ˜ å°„æˆç›®å½•,实现多任务并行: + +```bash +# 创建多个工作目录 +git worktree add ../feature-order feature/order +git worktree add ../feature-user feature/user + +# 在ä¸åŒç›®å½•ä¸‹åŒæ—¶å·¥ä½œï¼Œåšå®ŒåŽåˆå¹¶ +``` + +**ä½†è¦æ³¨æ„**: +- å¤šäººåŒæ—¶æ“作多人工作时,版本管ç†ä¼šæ¯”较痛苦 +- 建议æå‰æŠŠè§„格设计好,让 AI æ…¢æ…¢è·‘ï¼Œè€Œä¸æ˜¯åŒæ—¶å¼€å¤ªå¤šä»»åŠ¡ + +### 5.3 ä¸è¦è®© AI 边写代ç è¾¹åšè®¾è®¡ + +用 `rapper5` çš„æ€è·¯ï¼š**Discovery/Design å’Œ Coding 分两个阶段**。 +- å…ˆåšæŽ¢ç´¢æ€§è®¾è®¡ï¼Œè®©ä¸åŒ AI 模型(GPTã€Claudeã€Gemini)å„自给出方案 +- 选定方案åŽï¼Œå†æ¿€æ´» Coding 角色专èŒå†™ä»£ç  +- 切æ¢è§’色时é‡ç½®ä¸Šä¸‹æ–‡ï¼Œé¿å… AI 注æ„力分散 + +## å…­ã€æµ‹è¯•阶段:AI 写代ç å½¢æˆé—­çŽ¯çš„æ ¸å¿ƒ + +### 6.1 为什么测试是 AI 编程的命脉 + +> "没有 API 测试和å•å…ƒæµ‹è¯•ï¼Œæ— æ³•å½¢æˆ AI 写代ç çš„闭环。" + +AI 生æˆä»£ç åŽå¿…须能**自我验è¯**,å¦åˆ™ï¼š +- äººå·¥éªŒè¯æ•ˆçއæžä½Ž +- AI 无法å‘现自己的问题 +- å›¢é˜Ÿæ— æ³•çœŸæ­£ææ•ˆ + +### 6.2 测试策略(3 层) + +| 测试类型 | 工具 | é©±åŠ¨æ–¹å¼ | +|----------|------|----------| +| å•元测试 | JUnit / pytest | TDD:先写测试让 AI 失败,å†å†™å®žçް | +| API 测试 | REST Assured / Newman | 自动化回归,å¯ç›´æŽ¥å¡ 90%+ 覆盖率 | +| E2E 测试 | Playwright(推è,替代了 Selenium) | ä¸Šçº¿å‰ 80% çš„ case 回归覆盖 | + +### 6.3 TDD 循环(SuperPower 的工作方å¼ï¼‰ + +1. 让 AI 先写 API 测试/å•元测试 +2. AI è¿è¡Œæµ‹è¯• → 失败 +3. AI å†å†™å®žçŽ°ä»£ç  +4. AI 自动è¿è¡Œæµ‹è¯•éªŒè¯ â†’ 通过 + +> **效果**:å•元测试å¯è¾¾ 100% 覆盖率,API 测试å¯è¾¾ 90%+ 覆盖率。 + +### 6.4 AI 写测试解决å‡é˜³æ€§é—®é¢˜ + +有时候 AI 为了让测试通过,会伪造测试逻辑。解决方案: +- **TDD 先写测试**:先让测试失败,å†è®© AI 写实现 +- **交å‰éªŒè¯**:用ä¸åŒçš„ AI 模型互相 review 代ç å’Œæµ‹è¯• + +### 6.5 æµ‹è¯•ç”¨ä¾‹çš„ç®¡ç† + +测试用例直接放到代ç ä»“库中: +- å•元测试:跟éšä»£ç æ¨¡å— +- API 测试:放在 `/test/api` 目录 +- E2E 测试:用 TypeScript + Playwright,放在代ç ä»“库根目录(或与å‰ç«¯é¡¹ç›®åŒä»“库) + +## 七ã€Review 阶段:AI 辅助 Code Review + +### 7.1 å¤šç§ Review æ–¹å¼ + +1. **工具扫æ**:SonarQube ç­‰é™æ€åˆ†æžå·¥å…· + AI è‡ªåŠ¨ä¿®å¤ +2. **AI Review**:用å¦ä¸€ä¸ª AI 模型åšäº¤å‰ reviewï¼ˆæ¢æ¨¡åž‹åš review 是常用技巧) +3. **Agent 自动触å‘**:在 PR é˜¶æ®µè‡ªåŠ¨è§¦å‘ Review Agent + +### 7.2 AI Review 的问题与解决方案 + +**问题**:AI Review æ€»æ˜¯ä¼šææ”¹è¿›å»ºè®®ï¼Œå“ªæ€•没有明显问题(因为你的 prompt 让它æé—®é¢˜ï¼‰ã€‚ + +**解决方案**: +- è®¾ç½®é˜ˆå€¼ï¼šè¾¾åˆ°ä¸€å®šçº§åˆ«æ‰æé—®é¢˜ï¼Œå¦åˆ™ä¸è¾“出 +- 让 AI åªå…³æ³¨ bug 和逻辑错误,ä¸è¿‡åº¦å…³æ³¨é£Žæ ¼é—®é¢˜ +- 用团队的架构规约æ¥çº¦æŸ Review 标准 + +### 7.3 ä¸åŒåœºæ™¯çš„ Review ç­–ç•¥ + +- **全新项目(AI 100% 生æˆï¼‰**:å¯ä»¥ç”¨æœ€ä¸¥æ ¼çš„规则,AI 写完直接修 +- **æ··åˆé¡¹ç›®ï¼ˆäºº + AI)**:å¯èƒ½å­˜åœ¨åކå²é—留问题,Review 结果噪音多,建议从新模å—开始逿­¥è§„范 +- **跨系统场景**:AI å®¹æ˜“çŠ¯é”™ï¼ˆå°¤å…¶æ¶‰åŠ 3-5 个系统的交互),建议收敛到å•ä¸ªä»“åº“å¤„ç† + +> **ç»éªŒ**:跨系统时 AI 犯错误概率高达 70-80%,核心原因是缺少完整的系统间关系和业务规则上下文。 + +## å…«ã€å·¥å…·é“¾ï¼šAI 编程工具全景 + +### 8.1 三类 AI 编程工具 + +| 类型 | 代表工具 | 特点 | +|------|----------|------| +| 命令行 CLI | Claude Code, OpenAI Codex | 适åˆå¿«é€Ÿæ“作ã€è„šæœ¬åŒ– | +| IDE é›†æˆ | Cursor, Windsurf, VS Code AI | é€‚åˆæ—¥å¸¸å¼€å‘,界é¢å‹å¥½ | +| 辅助æ’ä»¶ | SuperPower(推è个人), Copilot | 按需使用 | + +### 8.2 常用 MCP(Model Context Protocol) + +| MCP | 用途 | +|-----|------| +| æ•°æ®åº“ MCP | æ“作数æ®åº“(注æ„:åªè¯»ï¼Œå†™æƒé™å»ºè®®å…³é—­ï¼‰ | +| Figma MCP | 读å–设计稿 | +| Jira MCP | 管ç†å·¥å• | +| Git MCP | ä»£ç æäº¤ã€PR æ“作 | + +### 8.3 Skills 体系 + +Skills = 一段æç¤ºè¯ + æ¨¡æ¿ + 脚本,用于æè¿°å·¥ä½œæ–¹æ³•。 + +- 把打样工程的åˆå§‹åŒ–åšæˆ Skill +- æŠŠå›¢é˜Ÿè§„èŒƒåšæˆ Skills +- Skills 放到代ç ä»“库中共享 + +**é‡è¦è§‚点**: +> "现在 AI ç†è§£åЛ已ç»å¾ˆå¼ºå¤§ï¼Œä¸éœ€è¦æŠŠè§„范è½å®žä¸ºéžå¸¸å›ºå®šçš„æ ¼å¼ï¼Œåªè¦è¡¨è¾¾æ¸…楚信æ¯ã€å¼ºè°ƒé‡ç‚¹å³å¯ã€‚" + +**ä¸»æµ Skill 框架**: +- SuperPowerï¼šå†…ç½®å¤§é‡ Skills,开箱å³ç”¨ï¼Œé€‚åˆä¸ªäºº +- Claude Agent(hermes):自动基于对è¯ç”Ÿæˆå’Œä¼˜åŒ– Skills +- MCP:工具调用åè®® + +### 8.4 ä¸ºä»€ä¹ˆä¸æŽ¨è SDD 框架 + +SDD(Scenario-Driven Development)框架本身很好,但**è½åœ°éš¾åº¦åœ¨äºŽå›¢é˜Ÿå…±è¯†**: + +- 需è¦å›¢é˜Ÿæ‰€æœ‰äººæŒ‰ç…§ç›¸åŒæµç¨‹å·¥ä½œ +- çŽ°å®žå›¢é˜Ÿä¸­é˜»åŠ›å¾ˆå¤§ï¼ˆä¸æ˜¯ä¸æ„¿æ„用,是习惯改ä¸äº†ï¼‰ +- SuperPower 对个人很好用,但团队级很难推广 + +> **结论**:与其强推 SDD 框架,ä¸å¦‚团队自己定义一套 Roos + Skills + MCP 的组åˆã€‚ + +## ä¹ã€æž¶æž„åž‹æ€è€ƒï¼šæœªæ¥è¶‹åŠ¿ + +### 9.1 Agent Code 的趋势 + +未æ¥å¿…然会出现 "Agent Code" 的概念——把整个团队的所有产物(需求ã€è§„æ ¼ã€è§„èŒƒã€æµ‹è¯•)全部代ç åŒ–,放到代ç ä»“库中统一管ç†ï¼š + +```markdown +/.agent + /skills # 工作方法 + /mcp # 工具é…ç½® + /templates # æ¨¡æ¿ + /rules # 规范 + /docs # 文档 +``` + +所有 AI 工具(SuperPowerã€Claude Code 等)安装时都从代ç åº“读å–é…置,实现æžè‡´é«˜æ•ˆã€‚ + +### 9.2 多 Agent å调的挑战 + +当å‰å¤š Agent 框架(如 CrewAIã€AutoGen)还处于早期阶段: +- 缺少程åºçº§åˆ«çš„精确校验(ä¸èƒ½å®Œå…¨ä¾èµ– AI 判断) +- Agent 与代ç ä¹‹é—´çš„交互需è¦ç¨‹åºé©±åŠ¨è€Œéžçº¯ AI 驱动 +- å¯èƒ½éœ€è¦è‡ªå·±å†™ workflow 调度器 + +### 9.3 共识是第一è¦åŠ¡ + +> "工具是玩人的,为了获得团队的共识。" + +大公å¸ä¹‹æ‰€ä»¥æ¯”å°å…¬å¸/åˆ›ä¸šå…¬å¸æ›´éš¾æŽ¨è¿› AI 编程å˜é©ï¼Œæ˜¯å› ä¸ºï¼š +- ä¹ æƒ¯éš¾ä»¥æ”¹å˜ +- 团队文化难以调整 +- 需è¦ä»Žä¸Šåˆ°ä¸‹çš„强力推动 + +## åã€å›¢é˜Ÿå®žè·µå»ºè®® + +### 10.1 æ¸è¿›å¼è½åœ°è·¯çº¿ + +1. **å•人验è¯é˜¶æ®µ**:选择一个简å•项目,用 SuperPower + TDD éªŒè¯ AI 编程效率 +2. **规范建立阶段**:定义技术规格模æ¿ã€ä»£ç è§„èŒƒã€æ‰“样工程 +3. **团队推广阶段**:用 Skills æ ‡å‡†åŒ–å·¥ä½œæ–¹æ³•ï¼Œé€æ­¥è®©å›¢é˜ŸæŽ¥å— +4. **自动化阶段**:打通从需求到部署的全æµç¨‹ï¼Œå®žçް"代ç å³ä¸€åˆ‡" + +### 10.2 技术ç»ç†çš„æ ¸å¿ƒèŒè´£ + +- 定义 AI å‹å¥½çš„éœ€æ±‚è§„æ ¼æ¨¡æ¿ â†’ 推动 BA/äº§å“æŽ¥å— +- 建立打样工程和代ç è§„范 → 控制代ç è´¨é‡ä¸‹é™ +- 推动测试文化 → 这是专业和éžä¸“业软件公å¸çš„分界线 +- 构建团队共识 → 这是最难也是最é‡è¦çš„事 + +### 10.3 é¿å‘æŒ‡å— + +1. **ä¸è¦è®© AI 直接写数æ®åº“**:用 Flyway è„šæœ¬ç‰ˆæœ¬åŒ–ç®¡ç† +2. **ä¸è¦æ‹†åˆ†è¿‡äºŽç»†å°çš„需求**:一个模å—一个文档 +3. **å˜æ›´éœ€æ±‚ä¸€å®šè¦æ ‡æ³¨å˜æ›´ç±»åž‹**:ä¸è¦ç»™å®Œæ•´çŠ¶æ€ +4. **ä¸è¦è®© AI åŒæ—¶åšè®¾è®¡å’Œä»£ç **:分阶段,用ä¸åŒè§’色 +5. **ä¸è¦å®Œå…¨ä¾èµ– AI Review**:用规则约æŸã€AI + äººå·¥ç»“åˆ + +## å一ã€è§‚ä¼—å馈与补充 + +- **åŽä¸º CodeArts Agent**ï¼šå¸¦æœ‰è§„èŒƒé©±åŠ¨å¼€å‘æ¨¡å¼ï¼Œå¯ä»¥å‚考 +- **Obsidian + Opal**:适åˆåš Markdown 知识库管ç†ï¼Œæ‰‹æœºå’Œç”µè„‘åŒæ­¥ï¼Œé€‚åˆåœ¨å¤–也能用手机+终端工作 +- **看æ¿å¼ AI ååŒ**:所有需求ã€è®¾è®¡ã€ä»»åŠ¡å…¨éƒ¨çœ‹æ¿åŒ–,共享给团队æˆå‘˜ +- **è·¨ Agent 通信**:契约文件(如 OpenAPI JSON)放到共享目录,å‰åŽç«¯å„è‡ªè¯»å– â†’ é¿å…å‰ç«¯æ”¹å®ŒåŽç«¯ä¸çŸ¥é“的问题 +- **sonarlint 本地扫æ + AI 自动修å¤**:在 pre-commit 阶段触å‘陿€æ‰«æï¼ŒAI 自动修å¤ä»£ç é£Žæ ¼é—®é¢˜ï¼Œæ•ˆæžœå¾ˆå¥½ \ No newline at end of file diff --git a/3Resources/AI/2026-05-30 SDD 规格驱动è½åœ°_文档管ç†ç­–ç•¥_BV1mZV76eEPC_笔记.md b/3Resources/AI/2026-05-30 SDD 规格驱动è½åœ°_文档管ç†ç­–ç•¥_BV1mZV76eEPC_笔记.md new file mode 100644 index 0000000..f8ea206 --- /dev/null +++ b/3Resources/AI/2026-05-30 SDD 规格驱动è½åœ°_文档管ç†ç­–ç•¥_BV1mZV76eEPC_笔记.md @@ -0,0 +1,177 @@ +# SDD 规格驱动è½åœ°ï¼šæ–‡æ¡£ç®¡ç†ç­–ç•¥ + +## 研讨会背景与目的 + +本次分享是 AI 编程相关è¯é¢˜çš„延续,主è¦èšç„¦ **SDD(Spec-Driven Development,规格驱动开å‘)** 的文档管ç†ç­–略。 + +### 研讨会机制 + +- **目的**:让å‚会者能够å‚与达æˆç¤¾åŒºå…±è¯†ï¼Œåˆ†äº«å„å…¬å¸åœ¨ AI 编程实践中的ç»éªŒ +- **å½¢å¼**:咨询师分享观察到的公å¸å®žçŽ°æ–¹æ¡ˆã€æž¶æž„设计ã€ç³»ç»Ÿè®¾è®¡ç­‰å†…容 +- **价值**:对个人和团队帮助都éžå¸¸å¤§ï¼Œé€šè¿‡é›†ä½“讨论形æˆå…±è¯† + +> 特别感谢å¡å°¼å…‹è€å“¥åœ¨ç ”讨会期间贡献了大é‡åˆ†äº«æ€æƒ³ï¼Œå—益颇多。 + +--- + +## AI 编程å‘展历程回顾 + +### 时间线概览 + +| æ—¶é—´ | 分享内容 | 核心概念 | +|------|----------|----------| +| 2025å¹´6月 | 早期 AI 编程实践 | DPER5 方法论 | +| åŽç»­ | MCP ç­‰å·¥å…·æ•´åˆ | MCPã€Scales | +| 5月9æ—¥ | Plan å’Œ Build æ¨¡å¼ | æ–°å› å­ï¼ˆå¸å¼•å­ï¼‰æ¦‚念 | +| 本次 | SDD 文档管ç†ç­–ç•¥ | 规格驱动è½åœ° | + +--- + +## DPER5 方法论 + +### æ ¸å¿ƒæ€æƒ³ + +DPER5 将软件工程中使用 AI 进行开å‘的过程分为 **5 个弱阶段(Weak Stages)**: + +``` +Discover → Plan → Execute → Review → Refine + ↓ ↓ ↓ ↓ ↓ + å‘现 规划 执行 评审 优化 +``` + +### 阶段特性 + +- ä¸åŒé˜¶æ®µ AI 会按照ä¸åŒçš„æ¨¡å¼è¿è¡Œ +- 例如在 **Design** æ¨¡å¼æˆ– **Discover** 模å¼ä¸‹ï¼ŒAI **ä¸ä¼šä¿®æ”¹ä»£ç ** +- è¿™ç§åˆ†é˜¶æ®µçº¦æŸæ˜¯é©¯æœ AI çš„ç®€å•æœ‰æ•ˆæ–¹æ³• + +### 实践应用 + +- 在早期阶段(2025年),演讲者已ç»åœ¨å…¬å¸å†…部领先应用 +- 采用 `Design → Plan → Execute` çš„æµç¨‹é©±åŠ¨å¼€å‘ +- 该方法使用了较长时间,有效规范了 AI è¾…åŠ©å¼€å‘æµç¨‹ + +--- + +## MCP(Model Context Protocolï¼‰å·¥å…·ç”Ÿæ€ + +### å·¥å…·æ•´åˆ + +åŽç»­éšç€ MCP 以åŠç›¸å…³å·¥å…·å¥—件的出现,形æˆäº†å®Œæ•´çš„ AI 编程工具生æ€ï¼š + +- **MCP(Model Context Protocol)**:模型上下文åè®® +- **Scales**:扩展工具 +- **SDD**ï¼šè§„æ ¼é©±åŠ¨å¼€å‘æ–¹æ³•论 + +这些工具被整åˆåˆ°ä¸€ä»½ PPT 手册中,作为团队 AI ç¼–ç¨‹çš„æŒ‡å—æˆ–手册å‚考。 + +--- + +## SDD(规格驱动开å‘) + +### SDD çš„æ ¸å¿ƒæ¨¡å¼ + +SDD æä¾›äº†å¤šç§å·¥ä½œæ¨¡å¼ï¼Œé€‚用于ä¸åŒçš„å¼€å‘场景: + +| æ¨¡å¼ | 适用场景 | AI è¡Œä¸ºç‰¹å¾ | +|------|----------|-------------| +| **Design** | 需求分æžã€æž¶æž„设计 | ä¸ä¿®æ”¹ä»£ç ï¼Œä»…æä¾›è®¾è®¡å»ºè®® | +| **Discover** | 探索å‘çŽ°ã€æ–¹æ¡ˆè°ƒç ” | ä¸ä¿®æ”¹ä»£ç ï¼Œä¸“æ³¨äºŽä¿¡æ¯æ”¶é›† | +| **Plan** | 规划分解ã€ä»»åŠ¡æ‹†è§£ | 生æˆå®žçŽ°è®¡åˆ’ | +| **Build** | 代ç å®žçްã€å…·ä½“å¼€å‘ | 执行代ç ç¼–写和修改 | + +### æ–°å› å­ï¼ˆå¸å¼•å­ï¼‰æ¦‚念 + +ç”± countic 大佬在 5月9日的分享中引入: + +**物ç†å­¦çš„æ¦‚念解释**: + +- 在混沌系统中,存在两ç§éœ‡è¡å馈的系统 +- è¿™ç§ç³»ç»Ÿæœ€ç»ˆä¼šæ”¶æ•›åˆ°ä¸€ä¸ªç¨³å®šçŠ¶æ€ +- 这个收敛点被称为 **å¸å¼•å­ï¼ˆAttractor)** + +**在 AI 编程中的应用**: + +- 通过引入新因å­ï¼Œå¯ä»¥å¼•导 AI 的输出趋å‘äºŽé¢„æœŸçš„ç¨³å®šçŠ¶æ€ +- 帮助控制 AI åœ¨å¤æ‚ä»»åŠ¡ä¸­çš„å‘æ•£æ€§ +- å®žçŽ°æ›´å¯æŽ§çš„ AI é©±åŠ¨å¼€å‘æµç¨‹ + +--- + +## SDD 文档管ç†ç­–ç•¥ + +> 本次分享的核心主题,èšç„¦äºŽè§„格驱动开å‘çš„æ–‡æ¡£ç®¡ç†æ–¹æ³• + +### 文档在 SDD 中的作用 + +1. **规格定义**:明确需求和设计规范,作为开å‘的基准 +2. **上下文传递**:在ä¸åŒé˜¶æ®µä¹‹é—´ä¼ é€’ä¸Šä¸‹æ–‡ä¿¡æ¯ +3. **版本控制**ï¼šè®°å½•è§„æ ¼çš„å˜æ›´åŽ†å² +4. **团队å作**:统一团队对需求的ç†è§£å’Œå®žçŽ°æ–¹å¼ + +### æ–‡æ¡£ç®¡ç†æœ€ä½³å®žè·µ + +(基于 SDD 方法论,文档管ç†åº”éµå¾ªä»¥ä¸‹åŽŸåˆ™ï¼‰ + +- **规格优先**:在开å‘å‰å…ˆå®Œæˆè§„格文档的编写 +- **增é‡è¿­ä»£**:规格文档éšé¡¹ç›®è¿›å±•逿­¥å®Œå–„ +- **åŒå‘追溯**ï¼šè§„æ ¼ä¸Žå®žçŽ°ä¹‹é—´ä¿æŒå¯è¿½æº¯æ€§ +- **工具集æˆ**:将文档管ç†ä¸Ž AI ç¼–ç¨‹å·¥å…·é“¾æ•´åˆ + +--- + +## å·¥å…·é“¾æ•´åˆæ–¹æ¡ˆ + +### 推èçš„ AI 编程工具栈 + +``` +┌─────────────────────────────────────────────────────┠+│ 规格层 (Spec) │ +│ ┌─────────────┠┌─────────────┠┌─────────────┠│ +│ │ Design │ │ Discover │ │ Plan │ │ +│ └─────────────┘ └─────────────┘ └─────────────┘ │ +├─────────────────────────────────────────────────────┤ +│ 工具层 (Tools) │ +│ ┌─────────────┠┌─────────────┠┌─────────────┠│ +│ │ MCP │ │ Scales │ │ SDD │ │ +│ └─────────────┘ └─────────────┘ └─────────────┘ │ +├─────────────────────────────────────────────────────┤ +│ 执行层 (Execution) │ +│ ┌─────────────┠┌─────────────┠│ +│ │ Build │ │ Review │ │ +│ └─────────────┘ └─────────────┘ │ +└─────────────────────────────────────────────────────┘ +``` + +### MCP 的核心功能 + +- æä¾›æ ‡å‡†åŒ–的上下文åè®® +- 实现 AI 与外部工具的无ç¼é›†æˆ +- 支æŒå¤šå·¥å…·ååŒå·¥ä½œ + +--- + +## 社区贡献者致谢 + +| 贡献者 | 贡献内容 | +|--------|----------| +| å¡å°¼å…‹ | 大é‡åˆ†äº«æ€æƒ³ï¼Œç ”讨会核心å‚与者 | +| countic | 引入新因å­ï¼ˆå¸å¼•å­ï¼‰æ¦‚念,分享 Plan/Build æ¨¡å¼ | +| å°‘ä¸ªåˆ†å· | SDD 方法论整ç†ï¼Œå·¥å…·é“¾æ•´åˆï¼Œæ–‡æ¡£ç®¡ç†ç­–略分享 | + +--- + +## åŽç»­è¯é¢˜é¢„告 + +本次分享的议程安排: + +1. **SDD 文档管ç†ç­–ç•¥**(当å‰å†…容) +2. **AIGC 模æ¿ç›¸å…³è¯é¢˜**(由å¡å°¼å…‹è€å“¥åˆ†äº«ï¼‰ + +--- + +## å‚è€ƒèµ„æº + +- 本次分享的 PPT 资料(å¯ä½œä¸ºå›¢é˜Ÿ AI 编程手册/指å—) +- æœç´¢å…³é”®è¯ï¼š`AI编程`ã€`MCP`ã€`SDD`ã€`DPER5`ã€`规格驱动开å‘` +- 相关标签:`人工智能`ã€`规格驱动开å‘`ã€`AI编程` \ No newline at end of file diff --git a/InBox/glue-coding-tmall-ai-practice-2026-03-27.md b/3Resources/AI/97.9%é‡‡çº³çŽ‡ï¼Œèƒ¶æ°´ç¼–ç¨‹ï¼šä¸šåŠ¡éœ€æ±‚å‡ºç æœ€ä½³å®žè·µã€å¤©çŒ«AI Coding实践系列】.md similarity index 100% rename from InBox/glue-coding-tmall-ai-practice-2026-03-27.md rename to 3Resources/AI/97.9%é‡‡çº³çŽ‡ï¼Œèƒ¶æ°´ç¼–ç¨‹ï¼šä¸šåŠ¡éœ€æ±‚å‡ºç æœ€ä½³å®žè·µã€å¤©çŒ«AI Coding实践系列】.md diff --git a/97.9%é‡‡çº³çŽ‡ï¼Œèƒ¶æ°´ç¼–ç¨‹ï¼šä¸šåŠ¡éœ€æ±‚å‡ºç æœ€ä½³å®žè·µã€å¤©çŒ«AI Coding实践系列】.md b/97.9%é‡‡çº³çŽ‡ï¼Œèƒ¶æ°´ç¼–ç¨‹ï¼šä¸šåŠ¡éœ€æ±‚å‡ºç æœ€ä½³å®žè·µã€å¤©çŒ«AI Coding实践系列】.md deleted file mode 100644 index e69de29..0000000 diff --git a/InBox/v2ex_1196441_大模型å˜ç¬¨è®¨è®º.md b/InBox/v2ex_1196441_大模型å˜ç¬¨è®¨è®º.md deleted file mode 100644 index 5003b86..0000000 --- a/InBox/v2ex_1196441_大模型å˜ç¬¨è®¨è®º.md +++ /dev/null @@ -1,36 +0,0 @@ -# 大家有没有感觉最近大模型å˜ç¬¨äº† - -**æ¥æº**: https://www.v2ex.com/t/1196441#reply25 -**ä¿å­˜æ—¶é—´**: 2026-03-24 -**标签**: #AI #大模型 #讨论 - ---- - -## 取孿‘˜è¦ - -楼主æé—®ï¼šå¤§å®¶æœ‰æ²¡æœ‰æ„Ÿè§‰æœ€è¿‘大模型å˜ç¬¨äº†ï¼Ÿ - -主è¦è®¨è®ºç‚¹ï¼š -- 用户感觉 GPT-4ã€Claude 等大模型最近回å¤è´¨é‡ä¸‹é™ -- 有人认为是心ç†ä½œç”¨æˆ–期望值æé«˜ -- 也有人æåˆ°å¯èƒ½æ˜¯æ¨¡åž‹æ›´æ–°å¯¼è‡´çš„风格å˜åŒ– -- 讨论涉åŠå¤šä¸ªä¸»æµå¤§æ¨¡åž‹ï¼šGPT-4ã€Claudeã€Gemini ç­‰ - ---- - -## 关键回å¤è§‚点 - -1. **心ç†ä½œç”¨è®º**: 用多了之åŽå¯¹æ¨¡åž‹èƒ½åŠ›è¾¹ç•Œæ›´æ¸…æ¥šï¼Œæ‰€ä»¥æ„Ÿè§‰"å˜ç¬¨" -2. **模型更新论**: OpenAI 等厂商确实会调整模型,å¯èƒ½å½±å“æŸäº›ä»»åŠ¡çš„è¡¨çŽ° -3. **ä»»åŠ¡å¤æ‚度**: éšç€ä½¿ç”¨æ·±å…¥ï¼Œæå‡ºçš„问题更难,模型显得力ä¸ä»Žå¿ƒ -4. **对比效应**: 新模型出æ¥åŽï¼Œæ—§æ¨¡åž‹ç›¸å¯¹æ˜¾å¾—弱了 - ---- - -## 个人æ€è€ƒ - -(待补充) - ---- - -**原始链接**: https://www.v2ex.com/t/1196441#reply25 diff --git a/InBox/zhihu_article_2028819446546932894.md b/InBox/zhihu_article_2028819446546932894.md deleted file mode 100644 index ec37b86..0000000 --- a/InBox/zhihu_article_2028819446546932894.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: 知乎文章 - 2028819446546932894 -source: https://zhuanlan.zhihu.com/p/2028819446546932894 -created: 2026-05-09 15:02 -tags: [zhihu, article, saved] ---- - -# 知乎文章 - -**URL:** https://zhuanlan.zhihu.com/p/2028819446546932894 - -**说明:** æ­¤ URL ç”± Hermes ä¿å­˜ï¼Œæ–‡ç« å†…容因知乎å爬虫机制(zse_ck)暂无法自动抓å–。 - -> 请手动访问该链接查看完整文章内容,然åŽå°†æ­£æ–‡ç²˜è´´åˆ°æ­¤å¤„。 - ---- -