AI Coding 六维魔方

WAF 六个架构维度。每个面由多个能力模块组成,每个方块代表一个可独立使用的能力颗粒。

0/27
拖拽旋转 · 每隔 1-2 秒新增一个方块
当前维度高亮

意图传递

需求、边界和验收标准能否被准确、完整地传递给 AI,形成可复现的人机意图对齐。

需求采集与结构化

从多源干系人收拢需求,建立统一的 Spec 编号和索引体系。

02-需求采集

立项与范围界定

定义项目的价值、范围和成功标准。防止 Scope Creep 和需求漂移。

03-立项提案04-PRD

用户故事与验收条件

按角色拆分需求,为每个故事写可验证的 AC。是 AI 开发的直接输入。

05-用户故事

功能规格与交互细节

定义每个功能的交互流程、边界条件、状态机和异常处理。

06-FSD

非功能需求约束

定义性能、安全、可用性的底线。这是 AI 生成代码的"护栏"。

07-NFR

工具连通

AI 能否安全地连通真实系统——代码库、数据库、内部 API——且权限边界清晰、访问受控。

MCP 接入与治理

通过标准化协议让 AI 安全访问企业内部系统。核心原则:最小权限、只读默认、操作审批。

MCP Server

环境隔离与边界控制

确保 AI 不会越界访问生产环境。开发/测试/生产三层隔离是基本要求。

环境沙箱RBAC

外部系统集成

将内部 API、数据库 Schema、知识库通过结构化的工具描述暴露给 AI。

API 目录

流程嵌入

AI 能力是否嵌入需求评审、开发、测试、代码审查等 SDLC 关键节点,形成自动化的质量门禁。

PR 共驾评审

AI 和人在同一 PR 上协同 Review。AI 第一轮扫描,人第二轮决策。

PR 模板

测试金字塔嵌入

单元→集成→E2E,每层自动生成测试用例并嵌入 CI 流程。

13-测试策略

质量门禁自动化

Lint → 类型检查 → 安全扫描 → 测试覆盖率,全部在 CI 中自动化执行。

CI Config

变更可见性

每次变更关联 Spec 编号和影响分析——"改了什么、为什么、影响了谁"。

14-RTM

知识沉淀

规范与历史决策能否跨会话复用。AI 编码场景下,知识的持续性直接决定长期效果。

多层 Memory 架构

短期记忆→中期记忆→长期记忆,逐层沉淀项目的规范和决策。

AGENTS.mdRules

ADR 决策记录

不仅记录"选了 A",更记录"为什么没选 B"。防止 AI 重复推荐已排除的方案。

ADR 模板

Skill 资产化

把优秀的 Prompt、工作流打包为可复用 Skill,让团队共享而非绑定个人。

Skills 库

知识保鲜与淘汰

知识源需要版本管理和过期清理——过时的上下文比没有更危险。

Context Rot 诊断

治理闭环

质量、安全、审计与度量能否形成可执行的管理闭环。最容易系统性翻车的维度。

AI 安全门禁

从输入注入防护到输出内容审查,建立 AI 编码场景下的安全基线。

11-安全设计

可追溯性体系

需求→设计→代码→测试的完整追溯链路。审计时直接查 RTM。

14-RTM

效能度量与 ROI

量化交付速度、质量和成本的变化,让管理层决策有数据可依。

ROI 计算器

Harness 基线与回归

多 Agent 场景下建立行为基线,升级后自动跑回归验证。

Harness 基线

复盘闭环

每起事件必须产出一项永久性的治理改进措施,不是"存档就结束"。

事故复盘模板

组织演进

AI Coding 能力能否从个人复制到团队与组织,形成可推广的资产和清晰的责任归属。

试点规模化

从 1 个试点团队扩展到全组织——需要标准化培训、认证和可复制资产。

成熟度自评

AI Coding 推广飞轮

资产积累→更多人使用→更多反馈→更好资产,组织资产是正循环引擎。

Skill Hub

角色与责任归属

"AI 生成的 Bug 算谁的?"——组织层面必须有明确答案。

