---
title: 智能体软件工程知识图谱
tags:
  - AI-Agent
  - Agentic-SE
  - Harness-Engineering
  - Superpowers
  - 软件工程
  - 知识图谱
created: 2026-04-21
sources:
  - AgenticSE_Book_CN（艾哈迈德·E·哈桑，2026）
  - Harness-Engineering知识体系（11篇原始资料整理，2026-04-20）
  - Superpowers技能框架（obra，161.7k stars，2026-04-21）
---

# 智能体软件工程知识图谱

> 串联三大框架：**Agentic SE** + **Harness Engineering** + **Superpowers**
> 
> 核心公式：**AI Agent = Model + Harness**

---

## 一、核心共识

三大框架都认同：

1. **AI Agent = Model + Harness** — 模型提供智能，Harness 让智能可用
2. **AI 是队友，不是工具** — 能力强大但会犯错，可靠性必须靠工程系统保障
3. **强制合规 > 依赖理解** — 不指望 AI 自发遵守规范，要构建无法跳过的系统
4. **验证即完成** — 以可运行的证据（测试通过）代替主观断言

---

## 二、框架定位对照

| 维度 | Agentic SE | Harness Engineering | Superpowers |
|------|------------|-------------------|-------------|
| **定位** | 学科级方法论 | 概念框架 | 具体技能实现 |
| **层级** | 理论与哲学 | 设计原则 | 工程实践 |
| **关注点** | 人+AI团队协作 | 除模型以外的一切 | 编码智能体工作流 |
| **起源** | 学术（哈桑教授） | 多机构综合（LangChain/Anthropic/Thoughtworks等） | 工程实践（Jesse Vincent） |

---

## 三、核心概念映射

### 1. Agent = Model + Harness

| 组件 | Agentic SE 说法 | Harness Engineering 说法 | Superpowers 说法 |
|------|----------------|------------------------|-----------------|
| **Model** | AI队友 | 模型（ intelligence） | 底层编码智能体 |
| **Harness** | 工程系统保障可靠性 | 工具/指令/状态管理/验证/运行时基础设施 | 技能系统（Skills） |

### 2. 五大子系统（对应关系）

| # | Harness Engineering | Superpowers | Agentic SE |
|---|---------------------|--------------|------------|
| 1 | Instructions | brainstorming / writing-plans | 需求规范 + 设计文档 |
| 2 | State | 设计文档 + plan文件 + git log | 持久化状态管理 |
| 3 | Verification | test-driven-development / verification-before-completion | 验证与测试 |
| 4 | Scope | one feature at a time | 任务边界控制 |
| 5 | Session Lifecycle | init.sh / finishing-a-development-branch | 会话交接与收尾 |

### 3. 控制类型对照

| 类型 | Harness Engineering | Superpowers |
|------|---------------------|--------------|
| **计算型控制** | 测试/linter/类型检查 | test-driven-development |
| **推理型控制** | LLM as Judge / AI代码审查 | requesting-code-review |
| **前馈导引** | AGENTS.md / 技能文件 / 引导脚本 | brainstorming（苏格拉底式提问） |
| **反馈传感** | 静态分析 / 日志 / 测试 | 两阶段审查（规格合规 + 代码质量） |

### 4. 质量保障维度

| 维度 | Harness Engineering | Superpowers |
|------|---------------------|--------------|
| **可维护性** | 重复代码/圈复杂度/测试覆盖率 | test-driven-development |
| **架构适应性** | 性能/可观测性/依赖规则 | writing-plans（详细任务拆解） |
| **行为正确性** | 规格说明/测试套件/e2e验证 | RED-GREEN-REFACTOR + verification-before-completion |

---

## 四、CAR 框架（Control-Agency-Runtime）

来自学术界（Harness Engineering 引用），与各框架的对应：

| 维度 | 定义 | 在Superpowers中的体现 |
|------|------|---------------------|
| **Control** | 哪些指令保持权威 | 技能触发在工作前，任何响应前检查 |
| **Agency** | 哪些行动可用 | subagent-driven-development（子智能体执行） |
| **Runtime** | 状态如何延续、故障如何处理 | Session Lifecycle / finishing-a-development-branch |

---

## 五、心理说服原则

Superpowers 独家引入（基于沃顿商学院论文《Call Me a Jerk》），可补充到 Harness Engineering：

| 原则 | 在Superpowers中的应用 |
|------|----------------------|
| **权威（Authority）** | 技能定义为强制工作流，而非建议 |
| **承诺（Commitment）** | 使用技能前要求智能体公开声明 |
| **社会认同（Social Proof）** | 营造"不怕调用错技能"的文化 |

---

## 六、实测效果

Anthropic 对比实验（同一模型 + 同一提示词）：

| | 有Harness | 无Harness |
|--|-----------|-----------|
| 成本 | $9 | 更高 |
| 时间 | 20分钟 | 更长 |
| 结果 | 可运行 | 无法运行 |

**结论**：Harness 改进带来的性能提升，可能比模型本身更显著。

---

## 七、知识体系演进路径

```
学术界（CAR框架）
    ↓
Harness Engineering（概念框架，11家机构综合）
    ↓
┌─────────────────┴─────────────────┐
↓                                     ↓
Agentic SE（理论专著）       Superpowers（工程实践）
（哈桑教授，2026）          （Jesse Vincent，161.7k stars）
关注：人+AI协作             关注：编码智能体工作流
└─────────────────┬─────────────────┘
                  ↓
         OpenClaw/Harness实践
```

---

## 八、对OpenClaw的指导意义

OpenClaw 本身就是一个 Harness 实现：

| OpenClaw组件 | 对应Harness子系统 |
|-------------|-----------------|
| AGENTS.md / SOUL.md / USER.md | Instructions |
| MEMORY.md / memory/ | State |
| HEARTBEAT.md | Verification + Session Lifecycle |
| Skills系统 | 工具扩展（Tool Harness） |

**优化方向**：
1. 引入 Superpowers 的"技能触发在工作前"机制
2. 强化 verification-before-completion（当前HEARTBEAT偏简单检查）
3. 补充前馈导引：每次会话开始时主动说明上下文
4. 引入 TDD 思维：先定义验证方式，再执行任务

---

## 九、推荐阅读路径

```
入门 → 《Agentic SE》第四部分（行动指南）
      ↓
进阶 → Harness-Engineering知识体系
      ↓
实践 → Superpowers技能框架
      ↓
落地 → OpenClaw优化方向
```

---

## 关联文档

- [[Harness-Engineering知识体系]]
- [[Superpowers技能框架]]
- [[code-reviewer技能]]
- [[fireworks-tech-graph技术图生成工具]]