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 个坏味道

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

"你的体系在这六个维度上得了什么病"
治疗 · 打
31 个设计模式

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

"每个维度上的病怎么治"
复查 · 测
5 级 × 6 维成熟度

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

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

Spec 14 文档体系

在 Spec Console 中查看 →

一套可追溯、可校验、可交付的工程规约。含三级分级机制——80% 的变更仅需轻量流程。

Meta
01 写作总则
02 需求采集
Proposal
03 立项提案
04 产品需求
Spec
05 用户故事
06 功能规格
07 非功能需求
Design
08 架构选型
09 API 契约
10 数据模型
11 安全设计
Execution
12 实施计划
13 测试策略
Trace
14 追溯矩阵
RTM · 双向追溯

魔方上的工具颗粒

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

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 — 用积木铺成的路

约束层
AGENTS.md · 门禁
上下文层
Rules · 记忆库
规格层
14 文档体系
扩展层
Skills · MCP · 知识平台

每层独立交付价值,不依赖上层即可开始使用。

框架关系矩阵

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

框架在魔方的位置体系角色回答的核心问题
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 仓库 →