责任矩阵

讲师认证与能力爬坡

培养内部 AI Coding 讲师,让方法论不依赖外部顾问就能在组织内传播。

三级讲师模型

G-Ladder 能力阶梯

组织 AI Coding 能力的六个渐进级别。每级增加一层系统化约束,人机责任比随之迁移。G2→G3 是投入产出比最高的跃迁。

G1
裸提示
人 90% : AI 10%
无约束
个人探索
G2
规则驱动
人 70% : AI 30%
Rules · AGENTS.md
代码补全
G3
Spec 驱动 ★
人 50% : AI 50%
14 文档体系
Spec-First
G4
Harness
人 30% : AI 70%
多 Agent 编排
工作流引擎
G5
评估闭环
人 15% : AI 85%
自动质量门禁
持续度量
G6
完全自主
人 5% : AI 95%
自治理
全链路闭环

三范式演进

AI Coding 不是一种编码风格,而是研发范式的演进。每一代在人机责任分配和需求管理上存在本质差异。

Vibe CodingSpec-Driven ← 核心定位Agentic
核心动作对话式编码规格先行,Spec 为契约多 Agent 自主编排
人机责任人主导人定义 · AI 执行AI 主导 · 人监督
需求管理隐式(对话中)显式(14 文档化)自动追踪
变更追溯不可追溯RTM 自动追溯完整审计日志
合规审计几乎无法满足14 文档天然留痕自动生成审计报告
适用场景原型 · 一次性脚本生产功能 · 团队协作复杂系统 · 合规场景

诊断 → 治疗 → 复查 · WAF 闭环

六个维度不是静态的分类,而是贯穿三种活动的治理闭环。三者共享同一组六维坐标。

诊断 · 看
27 个坏味道

覆盖六个维度的反模式识别。用负向语言描述——缺了什么、断了什么。

"你的体系在这六个维度上得了什么病"
查看全部 27 个坏味道 →
治疗 · 打
31 个设计模式

每个坏味道对应首选模式 + 辅助模式。用正向语言描述——建立了什么、打通了什么。

"每个维度上的病怎么治"
查看全部 31 个设计模式 →
复查 · 测
5 级 × 6 维成熟度

治理后的效果度量。进入下一轮循环——持续诊断,永不结束。

"六个维度各自治到了什么程度"

Spec 14 文档体系

Spec Console → GitHub 模板 →

一套可追溯、可校验、可交付的工程规约。人和 AI 在同一个 Spec 上工作。三级分级机制:80% 的变更仅需轻量流程。

Meta
01
02
需求源
Proposal
03
04
立项与需求
Spec Core
05
06
07
用户故事 · 功能规格 · NFR
Design
08
09
10
11
架构·API·数据·安全
Exec
12
13
实施与测试
Trace
14
RTM 追溯
01
写作总则
整套 Spec 的"语法书"。术语表、格式规范、AI 辅助规范。
架构师维护
02
需求采集
原始需求来源、干系人清单、业务背景。输入起点。
PM 维护
03
立项提案
项目价值论证、范围界定、成功标准、风险评估。P0 优先级。
PM 维护
04
产品需求 PRD
用户画像、功能清单、用户旅程、业务规则。AI 生成的直接输入。
PM 维护
05
用户故事
含 AC 验收条件。P0 优先级。按角色拆分,可直接转为开发任务。
PM + Dev
06
功能规格 FSD
交互流程、边界条件、状态机、异常处理。开发者的核心输入。
PM + 前端
07
非功能需求 NFR
性能、可用性、安全、兼容性底线。AI 输出质量的护栏。
架构师维护
08
架构选型
技术栈对比、关键决策记录 ADR。后端和基础架构开发的依据。
架构师维护
09
API 契约
接口定义、请求/响应格式、错误码。前后端并行开发的依据。
架构师 + 后端
10
数据模型
ER 图、表结构、索引策略、数据流。数据库设计和迁移的依据。
后端 / DBA
11
安全设计
攻击面分析、权限模型、安全控制措施。合规审计的直接依据。
安全工程师
12
实施计划
里程碑、WBS、依赖关系、回滚方案。项目管理的依据。
技术负责人
13
测试策略
测试范围、策略、通过标准、自动化策略。P0 优先级。
QA 维护
14
追溯矩阵 RTM
需求→设计→代码→测试双向追溯。变更时自动识别影响链。
QA / PM

