![文章封面](https://developer.qcloudimg.com/http-save/yehe-11715263/4c7add68ba1b654963cedb9efa3ec793.png)

**简介：用七层地图给工具定位，用 SDD、Harness、Loop Engine 管住想、做和循环，再把它们组织成自己的端到端工作流**

## 工具七层架构

**简介：工具多不可怕，没有地图才可怕，任何工具都能在七层里找到位置**

![AI 编程工具七层架构](https://developer.qcloudimg.com/http-save/yehe-11715263/491b4c7ce1b6dfc7b2e4e0855f3212ef.png)

* 下三层：每天接触，噪音最大
 * 模型层：AI 编程的原料，Claude 代码口碑最好
 - 「用 Claude」说的是模型，「用 Cursor」说的是工具，不是一个维度
 * 工具层：IDE 内嵌（Cursor）、终端 CLI（Claude Code）、SDK 三种形态，按场景配合而不是互相替代
 * 配置约束层：CLAUDE.md、Skills、Permission/Hooks，让 AI 在项目里守规矩
 - **会不会这一层，决定是「AI 编程的用户」还是「AI 编程的工程师」**

* 上四层：越往上越少人掌握，杠杆越大
 * 协作机制层：Subagents、Worktrees、Plan Mode，和一个 AI 团队工作
 * 协议与生态层：MCP（Model Context Protocol），AI 编程的「USB-C」，一次写好所有工具都能调用外部系统
 * 工作流层：Headless（无界面运行）、CI/CD、事件触发，人不在循环里工作流也能自己跑
 * 方法论层：SDD + Harness + Vibe，工具会过时，方法论持久

* 关键点
 * **七层不是顺序使用，而是在同一个任务里同时调用**，这种能力才是工程感

## 选工具：先定位，再判断

**简介：用得好 AI 不等于知道更多 AI 技巧，新工具来了先放进七层地图再决定要不要学**

* 两种学工具的思路

| 维度 | 知道更多工具（手段导向） | 想清楚目的 + 用对工具（结果导向） |
|---|---|---|
| 出发点 | 工具的酷炫程度 | 要解决的问题 |
| 高阶用法 | 奇技淫巧追不完 | 大多数场景根本不需要 |
| 结果 | 拿到注意力，回到工作用不出效果 | 基础工作流跑顺，拿到能力和资产 |

* 新工具三问

![选工具：先定位，再判断](https://developer.qcloudimg.com/http-save/yehe-11715263/bcf97328af316911c85f84ed14a15c9c.png)

 * 橙色为不值得投入，绿色为值得投入

* 注意点
 * 大多数「新工具」只是工具层的插件，或配置层的又一种约束
 * **当下用不到的工具是负价值，浪费时间、增加焦虑**
 * 用三问过滤掉 95% 的噪音，只对真正的结构性变化（如 MCP、SDD）保持警觉

## 推荐工具栈与使用场景

**简介：每层只选最成熟、学了能直接用的一个，在具体场景里自然用上**

* 工具栈

| 层 | 选型 | 用途 |
|---|---|---|
| 模型层 | Claude | 代码任务口碑最好，作为默认模型 |
| 工具层 | Claude Code（辅以 Cursor） | CLI 做复杂 Agent 工作流，IDE 做日常编码 |
| 配置约束层 | CLAUDE.md、Skills、Hooks | 固化项目规则与团队约定 |
| 协作机制层 | Subagents、Plan Mode | 并行隔离 + 动手前先规划 |
| 协议生态层 | MCP | 连接数据库、GitHub 等外部系统 |
| 方法论层 | SDD（Spec-Kit）+ Harness | 一个解决「想」，一个解决「做」 |

* 场景用法

| 场景 | 用法 | 原因 |
|---|---|---|
| 分布式延时组件，需求复杂 | SDD 对齐需求 | 先把 spec 写清楚，让需求和实现对齐 |
| 十万行陌生代码改造 | Subagents 并行 | 多个子代理并行读不同模块，主对话不被污染 |
| 从 0→1 自建 Agent OS | Skills 固化约定 | 团队约定和可复用能力沉淀成 Skills |
| 陌生语言（Rust）开源贡献 | AI 反推逻辑 | 快速读懂陌生语言项目的整体逻辑 |

## 方法论三大支柱

**简介：名词再多，撑起 AI 编程的就三根支柱，分别管「想清楚」「做得对」「循环可控」**

| 支柱 | 管什么 | 作用 |
|---|---|---|
| **SDD** | 想 | 把模糊需求变成可执行的 spec，让 AI 知道做什么、做到什么程度 |
| **Harness** | 做 | 给 AI 装挽具，在边界内工作，保证做对、不跑偏 |
| **Loop Engine** | 循环 | 管住 ReAct 执行循环的粒度、检查点与回滚，让自主执行可控 |

* 核心结论
 * **SDD 给目标，Harness 给边界，Loop 给可控的执行，三者合起来才是完整闭环**
 * Vibe Coding、Context Engineering、ReAct、TDD、Plan-then-Execute 等名词，回到这三根支柱就不乱

## SDD：把「想」变成 spec

**简介：SDD（Spec-Driven Development，规格驱动开发）先写规格再让 AI 实现，spec 是有结构、有验收、有边界的可执行规格，不是需求文档**

![Spec-Kit 四步流程](https://developer.qcloudimg.com/http-save/yehe-11715263/522986111abe80b6521a7a8c8bc1e162.png)

* Spec-Kit 四步
 * `/specify`：把想法扩展成结构化需求，产出 `spec.md`
 * `/plan`：定技术选型与架构约束，产出 `plan.md`
 * `/tasks`：拆成可执行的任务清单，产出 `tasks.md`
 * `/implement`：AI 按任务逐个实现，产出代码

* 自动化模式的分工与代价
 * 人只做三件事：写第一份 spec、检查 plan、review 代码
 * 拆任务和执行交给 AI
 * **拆任务的质量上限，就是 spec 的质量**

* 三种落地模式

| 模式 | 工具 | 分工 | 适合 |
|---|---|---|---|
| 自动化 | Spec-Kit | AI 拆任务 + 执行，人写 spec、review 代码 | 新手、中等复杂度、探索性开发 |
| 手动控制 | OpenSpec | 人拆任务，AI 只执行单个任务，用 delta spec 写增量 | 资深、系统级、老项目改造 |
| 轻量手工 | CLAUDE.md + Skill | 不用 SDD 工具，方案在脑子里跑通，AI 一段段执行 | 熟悉的技术栈、增量开发 |

* 注意点
 * 选哪种不看用了多少工具，看对项目的熟悉度和自己的能力阶段
 * **三种是互补不是替代，按场景切换**

## Harness：给 AI 装上挽具

**简介：AI 能力强但缺判断边界，Harness（挽具）用配置和约束把它从「放飞的执行者」变成「可控的协作者」**

* 不加约束的四种风险

| 风险 | 表现 |
|---|---|
| 跑偏 | 偏离任务焦点，做着做着走样 |
| 失控 | 改了不该改的代码和文件 |
| 上下文污染 | 读了太多无关信息后做出错误判断 |
| 不可逆操作 | 没经过确认就动手 |

* 六大工具 = 三道防线

![Harness 六大工具与三道防线](https://developer.qcloudimg.com/http-save/yehe-11715263/4b26d5bc91d91992f20e2866ffa395c4.png)

 * 打底与加速
 - CLAUDE.md：项目规则，一上来就让 AI 懂项目上下文与约定
 - Skills / Slash：能力杠杆，把可复用的能力和流程封装起来
 - Subagents：上下文隔离，子代理读大量代码，主对话不被污染
 * 三道防线
 - 前置防线 Plan Mode：重要操作先出 plan，确认后再动手
 - 中置防线 Permission：用 `allow` / `ask` / `deny` 精细划定自主边界
 - 后置防线 Hooks：做完自动跑 lint、测试，机器替人验证

* 原则
 * **项目规则打底，能力杠杆加速，前中后三道防线守住安全**

## Loop Engine：管住执行循环

**简介：Agent 时代 AI 会自己连续跑几十步，Loop Engine（循环引擎）在 ReAct 循环之上加控制杠杆，让长任务可控**

* 为什么需要

| 维度 | 单步执行（chatbot 时代） | 自主循环（agent 时代） |
|---|---|---|
| 交互 | 问一句答一句 | AI 自己推理、行动、观察 |
| 步数 | 一次调用就结束 | 一个任务可能跑几十步 |
| 依赖 | 没有「下一步」 | 每一步都基于上一步的结果 |
| 管理 | 不存在要管的循环 | 循环必须被管住，否则失控 |

 * **循环越长，越容易跑偏、陷入死循环、做出不可逆操作**

* ReAct 循环与三个杠杆

![ReAct 循环与 Loop Engine 三个杠杆](https://developer.qcloudimg.com/http-save/yehe-11715263/84f4884bdf0cbecb8e9656787d0ea3f1.png)

 * ReAct（Reason + Act）是事实标准的循环结构
 - Reason 推理下一步做什么，Act 调用工具或写代码，Observe 观察结果对不对
 - 不对就回到推理，循环直到收敛
 * 三个控制杠杆
 - 控制粒度：每一步让 AI 做多大，决定稳定性
 - 设检查点：关键步骤插入人工确认，防止跑飞
 - 可回滚：走错一步能退回，错误不累积

* 价值与现状
 * 能跑长任务、能停能查、能回退
 * 三根支柱里最年轻的一根，Plan Mode、检查点、各家 agent 的 loop 控制都是它的雏形

## 方法论与工具如何结合

**简介：以做一个新认证模块为例，方法论统领、工具落地，七层在一个任务里同时协作**

![方法论与工具如何结合](https://developer.qcloudimg.com/http-save/yehe-11715263/252cfd739cfd25000a38ba3d8039c148.png)

* 红色节点是起点：先想清楚再动手

* 每一步做什么
 * SDD 思路：规格先行
 * Spec-Kit：把需求落成 `spec.md` / `plan.md`
 * CLAUDE.md：告诉 AI 项目结构与代码风格
 * Plan Mode：动手前先出 plan，人确认
 * Claude Code：按任务写代码，模型在底层生成
 * Hooks：写完自动跑 lint + 测试收尾

* 结论
 * **方法论是思想，工具是落地**

## 工作流：从模糊需求到生产上线

**简介：工作流不是写代码，而是把一件事从模糊需求到上线全程跑通的一套系统**

* 工作流的六个要素

| 要素 | 说明 |
|---|---|
| 阶段产出 | 每个阶段交付什么，例如 spec、plan、代码、报告 |
| 人的职责 | 哪些判断、决策、拍板由人来做 |
| AI 的职责 | 哪些执行、生成、检查交给 AI |
| 反馈循环 | 怎么及时发现问题、自动纠错 |
| 异常处理 | 卡住了、跑偏了怎么救回来 |
| 经验沉淀 | 做完留下什么可复用的东西 |

* 大项目的端到端六阶段

| 阶段 | AI 做 | 人做 |
|---|---|---|
| 需求 | 扩展维度、识别遗漏 | 定边界与优先级 |
| 设计 | 画架构、比方案 | 关键架构拍板 |
| 开发 | 写代码、补测试 | 审关键代码 |
| 测试 | 造用例、跑回归 | 定验收标准 |
| 部署 | 写脚本、做灰度 | 控发布节奏 |
| 运维 | 看日志、定位异常 | 做最终处置 |

 * **没有一个环节是 AI 全自动，也没有一个环节是纯手工**

* 让工作流跑起来的三件事
 * 产出物给 AI 看：Spec、CLAUDE.md、Skills、Hooks，每个产出物都有人和 AI 两个读者
 * 人 + AI 分工：判断什么交给 AI、什么自己拍板、什么 AI 做但人复核
 * 反馈自动化：Hooks 在 AI 出错前后秒级介入，不靠人当最后防线

## 差距在工作流：Bun 案例

**简介：同一套工具，工作流设计得好坏，产出可以差十倍**

* Bun 6 天 96 万行：不是 AI 自主写完，而是 Sumner 设计了一套协作工作流跑到极致
 * 不是从零，是迁移：Zig 翻译到 Rust，有完整原代码作参考、有测试作验证
 * 工程铺垫极深：事先准备 300 条翻译规则 + 智能指针抽象
 * 人始终在循环：何时启停、合并哪个版本，决策层全是人
 * 测试闭环跑通：每翻译一段自动跑测试，跑不过回到 AI 改，可收敛

* 工作流设计差 vs 好

| 维度 | 设计差（2 天还在拉扯） | 设计好（2 小时做完） |
|---|---|---|
| 起步 | 需求没想透就让 AI 写 | 先理需求、写 spec、定边界 |
| 过程 | AI 猜错、改 prompt、再猜 | AI 一次到位，自己守住判断 |
| 复用 | 照搬别人的，场景一变就跑不通 | 用自己打磨过的流程稳定复现 |
| 精力 | 全耗在纠偏上 | 省下来想更深的事 |

* 注意点
 * **工作流带强烈的个人风格，照搬别人的跑不通，要的是自己的工作流**

## 练出自己的工作流

**简介：底层是可迁移的模式，上层是自己攒下的资产，只能在真实项目里反复跑出来**

![个人工作流的四步模式](https://developer.qcloudimg.com/http-save/yehe-11715263/9fdcf49e265fbbd5a895a5ce676abbf7.png)

* 底层模式
 * 理解：把需求、代码想透
 * 约束：用 spec、CLAUDE.md 划边界
 * 验证：用测试、review 收口
 * 沉淀：把经验变成可复用资产，例如提示词、Skills、CLAUDE.md 模板、检查清单

* 养成的四个条件
 * 认知：看清 AI 编程是什么，建立判断底座
 * 方法论：SDD + Harness，把「想」和「做」工程化
 * 工具：七层地图，知道每层用什么、怎么配
 * 不断练习：**前三点是地基，第四点是火候**

* 每个项目都做的三个动作
 * **跑完整工作流**：从理需求、写 spec 到测试、上线、监控，别从写代码起步
 * **关键决策问为什么**：记下选 A 不选 B 的真实工程理由，没复盘的坑等于白踩
 * **结束时问沉淀了什么**：标准只有一条，下次起点更高

* 积累的复利资产

| 资产 | 内容 | 价值 |
|---|---|---|
| 本地资产 | CLAUDE.md 模板、项目脚手架 | 下个项目直接用，起点更高 |
| 能力资产 | Skills 与提示词库 | 反复做的事封装起来，越用越顺手 |
| 经验资产 | 踩坑与决策笔记 | 半年后还能少走弯路 |
| 身份资产 | 开源贡献与 GitHub | 跨公司、跨时间的公开履历 |

## 面试/考试记忆点

* **会用 AI 是入场券，工作流才是护城河**
* AI 编程工具七层：模型、工具、配置与约束、协作机制、协议与生态、工作流、方法论
* 配置约束层（CLAUDE.md、Skills、Hooks）决定是 AI 编程的用户还是工程师
* 新工具三问：属于哪一层、解决什么问题、现在需不需要
* 三大支柱：SDD 管想（给目标），Harness 管做（给边界），Loop Engine 管循环（可控执行）
* Spec-Kit 四步：`/specify`、`/plan`、`/tasks`、`/implement`，拆任务的质量上限是 spec 的质量
* Harness 三道防线：Plan Mode 前置，Permission 中置，Hooks 后置
* Loop Engine 三个杠杆：控制粒度、设检查点、可回滚
* 个人工作流四步：理解、约束、验证、沉淀

文章封面 简介：用七层地图给工具定位，用 SDD、Harness、Loop Engine 管住想、做和循环，再把它们组织成自己的端到端工作流 工具七层架构 简介：工具多不可怕，没有地图才可怕，任何工具都能在七层里找到位置 AI 编程工具七层架构 下三层：每天接触，噪音最大 模型层：AI 编程的原料，Claude 代码口碑最好 「用 Claude」说的是模型，「用 Cursor」说的是工具，不是一个

AI 编程工具、方法论与工作流

人工智能

开发工具

职业发展

用七层地图给AI编程工具定位，SDD、Harness、Loop Engine三大支柱管住想、做与循环，构建端到端个人工作流。配置约束层决定你是用户还是工程师，新工具三问过滤噪音，四步模式积累复利资产，让工作流成为护城河。

Vibe Coding

数据库

GitHub

Agent

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

AI 编程工具、方法论与工作流-腾讯云开发者社区-腾讯云

AI 编程工具、方法论与工作流

AI 编程工具、方法论与工作流

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