七层质量拦截体系

从代码生成到生产部署的七层分层拦截。核心原则:拦截越早,成本越低——L0 层拦截一个问题的成本约为 L6 层的 1/100。

L0
写时约束
Spec · Rules
引导正确方向
AI 辅助
L1
IDE 检查
语法 · 类型
格式校验
实时自动
L2
提交前钩子
Lint · 单元测试
提交前阻断
Git Hook
L3
推送钩子
分支保护
PR 检查项
Git Server
L4
CI 扫描
静态分析
依赖漏洞
CI Pipeline
L5
代码评审
AI Review +
人工 Review
人机协作
L6
部署前扫描
自动化测试
安全扫描
CD Gate
写代码时
保存时
commit 时
push 时
CI 时
PR 时
上线前

L0 成本最低 ← 每一层拦截比前一层成本高约 1-2 个数量级 → L6 成本最高

Hands-on Lab 实验库

打开 Lab Console →

覆盖六个 WAF 维度的动手实验。每个 Lab 含任务文档和验收标准,可直接用于企业内训。

P1
意图传递
Lab 1 · 填写 Proposal 文档
Lab 2 · Spec 转代码实操
Lab 3 · 618 促销 Spec 全流程
P2
工具连通
Lab 4 · 搭建 MCP Server
Lab 5 · AGENTS.md 配置实战
Lab 6 · Rules 分层护栏
P3
流程嵌入
Lab 7 · AI Code Review 工作流
Lab 8 · CI/CD 质量门禁集成
Lab 9 · PR 共驾评审
P4
知识沉淀
Lab 10 · Memory 架构配置
Lab 11 · ADR 自动生成
Lab 12 · Skill Hub 搭建
P5
治理闭环
Lab 13 · AI 安全门禁配置
Lab 14 · ROI 计算器实战
Lab 15 · 合规追溯演练
P6
组织演进
Lab 16 · 成熟度自评 Workshop
Lab 17 · 讲师认证演练
Lab 18 · 试点规模化推演

E-ACMM 成熟度模型

在线自评 →

五级成熟度 × 六大维度 × 30 题。短板原则:整体级别由最弱的支柱决定。

六级能力雷达 · 各级别典型轮廓

L1
个人探索
组织看不见,使用在发生
L2
企业试点
试点团队顺手,跨团队推不动
L3
全面使用
能力长进组织骨架 ★ 多数企业目标
L4
量化驱动
数据真的改变决策
L5
研发范式
从追赶者变成定义者
互联网头部
L2-L3
金融行业
L2 为主
制造业 / 政务
L1 为主
AI 原生公司
L3-L4

魔方上的工具颗粒

每个颗粒是魔方上的一个能力模块——可独立使用,点击查看详情。

Spec 14 文档模板
D1 意图传递
从需求采集到追溯矩阵。含三级分级机制,80% 的变更仅需轻量流程。提供空白模板和 618 场景填充示例。
AGENTS.md
D4 知识沉淀
AI Agent 的角色定义文件。含角色身份、能力清单、行为边界、工作流程和输出规范。投入 30 分钟显著提升 AI 输出质量。
MCP Server
D2 工具连通
基于 Anthropic Model Context Protocol,将内部 API、数据库、知识库以标准化协议暴露给 AI Agent。最小权限、只读默认。
成熟度 30 题自评
D6 组织演进
5 级 × 6 维度 × 30 题。15 分钟完成,自动生成诊断报告。回答"我的团队现在在哪一级,下一步该做什么"。
七层质量拦截
D3 流程嵌入
L0 写时约束→L6 部署前扫描。越早拦截成本越低——L0 的成本约为 L6 的 1/100。
28 坏味道清单
全部六维度
覆盖六个维度的反模式清单。每个含危险等级、典型症状、维度和对应设计模式。8 高危·19 中危·1 注意。
ROI 计算器
D5 治理闭环
基于 DORA + AI 采纳率的三层度量模型。量化交付速度、质量和成本的变化。
编码模式决策树
D1 意图传递
Vibe/Glue/TDD/Spec/Harness。三个问题确定用什么:生命周期>3月?协作人数?代码规模?
Landing Zone 准备清单
D6 组织演进
三层地基的逐项准备清单:约束层→上下文层→规格层。每层可独立验证、独立产生 ROI。
AI 安全门禁
D5 治理闭环
输入注入防护、输出内容审查、代码安全扫描。在 CI 流水线中自动化执行。
618 促销案例
D1 意图传递
电商大促场景下的完整 Spec 实践。需求变更响应从 2 天降至 10 分钟。
Spec Skills(Cursor)
D1 意图传递
11 个 Cursor Skills,四轮工作流,自动化 Spec 文档编写、维护和门禁验证。

Landing Zone — 用积木铺成的路

GitHub 准备清单 →

企业引入 AI Coding 前需按序铺设三层地基 + 扩展层。借鉴云计算 Landing Zone 的分层原则——每层独立交付价值,不依赖上层。

约束层
AGENTS.md · 门禁
上下文层
Rules · 记忆库
规格层
14 文档体系
扩展层
Skills · MCP · 知识平台
第 1 层 · 1-2 周
约束层
· AGENTS.md 角色定义
· 七层质量拦截配置
· Pre-commit Hook
· CI 基础门禁
· 安全基线初版
独立价值:立即降低 AI 输出错误率
第 2 层 · 2-4 周
上下文层
· 项目结构约定与 README
· 团队 Rules 编码规范
· 团队记忆库(AGENTS.md v2)
· Context Rot 诊断
· 知识源版本管理
独立价值:AI 输出从"可用"到"正确"
第 3 层 · 4-8 周
规格层
· 14 文档体系(Proposal→RTM)
· Spec 三级分级机制
· Spec Freeze 冻结流程
· 对齐会制度(L2 标准流程)
· PR-Spec 关联校验
独立价值:实现跨角色、跨团队协作
扩展层 · 持续演进
技能与生态
· Skills 资产库
· MCP Server 接入
· 企业知识平台
· 多 Agent 编排
· ROI 度量体系
独立价值:将组织知识注入 AI 上下文

每层可独立部署、独立验证、独立产生 ROI · 不需要等上层完成后才启动下层 · 完整准备清单见 GitHub

框架关系矩阵

七个框架在体系中的角色和协作关系。不是独立概念,而是互相咬合的整体。

框架在魔方的位置体系角色回答的核心问题
WAF 六维度魔方本身 — 六个面骨架企业 AI Coding 存在哪些治理维度?怎么诊断?
E-ACMM 成熟度旋转角度 — 审视的镜头标尺我的团队现在在哪一级?下一步该做什么?
Spec 14 文档D1 面上的核心方块核心交付物人和 AI 怎么在同一份规格上协作?
G-Ladder魔方从乱到整的还原路径方向下一步能力往哪升级?
Context EngineeringD2、D4 面的底层逻辑技术基础为什么企业 AI 输出质量不稳定?
Landing Zone积木路 — 从下到上铺设行动指南企业引入 AI Coding 第一步先做什么?
编码模式选择旋转策略 — 不同场景不同转法决策工具当前任务该用哪种编码模式?

从哪里开始

🔍
自评成熟度

5 级 × 6 维度 × 30 题。15 分钟完成,自动生成诊断报告。知道自己在哪一级,才知道下一步往哪走。

30 题自评 →
📋
下载 Spec 模板

14 份空白模板 + 618 促销场景填充示例。从 03 立项提案开始,填完一份就能用。

GitHub →
📖
阅读方法论文档

WAF 六维度 + G-Ladder + 上下文工程。理解背后的方法论逻辑,才能根据自己团队的情况做定制。

GitHub 仓库 →